Canal Telegram

Camada funcional

Um bot do Telegram conectado ao agente: a pessoa conversa pelo aplicativo e o agente responde ali mesmo. Só quem está na lista de permitidos consegue falar.

O que o canal aceita

Texto, legendas, fotos, documentos suportados e mensagens de voz — estas últimas transcritas pelo mesmo caminho do botão de microfone do painel.

Allowlist

Apenas usuários explicitamente listados são atendidos. É o controle de quem alcança o agente por esse canal — sem ele, qualquer pessoa que descubra o bot conversaria com o agente da organização.

Pela tela de configuração do canal dá para: conectar um bot, ver o estado da conexão, incluir ou remover gente da lista de permitidos, e desconectar.

Sem entrega duplicada em nova tentativa

O webhook registra a atualização recebida antes de iniciar o processamento. Quando o Telegram reenvia a mesma atualização — comportamento normal quando a confirmação não chega a tempo —, a segunda tentativa colide com o registro já feito e não dispara uma segunda execução.

A ordem importa: registrar antes de começar a processar, não depois. Já houve um incidente em que a mesma mensagem chegava multiplicada no chat enquanto a interface mostrava só uma; as causas identificadas foram duplicação na entrada vinda do provedor de integrações e uma nova tentativa dentro do próprio canal — o registro antecipado cobre esse segundo caso.

Entrega da resposta

O Telegram não renderiza o mesmo texto formatado que aparece no painel, então a resposta é adaptada para caber nas limitações do canal. O canal também reconhece comandos, mídia, e quem está falando quando o bot está dentro de um grupo.