Vai al contenuto

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".