Pular para as operações

Mensageria

Telegram em um fluxo de decisão.

4 Telegram operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Mensageria
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

Um app de mensagens com API de bot aberta.

O Telegram é um serviço de mensagens cuja Bot API permite que um programa publique em um chat ou canal com nada além de um token de bot. Isso o torna um canal de alerta prático para um time que já o usa, sem processo de compras entre o fluxo e a mensagem.

O que um fluxo pode chamar

4 operações, cada uma um passo que você coloca no editor.

  1. POST/sendMessage

    Enviar uma mensagem de texto

    Envia texto para um chat, grupo, supergrupo ou canal.

  2. POST/editMessageText

    Editar uma mensagem já enviada

    Substitui o texto de uma mensagem que o bot pode editar. Informe o chat_id e o message_id de um envio anterior; o Telegram restringe quais mensagens de negócio podem ser editadas e quando.

  3. GET/getMe

    Verificar o token do bot

    Verifies the bot token and returns the bot's basic profile.

  4. GET/getUpdates

    Obter as atualizações pendentes do bot

    Recupera as atualizações na fila, como mensagens recebidas e callback queries.

Onde isso entra na decisão

Messaging calls have a natural place in a flow.

Avisar uma pessoa faz parte da decisão, e não é um detalhe posterior: a mensagem sai do próprio fluxo, no ponto em que o fluxo decidiu que ela se justificava, carregando a mesma versão e a mesma trilha do resultado que a disparou.

Whatever Telegram returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Telegram as a connection authenticating with an API key.
  • 02A Telegram tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Enviar uma mensagem de texto” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Telegram em um fluxo.

Como conecto a Telegram a um fluxo de decisão?

Adicione a Telegram como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Telegram em uma decisão sem nunca ver o segredo.

Dá para testar a Telegram sem tocar em produção?

A Telegram expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na Telegram?

4 operações, incluindo “Enviar uma mensagem de texto”, “Editar uma mensagem já enviada”, “Verificar o token do bot”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Enviar uma mensagem de texto”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Telegram deve ser chamada?

Avisar uma pessoa faz parte da decisão, e não é um detalhe posterior: a mensagem sai do próprio fluxo, no ponto em que o fluxo decidiu que ela se justificava, carregando a mesma versão e a mesma trilha do resultado que a disparou.

Quando você quiser

Wire Telegram into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação