Channel Create
channel_createCreates a channel for email, webchat, Telegram, Bluesky, or app store connections with settings and credentials, verified before saving and ready for onboarding support conversations.
Instructions
Create a channel that is set up with settings or credentials: EMAIL, WEBCHAT, BLUESKY, TELEGRAM, APPSTORE, PLAYSTORE (website chat needs none; the result carries the webchatKey of its embed snippet). Pass the fields of that type. Accounts that are connected by signing in (MESSENGER, INSTAGRAM, LINKEDIN, WHATSAPP, THREADS, X, TIKTOK, YOUTUBE, GOOGLE_BUSINESS, MASTODON) are started with channel_connect instead. FirstReply checks the credentials with the platform before it saves. Needs manager rights and a free channel in the plan (organization_usage).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organizationId": "<organizationId>",
"type": "<type>",
"name": "<name>"
},
"name": "channel_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the channel as the team sees it. | |
| type | Yes | The channel type. | |
| emailSsl | No | EMAIL: connect with SSL/TLS. | |
| emailHost | No | EMAIL: mail server host name, e.g. mail.example.com. | |
| emailPort | No | EMAIL: SMTP port, e.g. 465 or 587. | |
| commentMode | No | Social accounts: which comments on posts become conversations. ALL, QUESTIONS (emoji-only and off-topic comments are closed quietly) or NONE. | |
| telegramChat | No | TELEGRAM: the Telegram channel the bot posts to (@name, a t.me link or the id); the bot has to be an administrator of it. Optional: without it the channel only receives messages to the bot. | |
| webchatColor | No | WEBCHAT: accent color as hex, e.g. #2563eb. | |
| webchatTheme | No | WEBCHAT: widget theme. | |
| webchatTitle | No | WEBCHAT: title shown in the widget. | |
| appstoreAppId | No | APPSTORE: the app's Apple ID (the number in its App Store link). | |
| appstoreKeyId | No | APPSTORE: key id of the App Store Connect API key. | |
| blueskyHandle | No | BLUESKY: the account's handle, e.g. example.bsky.social. | |
| emailPassword | No | EMAIL: the mailbox password. Stored encrypted, never returned. | |
| emailPortImap | No | EMAIL: IMAP port, e.g. 993. | |
| emailUsername | No | EMAIL: the mailbox address, which is also the login. | |
| organizationId | Yes | The organization id. Use organization_list to find it. | |
| appstoreAppName | No | APPSTORE: the app's name. | |
| webchatPosition | No | WEBCHAT: side of the page the launcher sits on. | |
| appstoreIssuerId | No | APPSTORE: issuer id of the App Store Connect API key. | |
| commentAutoReply | No | Social accounts: send AI replies to comments right away instead of keeping them as drafts. | |
| telegramBotToken | No | TELEGRAM: the token of the bot from @BotFather. Stored encrypted. | |
| publishingEnabled | No | Social accounts: let posts be published to this channel (post_schedule). Counts against the plan's publishing limit; the channel has to be allowed to publish (publishingAuthorized, see channel_connect). | |
| appstorePrivateKey | No | APPSTORE: content of the .p8 private key file. Stored encrypted. | |
| blueskyAppPassword | No | BLUESKY: an app password (Bluesky settings, Privacy and security, App passwords), never the account password. Stored encrypted. | |
| playstorePackageName | No | PLAYSTORE: the app's package name, e.g. com.example.app. The organization's service account (channel_playstore_service_account) has to be invited in the Play Console first. | |
| webchatLauncherLabel | No | WEBCHAT: text next to the launcher button. | |
| webchatAllowedDomains | No | WEBCHAT: comma-separated domains the widget may be embedded on. Empty allows every site. | |
| webchatRequireContact | No | WEBCHAT: ask visitors for name and email before they can write. | |
| webchatWelcomeMessage | No | WEBCHAT: first message visitors see. | |
| playstoreApplicationName | No | PLAYSTORE: the app's name. |