Skip to main content

​
WhatsApp

WhatsApp in Fased uses linked WhatsApp Web sessions. The gateway owns the socket state, routes DMs and groups separately, and lets you choose a personal-number or dedicated-number operating model. Status: supported through WhatsApp Web using Baileys.

Pairing

Unknown DMs can require approval.

Groups

Group allowlists and mention behavior.

Troubleshooting

Shared channel repair steps.

​
Quick setup

  1. Open Agents > selected Agent > Channels > WhatsApp.
  2. Choose personal-number or dedicated-number setup.
  3. Keep DM policy on pairing or allowlist to start.
  4. Scan the QR code from WhatsApp.
  5. Start or restart the gateway.
  6. Approve the first pairing request if using pairing mode.
CLI login: 
fased channels login --channel whatsapp
fased pairing list whatsapp
fased pairing approve whatsapp <CODE>
Config shape: 
{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​
Operating model

ModeUse when
Dedicated numberYou want a clear bot identity and cleaner allowlists.
Personal numberYou need to use an existing WhatsApp account and accept tighter self-chat/allowlist care.
When possible, use a dedicated number for Fased.

​
Runtime behavior

  • Linked session state is stored locally by the gateway.
  • DMs and groups route separately.
  • Group replies should start mention-gated or allowlisted.
  • Task commands create Agent-owned Tasks; WhatsApp is the transport.
  • Media and long output are subject to channel limits and chunking behavior.

​
Access model

AreaRecommended start
DMspairing or allowlist
Groupsallowlist plus mention gating
Personal-number modeexplicit self-chat and sender policy
Multi-accountnamed account per linked WhatsApp session

​
Troubleshooting

SymptomCheck
QR login failsExisting session state, phone connectivity, gateway logs.
Bot ignores DMsPairing state, allowlist, phone number format.
Group replies missingGroup policy, mention requirement, group sender allowlist.
Session disconnectsRe-link QR and check host sleep/network state.
Messages duplicatePersonal-number self-chat policy and route/session settings.