Help Center Integrazione con Telegram Bot

Integrazione con Telegram Bot

Questa guida spiega come connettere il tuo Bot Telegram al pannello chat.smsbat.com.

1. Aggiunta del Bot al Pannello

Nella dashboard, vai a I miei account -> Bot di Telegram.

  1. Fai clic su Aggiungi bot.
  2. Inserisci i dati del bot Telegram (nome, token) e salvali nel sistema.
  3. Dopo il salvataggio, vai alle impostazioni del bot e recupera il suo ID per formulare l’URL di richiamata.

2. Opzioni di integrazione con Chat.SMSBAT

Opzione 2.1: proxy delle richiamate da Telegram a Omni Chat

In questo flusso, il tuo server riceve direttamente il webhook di Telegram e poi inoltra il payload a 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

Requisiti:

  • Assicurarsi che il sistema client invii le richiamate in entrata direttamente al webhook chat.smsbat.com.
  • Fornisci il testo/l’azione esatta del pulsante “Avvia chat”.
  • Fornisci il testo/l’azione esatta del pulsante “Termina chat”.

Opzione 2.2: logica proxy restituita al client

In questo flusso, SMSBAT è impostato come webhook diretto in Telegram. SMSBAT riceve l’evento e quindi inoltra la richiamata al tuo sistema.

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

Requisiti:

  • Fornire l’URL di richiamata generato formulato dopo l’aggiunta del bot. L’URL sarà simile a: https://restapi.smsbat.com/api/tg_callback/{ID}
  • Fornisci il testo/l’azione esatta del pulsante “Avvia chat”.
  • Fornisci il testo/l’azione esatta del pulsante “Termina chat”.