Docs · Multi-Channel Setup

Multi-Channel Setup Guide

Your Blaigent agent runs the same brain across all seven channels. This guide covers the webhook URLs, environment variables, and provider configuration steps for each channel.

💬 Web Chat 📱 WhatsApp 📞 Voice ✉️ SMS 📧 Email ✈️ Telegram 📸 Instagram

The agent brain, knowledge base, and business rules are configured once in the dashboard. Each channel connects to that brain via its own webhook.


Channel 1 — Web Chat

No external setup required

Web chat is live as soon as your account is created. Copy the embed code from Dashboard → Channels → Website and paste it into your site before the closing </body> tag.

API endpoint: POST /api/v1/agents/customer-service/chat


Channel 2 — WhatsApp (via Twilio)

Environment variables

TWILIO_ACCOUNT_SID=your_account_sid TWILIO_AUTH_TOKEN=your_auth_token TWILIO_WHATSAPP_NUMBER=whatsapp:+14155238886

Webhook URL

https://your-domain.com/webhooks/whatsapp

Steps

  1. Go to Twilio Console → Messaging → WhatsApp Senders.
  2. Set the When a message comes in webhook to your Blaigent webhook URL (HTTP POST).
  3. For testing, use Twilio's WhatsApp Sandbox. For production, use a Meta-approved WhatsApp Business number.

Channel 3 — WhatsApp (via Meta directly)

Environment variables

WHATSAPP_ACCESS_TOKEN=your_access_token WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id WHATSAPP_VERIFY_TOKEN=your_verify_token

Webhook URL

https://your-domain.com/webhooks/whatsapp

Steps

  1. Create a Facebook App with the WhatsApp Business product.
  2. Under WhatsApp → Configuration, set the Callback URL to your webhook URL and set the verify token.
  3. Subscribe to the messages webhook field.
  4. Generate a permanent system user access token with whatsapp_business_messaging permission.

Channel 4 — Voice / Phone (Twilio)

Environment variables

TWILIO_ACCOUNT_SID=your_account_sid TWILIO_AUTH_TOKEN=your_auth_token TWILIO_PHONE_NUMBER=+1234567890

Webhook URL

https://your-domain.com/webhooks/voice

Steps

  1. Go to Twilio Console → Phone Numbers → Manage → Active Numbers.
  2. Click your number and scroll to Voice & Fax.
  3. Set A Call Comes In → Webhook → your Blaigent voice webhook URL (HTTP POST).
  4. The agent uses speech-to-text (Twilio STT) and text-to-speech (TTS) — no IVR tree needed.

Voice is available as an add-on. See AI Voice & Phone Agent for pricing and capabilities.


Channel 5 — SMS (Twilio)

Environment variables

TWILIO_ACCOUNT_SID=your_account_sid TWILIO_AUTH_TOKEN=your_auth_token TWILIO_PHONE_NUMBER=+1234567890

Webhook URL

https://your-domain.com/webhooks/sms

Steps

  1. Go to Twilio Console → Phone Numbers → Configure webhook.
  2. Set the webhook URL to your Blaigent SMS webhook (HTTP POST).
  3. SMS and voice share the same Twilio credentials and phone number.

Channel 6 — Email

Environment variables (SMTP)

SMTP_HOST=smtp.gmail.com SMTP_PORT=587 SMTP_USER=your_email@gmail.com SMTP_PASSWORD=your_app_password

Webhook URL (inbound email)

https://your-domain.com/webhooks/email

Steps

  1. For outbound: configure the SMTP env vars above (or use SendGrid/Brevo API key).
  2. For inbound: use SendGrid Inbound Parse or Mailgun routing to forward emails to your webhook URL as a POST request.

Channel 7 — Instagram DMs

Setup steps

  1. Go to Meta for Developers and open (or create) your app.
  2. Add the Instagram Messaging product and connect your Instagram Business or Creator account.
  3. Under Messaging → Settings, set the Callback URL to your webhook URL and verify token.
  4. Subscribe to messages and messaging_postbacks events.
  5. Generate a long-lived Page Access Token and add it to your Blaigent dashboard.

Webhook URL

https://your-domain.com/webhooks/instagram

Testing each channel

After configuring a channel, send a test message and verify the agent responds correctly. All channels should produce the same quality of response — same knowledge, same policies, same memory.

For a channel-specific use case, see also:

Need help with setup?

Our team can walk through your channel configuration on a call.

Talk to us →