Ir para o conteúdo

Integração com bot de telegrama

Este guia explica como conectar seu Telegram Bot ao painel chat.smsbat.com.

1. Adicionando o Bot ao Painel

No painel, navegue até Minhas contas -> Bots do Telegram.

  1. Clique em Adicionar Bot.
  2. Preencha os dados do bot do Telegram (nome, token) e salve no sistema.
  3. Após salvar, acesse as configurações do bot e recupere seu ID para formular a URL de retorno de chamada.

2. Opções de integração com Chat.SMSBAT

Opção 2.1: proxy de retornos de chamada do Telegram para Omni Chat

Nesse fluxo, seu servidor recebe o webhook do Telegram diretamente e depois encaminha o payload para o 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

Requisitos: - Certifique-se de que o sistema cliente faça proxy dos retornos de chamada recebidos diretamente para o webhook chat.smsbat.com. - Forneça o texto/ação exato do botão "Iniciar bate-papo". - Forneça o texto/ação exato do botão "Encerrar bate-papo".

Opção 2.2: lógica proxy de volta ao cliente

Neste fluxo, o SMSBAT é definido como webhook direto no Telegram. SMSBAT recebe o evento e, em seguida, envia o retorno de chamada de volta ao seu 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

Requisitos: - Forneça o URL de retorno de chamada gerado formulado após adicionar o bot. A URL será semelhante a: https://restapi.smsbat.com/api/tg_callback/{ID} - Forneça o texto/ação exato do botão "Iniciar bate-papo". - Forneça o texto/ação exato do botão "Encerrar bate-papo".