Configuring user connectors

This guide is for Pro or self-hosted (coming soon) hosts who add their own notification connectors (Email, SMS, WhatsApp, Telegram). It walks through each type with detailed steps and links to the relevant provider setup pages.

How to add a connector in BAP

1. Log into the Host Dashboard
2. Go to Settings → Connectors
3. Click "Add Connector"
4. Choose the connector type
5. Enter the credentials (see the section below for your type)
6. Click "Test" then "Save"

Jump to: Email · SMS (Twilio) · WhatsApp (Meta Cloud API) · Telegram

---

Email

Prerequisites

• An SMTP provider (e.g. SendGrid, Resend, Postmark, Mailgun) or your own SMTP server
• Verified sender email or domain

Step-by-step

1. Choose a provider — Use an SMTP relay (SendGrid, Resend, Postmark, Mailgun, etc.) or your own mail server. Verify your sending domain or email address with your provider.
2. Get credentials — You need: SMTP host, port (usually 587 for TLS), username, password, and the sender (from) address. Check your provider's documentation for SMTP credential setup.
3. In BAP — Enter SMTP Host, SMTP Port, Username, Password, and Sender Email in the Add Connector form.
4. Test and save — Click "Test", enter your email, then "Save".

Back to Connectors overview

---

SMS (Twilio)

Prerequisites

• Twilio account
• A Twilio phone number for sending
• An API Key (Key SID + Secret) — BAP uses API Key, not Account SID + Auth Token

Step-by-step

1. Create a Twilio account — Sign up at twilio.com and verify your phone number.
2. Create an API Key — In Twilio Console → API keys, click Create API Key. Name it (e.g. "BAP SMS"). Copy the Key SID (starts with SK...) and the Secret (shown only once).
3. Get a phone number — In Phone Numbers → Manage, buy or select a number. Note it in E.164 format (e.g. +1234567890).
4. In BAP — Enter API Key SID, API Key Secret, and From Number in the Add Connector form.
5. Test and save — Click "Test", enter a destination number, then "Save".

Back to Connectors overview

---

WhatsApp (Meta Cloud API)

Prerequisites

• Meta Business account
• WhatsApp Business API enabled via Meta for Developers
• A business phone number for WhatsApp

Step-by-step

1. Create a Meta app — Go to developers.facebook.com, create an app (Business type), and add the WhatsApp product.
2. WhatsApp Cloud API setup — Follow Get started with the WhatsApp Cloud API. In API Setup you’ll see Phone number ID and Temporary access token (for production, use a permanent token from System Users).
3. Get Phone Number ID and Access Token — In the Meta app dashboard: WhatsApp → API Setup. Copy Phone number ID. For the token: use the temporary token for testing, or create a System User and generate a permanent token.
4. In BAP — Enter Phone Number ID and Access Token in the Add Connector form.
5. Register message templates — WhatsApp requires pre-approved templates for business-initiated messages. Follow the WhatsApp message templates guide to register all 9 required templates in your Meta Business Manager.
6. Test and save — Click "Test", enter a WhatsApp number (with country code, no +), then "Save".

Back to Connectors overview

---

Telegram

Prerequisites

• A Telegram account
• A bot created via @BotFather

Step-by-step

1. Create a bot — Open Telegram, search for @BotFather, send /newbot, and follow the prompts to name your bot. BotFather will reply with a token (format: 1234567890:ABCdefGHI...).
2. Copy the token — Save the token; you’ll paste it into BAP.
3. In BAP — Enter the Bot Token in the Add Connector form.
4. Test — Start a chat with your bot (send /start) so it can receive messages. Then in BAP click "Test" and enter your Telegram username or the phone number linked to your account.
5. Save — Click "Save".

Back to Connectors overview