Channels
Channels let your agents communicate through the messaging platforms your team and customers already use. Instead of requiring everyone to log in to the Sprigr Team portal, you can bring your agents to Telegram, WhatsApp, or Slack (through the Slack marketplace app).
Once a channel is connected, messages from that platform flow into Sprigr Team automatically. The agent responds in real time, and the conversation appears in the agent’s conversation list on the Chat page, where you can read it.
Where to configure channels
Section titled “Where to configure channels”Channels are configured per agent. Open the agent’s settings page and find the Channels section. Each channel appears as a card you can expand, configure, and toggle on or off. The toggle and the credential fields are shown only to organisation owners and admins.
Setting up channels
Section titled “Setting up channels”Each channel type has its own setup process. Select the channel you want to configure below.
WebChat
Section titled “WebChat”WebChat is the built-in chat surface. It is always available inside the Sprigr Team portal, so anyone with portal access can chat with the agent from the Chat page without any setup.
-
Open the agent’s channel settings
Go to the agent’s settings page and find the Channels section. Expand the WebChat card.
-
Enable WebChat (optional)
WebChat works through the portal without being enabled. Toggle it on only if you want to record it explicitly in the agent’s channel configuration for programmatic access.
Telegram
Section titled “Telegram”Connect an agent to a Telegram bot so users can message it directly, or add it to a group.
-
Create a bot with BotFather
Open Telegram and search for @BotFather. Send
/newbotand follow the prompts to name your bot. BotFather gives you a bot token and a bot username — keep both. -
Enter the details in Sprigr Team
In the agent’s channel settings, expand the Telegram card. Enter the Bot Username (for example
@my_bot) and paste the Bot Token from BotFather. -
Enable the channel and save
Toggle the Telegram card on, then click Save Config. Do this before you save the bot token: enabling the channel creates the secret that the webhook is registered with.
-
Save the bot token
When you save the bot token, Sprigr Team registers the webhook with Telegram for you and shows a confirmation that the webhook was registered. There is no webhook URL to copy or paste. If you see “enable the channel first”, go back to step 3.
-
Test it
In Telegram, search for your bot by its username, start a conversation, and send a message. The agent should respond within a few seconds.
WhatsApp runs through a shared Sprigr WhatsApp number at the platform level, so there is no WhatsApp Business API setup, no access token, and no phone number ID to manage. It is only available on companion agents.
-
Verify your phone number
Open your Profile in the portal and verify your phone number with the code you are sent. Australian numbers get the code by SMS; other numbers get it on WhatsApp. WhatsApp uses your verified number to identify you and route your messages.
-
Enable WhatsApp on your companion agent
In the agent’s channel settings, expand the WhatsApp card. Once your phone is verified, toggle it on.
-
Save the Sprigr bot number
The card shows the Sprigr WhatsApp bot number. Save it as a contact on your phone.
-
Connect to an agent
Message the Sprigr bot number and send
/agent <agent-slug>to connect to a specific agent (for example/agent support-bot). Use the agent’s slug, which the WhatsApp card shows, not its display name. All messages are then routed to that agent. -
Switch agents anytime
Send
/agent <agent-slug>again at any point to switch which agent you are talking to.
Interactive prompts and forms
Section titled “Interactive prompts and forms”When an agent needs you to choose something on WhatsApp, it does not make you type the answer out. It picks the richest control WhatsApp supports for the question:
- Reply buttons for a short list of options (up to three).
- A list menu when there are more options than buttons allow.
- A native form for anything richer — a multi-question ask, choosing several options at once, or answering in your own words. You tap a button to open the form, fill it in, and submit it in one pass.
You tap to answer rather than typing, and the agent picks up where it left off once you submit. See Decisions and approvals for how these prompts work across every channel.
Slack is connected through the Slack app in the App Marketplace, not through a card on the agent. The built-in Slack channel card has been retired, and the agent’s Channels section points you to the marketplace instead.
-
Open the App Marketplace
Go to Apps in the portal and find the Slack app.
-
Install and connect it
Install the app and connect your Slack workspace. The app lets your team message agents in Slack and gives agents Slack tools for reading and posting.
See Slack (App) for setup details and what it supports.
Other channels
Section titled “Other channels”Some ways to reach an agent do not have a card on the agent page:
- Website chat — A chat widget on a website hosted by Sprigr, so visitors can talk to an agent. See Websites.
- Webhook — An inbound webhook that delivers a payload to an agent or workflow. See Inbound Webhooks.
- MCP — External AI clients (Claude Code, Claude Desktop, Cursor) that talk to an agent through the MCP server. See MCP.
- Internal — Agent-to-agent traffic such as delegation and team-chat mentions, which never leaves the platform.
- Voice chat — Inside the portal chat, an agent can speak its replies aloud, and hands-free mode listens, sends after a pause, and speaks back. See Chat.
Managing channels
Section titled “Managing channels”Once configured, you can manage the agent’s channel cards from its settings page:
- Enable or disable a channel with its toggle. Its settings and saved credentials are kept. For Telegram, save the bot token again after turning it back on (see above).
- Update credentials if tokens or secrets change. Secrets are encrypted and stored securely; enter a new value to replace the old one.
Conversations from Telegram and WhatsApp appear in the agent’s conversation list on the Chat page. The Inbox holds email and support-ticket threads synced from connected mailboxes and help desks.
What each channel supports
Section titled “What each channel supports”Text works on every channel. Beyond that, the richer channels support attachments and interactive prompts:
- Telegram — the agent can send text, photos, and documents, plus interactive decision buttons (inline keyboards). Messages you send to the bot must be text; photos and files sent to it are not picked up. Works in direct messages and groups.
- WhatsApp — text, images, documents, audio, and video, plus interactive reply buttons, list menus, and native forms for structured questions. Works in direct messages and in groups once the group is linked with
/agent. If an agent needs to message you outside WhatsApp’s 24-hour reply window, the message is sent with an approved template instead of being dropped; a file sent then arrives as its name and a link. - Slack — handled by the Slack app; see Slack (App).
- WebChat — text, file attachments, and inline artifacts such as rendered documents, tables, and HTML panels (see Chat).
Multi-channel agents
Section titled “Multi-channel agents”A single agent can be connected to multiple channels at the same time. For example, your customer support agent could be available in WebChat inside the portal, in Slack (through the Slack app) for internal staff, and on Telegram for customers, all at once.
The agent keeps a separate conversation per person per channel, so context does not bleed between unrelated conversations. A group chat on Telegram or WhatsApp is one shared conversation for everyone in the group.
Next steps
Section titled “Next steps”- Chat — Use the built-in chat interface for direct conversations with agents.
- Inbox — Work through email and support-ticket threads from connected mailboxes.
- Agent Settings — Configure which channels are enabled for each agent.
- Decisions and approvals — See how agents ask users to pick options with buttons on each channel.
- Creating Agents — Set up new agents to handle specific channels.