PlatformGuard

Telegram and WhatsApp

Run Humane behind a Telegram bot or a WhatsApp Business number.

Register a Telegram bot or a WhatsApp Business number and Humane receives messages, runs them through the full pipeline and delivers the replies. Inbound webhooks are verified, and outbound replies are split, paced and tracked.

Messaging channels

  • Telegram botActive

    In · secret-token verified

    Out · typing indicator · 4,000-char chunks

  • WhatsApp BusinessActive

    In · app-secret signature verified

    Out · read receipts · sent → delivered → read

client.channels.create_telegram(bot_token=…)

Illustration of Telegram and WhatsApp channels
In code

Connect a channel

python
bot = client.channels.create_telegram(bot_token=os.environ["TELEGRAM_BOT_TOKEN"])

wa = client.channels.create_whatsapp(
    phone_number_id="1098...",
    access_token=os.environ["WHATSAPP_TOKEN"],
    app_secret=os.environ["WHATSAPP_APP_SECRET"],
)
# Secrets are shown once on create, then redacted to their last four characters
Delivery

Replies that respect the medium

Long replies are split under each platform's limits, Telegram shows a typing indicator, and the pauses between chunks follow the timing engine. On WhatsApp, inbound messages are marked as read and your outbound messages move from sent to delivered to read.

  • Telegram: secret-token check on every inbound update
  • WhatsApp: app-secret signature check on every inbound webhook
  • Auto-reply can be switched off per channel
  • HTTP delivery for your own endpoints

Timing · one reply

delay_ms

13,857
  • base+800ms
  • low_mood+1,500ms
  • emotional_weight+8,648ms
  • conversation_pace+500ms
  • jitter+2,409ms

mode: low_mood · floor 200ms · non-crisis ceiling 30s

Illustration of a timing decision and its contributors

Channel questions

Something else? Ask us.

Every AI should know who it's talking to.

The safety and human-oversight layer for emotional AI: user state across sessions, risk alerts, safety gates and human takeover, with every decision explained.