Aller au contenu

Intégration du robot Telegram

Ce guide explique comment connecter votre Telegram Bot au panneau « chat.smsbat.com ».

1. Ajout du bot au panneau

Dans le tableau de bord, accédez à Mes comptes -> Bots Telegram.

  1. Cliquez sur Ajouter un bot.
  2. Remplissez les données du robot Telegram (nom, jeton) et enregistrez-les dans le système.
  3. Après avoir enregistré, accédez aux paramètres du bot et récupérez son ID pour formuler l'URL de rappel.

2. Options d'intégration avec Chat.SMSBAT

Option 2.1 : Rappels proxy de Telegram vers Omni Chat

Dans ce flux, votre serveur reçoit directement le webhook Telegram, puis transmet la charge utile à SMSBAT.

sequenceDiagram
    participant Client as Client Server
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Omni Chat
    actor Operator

    Client->>Tg: Send data to bot
    Tg->>Client: Callback from Telegram
    Client->>Proxy: Forward Telegram callback to SMSBAT
    Proxy->>Chat: Reaction to trigger message
    Operator->>Chat: Review and respond
    Chat->>Tg: Interaction with Telegram

Exigences : - Assurez-vous que le système client transmet les rappels entrants directement au webhook « chat.smsbat.com ». - Fournissez le texte/l'action exact du bouton "Démarrer le chat". - Fournissez le texte/l'action exact du bouton « Fin du chat ».

Option 2.2 : Logique proxy renvoyée au client

Dans ce flux, SMSBAT est défini comme webhook direct dans Telegram. SMSBAT reçoit l'événement, puis renvoie le rappel à votre système.

sequenceDiagram
    participant Client as Client Server
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Omni Chat
    actor Operator

    Client->>Tg: Send data to bot
    Tg->>Proxy: Callback on events from Telegram
    Proxy->>Client: Forward Telegram callback to Client
    Proxy->>Chat: Reaction to trigger message
    Operator->>Chat: Review and respond
    Chat->>Tg: Operator interaction with Telegram

Exigences : - Fournissez l'URL de rappel générée formulée après l'ajout du bot. L'URL ressemblera à : https://restapi.smsbat.com/api/tg_callback/{ID} - Fournissez le texte/l'action exact du bouton "Démarrer le chat". - Fournissez le texte/l'action exact du bouton « Fin du chat ».