Docs

Connecting Platforms

Connect each platform in Settings → Gateway. Here's what each one needs.

Telegram

  1. Create a bot with @BotFather in Telegram and copy the bot token (looks like 123456789:ABCdef…).
  2. In Agentastic, open the Telegram channel and paste the token.
  3. Save — your bot is live. DM it or add it to a group and @mention it.

Discord

  1. Create an application at the Discord Developer Portal, add a Bot, and enable the Message Content Intent.
  2. Copy the Application ID and Bot Token.
  3. Enter both in the Discord channel, then invite the bot to your server.

Slack

  1. Create an app at api.slack.com, enable Socket Mode, and generate the tokens.
  2. Copy the App-Level Token (xapp-…) and the Bot User OAuth Token (xoxb-…).
  3. Paste both into the Slack channel. Mention the bot in a channel or DM it.

WhatsApp

  1. Open the WhatsApp channel — Agentastic shows a QR code.
  2. On your phone, go to WhatsApp → Settings → Linked Devices → Link a Device and scan the code.
  3. Once linked, message the connected number to reach your agent.

iMessage

Agentastic offers iMessage through a hosted shared number, so you don't need your own setup:

  1. Open the iMessage channel and choose Connect. You'll get a QR code or an SMS pairing link.
  2. Scan it with your iPhone camera — it opens Messages pre-filled — and send the pairing message (or text the pairing code to the shared number).
  3. Back in Agentastic, tap Confirm this is me to bind your phone to your account.
  4. Once active, any iMessage you send to the shared number is handled by your agent.

Email (AgentMail)

  1. Get an API key (am_…) from the AgentMail console.
  2. Enter it in the Email channel. Optionally provide an existing inbox ID; otherwise Agentastic creates a new inbox.
  3. Once connected, the inbox is polled for new email and your agent replies.

After connecting

Review Channel Security to control who can message the agent and which tools it may use over messaging.

Not seeing replies? Check that the background service is running and that the channel shows as connected. See Troubleshooting.