Skip to main content

​
Channels

Channels are the messaging platforms the agent can be reached on. With a channel connected, you can send Headmaster a message from your phone and the agent’s reply lands in the same conversation history.

​
Supported platforms

​
Platform capabilities

​
Connecting a channel

1

Open Channels settings

Go to Settings → Headmaster’s Library → Channels.
2

Pick a channel and connect

Click the channel and click Connect. Follow the platform-specific flow below.
3

Test

Send a message from your phone to the channel to confirm it’s working.

​
Setup guides

1

Create a bot

Message @BotFather on Telegram. Send /newbot and follow the prompts to name it. Copy the bot token BotFather gives you.
2

Connect in Headmaster

Go to Channels → Telegram → Connect. Paste the bot token and save.
3

Test

Send a message to your bot on Telegram.
What works:
  • Text messages (send and receive)
  • File attachments (send and receive)
  • Inline buttons for approvals and clarifications
  • Proactive notifications from scheduled tasks
  • Group chats (the bot responds to mentions)

​
What flows over channels

  • Inbound — messages from the platform become new turns in your active conversation.
  • Outbound — the agent’s responses are sent back to the platform.
  • File attachments — supported on channels that allow them.
  • Approvals and clarifications — work the same as in the desktop chat. On platforms without inline buttons, approvals are sent as text prompts.
  • Notifications — the agent proactively messages you when a background task finishes or a scheduled task triggers.

​
Proactive behaviors

The agent can reach out to you on channels without you asking:
  • Scheduled task results — when a cron job fires, the result is delivered to your configured channel.
  • Background task completion — when a long-running task finishes.
  • Approval requests — if the agent needs approval and you’re not at the desktop, it sends the request to your channel.
  • Reminders — the agent can send scheduled reminders.
This is what makes Headmaster feel like a 24/7 assistant — it reaches out to you on the platform you’re already on.

​
Disconnecting

Click Disconnect on a channel card. The agent stops reading from and replying to that platform immediately. Past conversation transcripts are kept.

The Schedule

Set up recurring tasks that deliver results to your channels.

Headmaster on the Go

Browser-based access from your phone — no channel setup needed.