Hyppää sisältöön

Telegram Bot -integraatio

Tämä opas selittää, kuinka Telegram Bot kytketään chat.smsbat.com-paneeliin.

1. Botin lisääminen paneeliin

Siirry hallintapaneelissa kohtaan Omat tilit -> Telegram-botit.

  1. Napsauta Lisää botti.
  2. Täytä Telegram-botin tiedot (nimi, tunnus) ja tallenna ne järjestelmään.
  3. Siirry tallennuksen jälkeen botin asetuksiin ja hae sen ID muodostaaksesi takaisinsoitto-URL-osoitteen.

2. Integrointivaihtoehdot Chat.SMSBAT:n kanssa

Vaihtoehto 2.1: Välityspalvelimen takaisinsoitto Telegramista Omni Chatiin

Tässä kulussa palvelimesi vastaanottaa Telegram-webhookin suoraan ja välittää sitten hyötykuorman SMSBAT:lle.

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

Edellytykset: - Varmista, että asiakasjärjestelmä välittää saapuvat takaisinkutsut suoraan chat.smsbat.com-webhookiin. - Anna "Aloita keskustelu" -painikkeen tarkka teksti/toiminto. - Anna "Lopeta keskustelu" -painikkeen tarkka teksti/toiminto.

Vaihtoehto 2.2: Välitetty logiikka takaisin asiakkaalle

Tässä kulussa SMSBAT on asetettu suoraksi webhookiksi Telegramissa. SMSBAT vastaanottaa tapahtuman ja välittää takaisinsoiton takaisin järjestelmääsi.

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

Edellytykset: - Anna luotu takaisinsoitto-URL-osoite, joka on muotoiltu botin lisäämisen jälkeen. URL-osoite näyttää tältä: https://restapi.smsbat.com/api/tg_callback/{ID} - Anna "Aloita keskustelu" -painikkeen tarkka teksti/toiminto. - Anna "Lopeta keskustelu" -painikkeen tarkka teksti/toiminto.