Messenger Integrations

Connect Telegram, WhatsApp, Instagram, and Facebook Messenger

Supported Messengers

Messenger	Auth Method	Inbound	Outbound	Tools
Telegram	Bot Token	Yes	Yes	6
WhatsApp Business	Meta OAuth	Yes	Yes	6
Instagram DM	Meta OAuth	Yes	Yes	6
Facebook Messenger	Meta OAuth	Yes	Yes	6

Telegram

Telegram is the simplest integration — no OAuth, no SDK dependencies. Just a bot token from BotFather.

Setup

1. Create a Bot

   Open @BotFather in Telegram, send /newbot, and follow the instructions. You’ll receive a bot token like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

2. Add Integration

   Go to Integrations → Add Integration → select Telegram from the Messengers category.

3. Enter Token

   Choose a company, name the integration, and paste your bot token.

4. Verify & Save

   Revol calls the Telegram Bot API to verify the token and automatically sets up the webhook. Your bot starts receiving messages immediately.

Agent Tools

Tool	Description
send_message	Send a text message (HTML or Markdown formatting) with optional reply-to
send_file	Send a photo, document, audio, or video by public URL
get_chat_history	Retrieve recent messages from a chat
get_chat_info	Get chat/user metadata (name, bio, member count)
edit_message	Edit a previously sent bot message
delete_message	Delete a message from the chat

---

WhatsApp Business

WhatsApp Business API is accessed through Meta’s Graph API. Requires a Meta Business account with WhatsApp Business API access.

Setup

1. Meta Business Setup

   Create a Meta Business Account and set up WhatsApp Business API access.

2. Add Integration

   Go to Integrations → Add Integration → select WhatsApp Business.

3. OAuth

   Click “Connect with Meta” — you’ll be redirected to Meta’s consent screen. Authorize access to your WhatsApp Business account.

4. Configure

   Enter your Phone Number ID and App Secret. Revol exchanges the OAuth code for a long-lived token (~60 days).

WhatsApp has a 24-hour messaging window. You can send free-form messages only within 24 hours of the last customer message. Outside this window, use send_template_message with pre-approved templates.

Agent Tools

Tool	Description
send_message	Send a text message within the 24-hour window
send_template_message	Send a pre-approved template (works outside 24h window)
send_media	Send an image, document, video, or audio by URL
get_message_history	Retrieve conversation messages
get_contact_info	Get contact profile information
mark_as_read	Send read receipts for a message

---

Instagram DM

Instagram Direct Messages are accessed through Meta’s Graph API with the same OAuth flow as WhatsApp.

Setup

1. Connect Facebook Page

   Your Instagram Business account must be linked to a Facebook Page.

2. Add Integration

   Go to Integrations → Add Integration → select Instagram.

3. OAuth

   Click “Connect with Meta” and authorize access to your Instagram account.

4. Configure

   Enter your App Secret and Verify Token.

Agent Tools

Tool	Description
send_message	Send a direct message to an Instagram user
send_media	Send a media attachment in DM
get_message_history	Retrieve DM thread messages
get_profile	Get public Instagram profile info
get_comments	Get comments on a specific post
reply_to_comment	Post a threaded reply to a comment

---

Facebook Messenger

Facebook Messenger connects via your Facebook Page. Same Meta OAuth flow as WhatsApp and Instagram.

Setup

1. Facebook Page

   You need a Facebook Page linked to your Meta Business Account.

2. Add Integration

   Go to Integrations → Add Integration → select Facebook Messenger.

3. OAuth

   Click “Connect with Meta” and authorize access to your Page.

4. Configure

   Enter your App Secret and Verify Token.

Agent Tools

Tool	Description
send_message	Send a text message to a Facebook user
send_template_message	Send a structured template (buttons, generic, receipt)
send_media	Send an image, video, audio, or file
get_message_history	Retrieve conversation thread
get_profile	Get user profile from page-scoped ID
send_buttons	Send quick reply options to the user

---

Message Flow

Regardless of the messenger, the processing flow is identical:

1. Incoming Message

   Messenger platform sends a webhook to Revol with the message content and sender info.

2. Route to Agent

   Revol identifies the channel, finds the assigned AI agent, and creates or continues a conversation session. The same sender always gets the same conversation thread.

3. AI Processing

   The message is processed through the agent’s workflow — LLM nodes, RAG knowledge base lookup, tool calls, and conditions.

4. Outbound Reply

   Agent’s response is sent back through the same messenger’s API. The user sees the reply in their chat.

Messenger messages are processed asynchronously via a background job. This ensures the webhook returns a quick 200 response, preventing timeouts and retries from the messenger platform.

Using Tools in Workflow Nodes

Messenger tools work like any other agent tool:

1. Connect the integration and verify credentials
2. In the agent’s Tools tab, you’ll see the provisioned tools
3. Add tools to custom nodes in the workflow editor
4. The LLM decides when to use them based on conversation context

Example: A customer asks “Send me the brochure on WhatsApp”. The agent uses send_media to send a PDF document, then confirms delivery in the chat.

Webhook Security

Messenger	Validation
Telegram	Secret token in webhook URL (SHA-256 hash of bot token)
WhatsApp	HMAC-SHA256 signature (X-Hub-Signature-256 header with app_secret)
Instagram	HMAC-SHA256 signature (X-Hub-Signature-256 header with app_secret)
Facebook	HMAC-SHA256 signature (X-Hub-Signature-256 header with app_secret)

All messenger webhooks are rate-limited to 120 requests per minute per channel.