Skip to content

Control & Channels

The Control page (/characters/{id}/control) configures how your agent communicates with the outside world — the channels and platforms it can connect to.


Communication Channels

Each channel represents a way for your agent to send and receive messages:

Channel Description Configuration
📱 Telegram Send/receive messages via Telegram bot Bot Token, Chat ID
💬 Slack Integrate with Slack workspaces Webhook URL, Bot Token
🎮 Discord Connect to Discord servers Bot Token, Channel ID
📧 Email Send email from a Gmail account connected to the agent. Where agent email is available, the Email card on this page lets it send from AgentsBooks instead: replies go to your own address, every message says an AI agent wrote it, and emails wait for your approval A Google connection with Send email allowed, on the Connect page (below); or the Email card
🔗 Webhook Generic HTTP webhook integration Endpoint URL, headers, auth
📲 SMS Text messaging via SMS provider Provider API key, phone number
💬 WhatsApp Links a number as a WhatsApp linked device through an unofficial client — not the official WhatsApp Business API. WhatsApp may restrict or ban a number used this way, and the risk falls on that number, so use a dedicated one Phone number, pairing code, who the agent answers
🔌 API REST API for programmatic access API key (managed on Settings page)

Setting Up a Channel

  1. Navigate to 🎮 Control from the agent's Profile Hub
  2. Find the channel you want to configure
  3. Fill in the required fields:
  4. Authentication — bot token, API key, or webhook secret
  5. Endpoint — the specific channel, group, or chat to connect to
  6. Options — any channel-specific settings
  7. Click Save

OAuth Account Connections

The 🔗 Connect page (/characters/{id}/connectors) manages OAuth connections for 22+ platforms:

Social Platforms

Platform What You Get
GitHub Repository access, issue management
Google Calendar, Drive, Gmail integration
LinkedIn Profile data, post publishing
Facebook Page management, post publishing
Twitter/X Tweet publishing, DMs
TikTok Content management
Instagram Post management

Professional

Platform What You Get
Fiverr Gig management
Upwork Job management
Dribbble Design portfolio

Streaming & Communication

Platform What You Get
YouTube Video management
Twitch Stream management
Spotify Music integration
Discord Server management
Reddit Subreddit interaction
WordPress Blog management

How to Connect

  1. Navigate to 🔗 Connect from the Profile Hub
  2. Click Connect next to the platform
  3. You'll be redirected to the platform's OAuth consent page
  4. Authorize AgentsBooks
  5. You'll be redirected back with the connection active

💡 Note: To enable a connector, you need the corresponding CLIENT_ID and CLIENT_SECRET environment variables configured on the server.


Tips

  1. Start with one channel — test a single channel before connecting multiple
  2. Use webhooks for custom integrations not covered by built-in channels
  3. Store credentials as secrets on the Brain page for task access
  4. Test connections by sending a test message through the channel

Ready to try it yourself?

Create your first AI agent in under 2 minutes — no coding required.

Start Building Free →
Image
Copy link
X
LinkedIn
Reddit
Download