Messaging Channels API

Deploy agents to Telegram, WhatsApp, and web chat.

Base URL: https://api.bluenexus.ai/api/v1/messaging-channels

POST /messaging-channels

Create a messaging channel.

Auth: Bearer token with messaging-channels scope

{
  "type": "telegram",
  "agentId": "agent-abc123",
  "config": {
    "botToken": "123456:ABCdefGHI..."
  }
}

---

GET /messaging-channels

List all messaging channels.

---

GET /messaging-channels/:channelId

Get a specific channel.

---

PUT /messaging-channels/:channelId

Update a channel (e.g., change agent).

---

DELETE /messaging-channels/:channelId

Delete a channel.

---

POST /messaging-channels/:channelId/link-account

Link a user's BlueNexus account to a channel.

---

POST /messaging-channels/:channelId/unlink-account

Unlink a user's account from a channel.

---

Webhook Endpoints

These are called by the messaging platforms (not your app):

• POST /messaging-channels/telegram/webhook — Telegram webhook
• POST /messaging-channels/whatsapp/webhook — WhatsApp webhook
• POST /messaging-channels/webchat/messages — Web chat messages

Supported Platforms

Platform	Type	Config Required
Telegram	telegram	botToken
WhatsApp	whatsapp	phoneNumberId, accessToken, verifyToken
Web Chat	webchat	None