Channels

Connect and manage messaging channels — WhatsApp, Gmail, Twitter, Web

All endpoints require authentication.

Endpoints

List Channels

GET /api/channels

---

Create Channel

POST /api/channels

Body

Field	Type	Required	Description
name	string	Yes	Label for the channel
type	string	Yes	whatsapp, gmail, twitter, web, telegram
apiKey	string	Depends	API key from your WhatsApp provider
accessToken	string	Depends	OAuth access token (Gmail, Twitter)

---

Get Channel

GET /api/channels/:id

---

Update Channel

PATCH /api/channels/:id

---

Delete Channel

DELETE /api/channels/:id

Deleting a channel removes it from all associated bots.

---

WhatsApp — Send Message

POST /api/whatsapp/send

Body

Field	Type	Description
to	string	Recipient phone number (with country code, no +)
message	string	Message text
channelId	number	The WhatsApp channel to send from

---

Send Image

POST /api/whatsapp/send-image

Field	Type	Description
to	string	Recipient phone number
imageUrl	string	Publicly accessible image URL
caption	string	Optional caption
channelId	number	Channel to send from

---

List Templates

GET /api/whatsapp/templates

Returns approved WhatsApp message templates for the linked account.

---

Health Check

GET /api/whatsapp/health

Returns connectivity status of the WhatsApp integration.