Connect External Communication Channels

External Communications let Apprentice connect agents to services such as chat, email, webhooks, and streaming channels.

Add integrations globally first, then subscribe individual agents to the integrations they should use.

Open External Communications

Open Settings > External Communications.

This page lists supported platforms and lets you add, edit, enable, disable, or delete integrations.

Current platform sections include:

• Telegram
• Discord
• Signal
• WhatsApp
• Slack
• Twitch
• Email

Webhook is also available as an integration type through the backend registry.

Global Integration, Per-Agent Subscription

Integration setup has two levels:

• Global integration: credentials, connection mode, and service configuration.
• Agent Channels tab: whether a specific agent is subscribed, active, and allowed to wake from that integration.

Deleting a global integration removes its agent subscriptions.

Integration Modes

Some platforms support multiple modes:

• Bot: bi-directional bot account behavior.
• User: bi-directional signed-in user behavior where supported.
• Webhook: send-only notifications or one-way delivery.

The available modes depend on the platform.

Add An Integration

In Settings > External Communications:

1. Choose the platform.
2. Select Add.
3. Follow the in-app setup guide if shown.
4. Enter required credentials.
5. Save.
6. Enable the integration.

Then subscribe an agent from its Channels tab.

Credential Health

The settings page can show credential issues such as migration needed, migration failed, keychain unavailable, unavailable encrypted credentials, or user action required.

When this appears, edit the integration and update credentials before relying on the channel.

Platform Notes

Telegram uses a bot token.

Discord supports bot and webhook modes.

Slack supports bot, user, and webhook modes.

Signal uses a managed signal-cli sidecar and device linking.

WhatsApp uses linked-device behavior. Use a dedicated number when possible.

Twitch supports account linking and can require re-authorization if refresh fails.

Email can send through SMTP and optionally read through IMAP or POP3.

Next Step

After the global integration is configured, subscribe an agent to it from the agent's Channels tab.