Messaging (WhatsApp, Messenger, Telegram, Mattermost)

betool integrates the most requested messaging platforms. Each follows the same model: a *_inbound module for reception and a *_outbound module for sending.

WhatsApp Business

Prerequisites

• Meta Business account.
• Approved WhatsApp Business number.
• Cloud API application configured with a webhook.

Setup

1. Settings → Services → WhatsApp, Accounts tab — connect your Meta app with its App Secret and Phone Number ID.
2. On the Meta side, add the webhook URL provided by betool (https://platform.betool.ai/entries/whatsapp/<id>) and copy the generated Verify Token.
3. Map the number to a pipeline.

Specifics

• Approved templates are mandatory to initiate a conversation (outside the 24-hour window). You manage templates on the Meta side; betool references them by name.
• Supported media: images, audio, video, documents. PDF and Excel documents can then be processed by the file_transform node.

WhatsApp via Green API (Beta)

For a WhatsApp number without a Meta Business account, betool also connects to Green API (your own instance, BYO): the greenapi_inbound receiver triggers a pipeline on each message received (media copied into betool), and the greenapi_outbound node sends a text or a file with a caption. betool installs the webhook at Green API itself.

• This is not the official WhatsApp API: Green API emulates WhatsApp Web. WhatsApp may ban the number, with no recourse. For high-volume customer use, prefer the Cloud API above.
• No templates and no 24-hour window; groups are accessible.
• A successful send proves the message is queued, not that it was delivered.
• Sending only goes through the node (exactly-once): no tool lets an agent send on its own.

Messenger

The messenger_inbound receiver triggers a pipeline on each message received on your Facebook Page; the messenger_outbound node replies. Free-form replies are only possible within the 24 hours following the user's last message (Meta rule). Details and connection: Meta.

Telegram

Prerequisites

A bot created via @BotFather (API token).

Setup

1. Settings → Services → Telegram, Accounts tab — paste the token; betool configures the webhook automatically.
2. Map the bot to a pipeline.

Specifics

• The bot can be added to groups or used in private conversations.
• No restrictive quotas like WhatsApp — ideal for internal assistants or operational notifications.

Mattermost

Prerequisites

• A Mattermost instance (cloud or self-hosted).
• An outgoing webhook on the Mattermost side.

Setup

1. Settings → Services → Mattermost, Accounts tab — create the connection and copy the URL provided by betool.
2. On the Mattermost side, create an outgoing webhook pointing to that URL.
3. Optional: create an incoming webhook on Mattermost to allow betool to post replies.

Specifics

• Threads preserved — agent replies stay in the thread of the original question.
• Private channels / DMs — choose the scope during configuration.

Choosing