Skip to Content
📚 Documentation is in active development — pages marked TODO will fill out over the next few weeks.
Getting startedConnect your first channel

Connect your first channel

Six channel types are supported. WhatsApp is by far the most common — start there unless you specifically need one of the others.

WhatsApp Business

Two onboarding paths:

The Meta-hosted flow that handles WABA + phone number registration + token mint in one window.

Set up your Meta App once (AGENCY_ADMIN)

Dashboard → Meta App → configure your Meta App ID + App Secret + Embedded Signup Configuration ID. This is a workspace-wide setup — each client connects under it.

Meta App setup

Per-client connect

Dashboard → ChannelsConnect WhatsAppEmbedded signup. A Meta popup opens, the user picks their WABA + phone, grants permissions, and Meta returns a long-lived System User token. We persist it encrypted (AES-256-GCM).

Manual (fallback when Embedded Signup isn’t available)

Paste the WhatsApp Business Account ID + Phone Number ID + a manually-minted System User token. Use this when you need to connect a number that’s already on someone else’s WABA, or when Embedded Signup isn’t yet configured for your Meta App.

After the channel is connected

A green dot appears next to the channel in the list. From that moment:

  • Any inbound message starts a Conversation row (status = OPEN by default)
  • The inbox auto-refreshes — you’ll see it appear in real-time via WebSocket
  • Active flows tied to this channel can fire automatically
  • Keyword rules + Chat AI agent (if enabled) react to text inbounds

Send a test message from your phone to verify the round-trip. Next step: Receiving + replying.

Last updated on