Documentation

Messageries (WhatsApp, Messenger, Telegram, Mattermost)

Brancher un pipeline à WhatsApp (Cloud API, ou Green API en Beta), Messenger, Telegram Bot API ou Mattermost.

Messageries

betool intègre les messageries les plus demandées. Chacune suit le même modèle : un module *_inbound pour la réception, un module *_outbound pour l'émission.

WhatsApp Business

Prérequis

  • Compte Meta Business.
  • Numéro WhatsApp Business approuvé.
  • Application Cloud API configurée avec un webhook.

Mise en place

  1. Paramètres → Services → WhatsApp, onglet Comptes — connectez votre app Meta avec son App Secret et son Phone Number ID.
  2. Côté Meta, ajoutez l'URL webhook donnée par betool (https://platform.betool.ai/entries/whatsapp/<id>) et copiez le Verify Token généré.
  3. Mappez le numéro vers un pipeline.

Particularités

  • Templates approuvés obligatoires pour initier une conversation (hors fenêtre 24h). Vous gérez les templates côté Meta, betool les référence par leur nom.
  • Médias supportés : images, audio, vidéo, documents. Les documents PDF et Excel peuvent ensuite être traités par le nœud file_transform.

WhatsApp via Green API (Beta)

Beta. Le connecteur Green API n'a pas encore été éprouvé sur un compte client réel en production.

Pour un numéro WhatsApp sans compte Meta Business, betool se connecte aussi à Green API (votre propre instance, BYO) : le récepteur greenapi_inbound déclenche un pipeline à chaque message reçu (médias copiés dans betool), le nœud greenapi_outbound envoie un texte ou un fichier avec légende. betool installe lui-même le webhook chez Green API.

  • Ce n'est pas l'API officielle de WhatsApp : Green API émule WhatsApp Web. WhatsApp peut bannir le numéro, sans recours. Pour un usage client à volume, préférez la Cloud API ci-dessus.
  • Pas de templates ni de fenêtre de 24 heures ; les groupes sont accessibles.
  • Un envoi réussi prouve que le message est en file, pas qu'il est délivré.
  • L'envoi passe uniquement par le nœud (exactly-once) : aucun tool ne permet à un agent d'envoyer seul.

Messenger

Le récepteur messenger_inbound déclenche un pipeline à chaque message reçu sur votre Page Facebook ; le nœud messenger_outbound répond. Les réponses libres ne sont possibles que dans les 24 heures qui suivent le dernier message de l'utilisateur (règle Meta). Détails et connexion : Meta.

Telegram

Prérequis

Un bot créé via @BotFather (token API).

Mise en place

  1. Paramètres → Services → Telegram, onglet Comptes — collez le token, betool configure le webhook automatiquement.
  2. Mappez le bot vers un pipeline.

Particularités

  • Le bot peut être ajouté à des groupes ou utilisé en privé.
  • Pas de quotas restrictifs comme WhatsApp — pratique pour des assistants internes ou des notifications opérationnelles.

Mattermost

Prérequis

  • Une instance Mattermost (cloud ou self-hosted).
  • Un outgoing webhook côté Mattermost.

Mise en place

  1. Paramètres → Services → Mattermost, onglet Comptes — créer la connexion, copier l'URL fournie par betool.
  2. Côté Mattermost, créer un outgoing webhook qui pointe vers cette URL.
  3. Optionnel : créer un incoming webhook sur Mattermost pour permettre à betool de poster des réponses.

Particularités

  • Threads conservés — les réponses d'agent restent dans le fil de la question.
  • Channels privés / DM — choisissez la portée à la configuration.

Choisir

Cas d'usageRecommandation
Support client externe grand publicWhatsApp
Assistant interne d'équipeTelegram ou Mattermost (selon ce qui est déjà déployé)
Bot d'opérations IT / DevOpsMattermost
Présence multi-canauxVous pouvez brancher le même pipeline à plusieurs canaux simultanément