Documentation

Messaging (WhatsApp, Telegram, Mattermost)

Connect a pipeline to WhatsApp Cloud API, Telegram Bot API, or Mattermost.

Messaging

betool integrates the three most requested professional 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. Administration → WhatsApp → Accounts — 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. Handled by the standard file_transform nodes.

Telegram

Prerequisites

A bot created via @BotFather (API token).

Setup

  1. Administration → Telegram → Bots — 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. Administration → Mattermost → Connections — 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 between the three

Use caseRecommendation
External consumer customer supportWhatsApp
Internal team assistantTelegram or Mattermost (depending on what is already deployed)
IT / DevOps operations botMattermost
Multi-channel presenceYou can connect the same pipeline to multiple channels simultaneously