channels_connect
🔌 Connect a messaging channel to this workspace, or find out how.
Call with no channel for the catalogue: every channel, its connect_mode and its link.
Call with channel only to learn what to ask the person for (credential_fields).
Call with channel + credentials to connect a credentials channel: email over IMAP with an app password, telegram_bot with a bot token, line with the channel access token and channel secret, avito.
Channels that need a QR scan, a phone code or a browser sign-in (telegram, whatsapp, instagram, facebook, email (Google sign-in), youtube, tiktok, x, threads, linkedin, zalo, maxru, the voice carriers) cannot be connected from here: the tool answers success with needs_person=true and the link https://dialogbrain.com/connect/, which opens the connection dialog for that channel. Give the person that link; do not tell them to look for it in settings. A website widget is not connected here at all: use widgets.create.
channel='google_drive' (owner/admin) creates the workspace's Google Drive address, or returns it when it exists: the person shares a folder (or a Shared Drive) with that address as Editor, then drive.folders(action='add', link=) registers it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "channels_connect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel | No | Channel id, e.g. 'email', 'telegram_bot', 'whatsapp'. Omit for the catalogue. | |
| credentials | No | The fields credential_fields asked for. Never echoed back. `password` takes a clip:<id> handle from clipboard.copy (source {message_id, pattern: 'password'}) in place of the value, so a password a person sent in a chat is connected without being read. | |
| display_name | No | Name for the account in the channel list. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. |