For the complete documentation index, see llms.txt. This page is also available as Markdown.

Receptivo

Visão Geral

O Gatilho de Mensagens Receptivas do Telegram é um nó de entrada (inbound trigger) baseado em eventos de comunicação por mensageria. Sua função principal é escutar um bot específico do Telegram e disparar um fluxo de automação ou chatbot instantaneamente no momento em que um usuário envia uma nova mensagem ou interage com o bot pela primeira vez (comando /start).

Regra de Retenção de Atendimento: Assim como nos canais de WhatsApp e Facebook, o gatilho possui uma inteligência integrada de controle de estado. Ele só iniciará a automação se o contato não tiver um atendimento humano ou ticket aberto no sistema. Caso a conversa já esteja sob a responsabilidade de um operador, as mensagens enviadas pelo usuário serão direcionadas direto para a tela de chat do atendente, ignorando este gatilho para evitar duplicidade ou interferências na conversa humana.

Parâmetros de Configuração

A parametrização do gatilho vincula a automação à conta oficial do bot na plataforma através do seguinte critério:

  • Canal: Menu suspenso utilizado para selecionar qual Bot do Telegram integrado à plataforma será monitorado por este fluxo específico. Ele lista todos os bots que foram conectados através do token de API fornecido pelo BotFather.

Construtor Visual

A interface gráfica é desenhada para ser enxuta, isolando o ponto inicial de partida da automação:

  • Busca Textual de Instâncias: O menu suspenso possui um campo de busca interna (Digite aqui sua busca) para localizar rapidamente o bot correto em workspaces que gerenciam múltiplas contas e robôs de atendimento.

  • Nó Inicial Sem Entrada: No editor gráfico de fluxos, este componente se posiciona na extremidade inicial esquerda da tela. Ele não possui conectores de entrada, pois sua execução é disparada exclusivamente por um estímulo externo (a mensagem enviada pelo usuário final para o bot).

Operadores Especiais

As propriedades lógicas deste componente gerenciam a captura de identidades de perfis e o controle de variáveis nativas do ecossistema do Telegram:

  • Injeção de Payload de Perfil (Metadados do Telegram): Assim que o usuário envia a mensagem ativadora, o motor do gatilho captura os dados fornecidos publicamente pela API do Telegram, como o ID do Usuário (Chat ID), o Username (nome de usuário iniciado por @), o Primeiro Nome (First Name) e o Sobrenome (Last Name), disponibilizando essas variáveis imediatamente para uso nos próximos blocos.

  • Abertura de Janela de Comunicação Sem Restrições: Diferente de outros canais baseados em recargas ou templates aprovados (HSM), a ativação do gatilho do Telegram abre um canal de comunicação livre. A automação pode responder ao usuário com blocos de mensagens de qualquer formato e sem limites de tempo de sessão, desde que o bot não tenha sido bloqueado pelo usuário.

Exemplos Práticos

A tabela abaixo demonstra cenários de comportamento do gatilho de acordo com o status atual do usuário no sistema:

Bot Selecionado (Canal)

Status do Usuário no Painel

Ação do Usuário no Telegram

Comportamento do Gatilho

@Bot_Atendimento_Ficticio

Sem chamados abertos.

Clicou em "Começar" ou enviou um "Olá".

Dispara o fluxo: O gatilho captura o contato e inicia o menu do chatbot de autoatendimento.

@Bot_Suporte_Ficticio

Em atendimento com o Operador Daniel.

Enviou um arquivo de log ou mensagem de texto.

Ignora o gatilho: O conteúdo cai direto na tela do Daniel; a automação não interfere na conversa.

@Bot_Atendimento_Ficticio

Aguardando na Fila de Espera Geral.

Enviou a mensagem "Preciso de ajuda".

Ignora o gatilho: O contato permanece na fila de espera do painel humano, mantendo a prioridade de chegada original.

Atualizado

Isto foi útil?