Mensagem do Telegram

1. Visão Geral

O Componente de Envio de Mensagem do Telegram (identificado na interface como telegram_message) é um nó de ação outbound focado na transmissão de conteúdo. Sua função principal é injetar e-mails, alertas, textos informativos ou arquivos de mídia diretamente no chat privado do usuário que interage com o bot do Telegram. Ele é utilizado para guiar conversas de forma linear, entregar materiais de marketing ou emitir avisos de transações sem reter o usuário em validações de resposta.

2. Parâmetros de Configuração

A parametrização do bloco estabelece as diretrizes do formato e o conteúdo do balão de mensagem que o cliente receberá:

• Tipo de mensagem: Menu suspenso utilizado para escolher a categoria de payload que o robô transmitirá. As opções mapeadas incluem:

  • Texto: Mensagens compostas puramente por strings de texto plano, suportando formatações simples de emojis e links.

  • Áudio: Envio de arquivos sonoros ou recados de voz em formatos compatíveis com o Telegram.

  • Imagem: Envio de mídias gráficas, banners corporativos ou fotos promocionais (PNG, JPG).

  • Vídeo: Compartilhamento de arquivos audiovisuais assistíveis de forma nativa no player do aplicativo (MP4).

• Mensagem (* Campo Obrigatório se Texto): O corpo principal do texto que será enviado ao cliente no chat.

• URL do arquivo (* Obrigatório para mídias): Disponibilizado quando selecionadas as opções Imagem, Áudio ou Vídeo. Permite colar o endereço HTTP/HTTPS público do arquivo ou realizar o carregamento via botão de Upload.

3. Construtor Visual

A interface gráfica adapta seus campos de forma condicional conforme a opção escolhida no parâmetro Tipo de mensagem:

• Layout de Texto Simplificado: Ao trabalhar no modo Texto, a interface isola apenas a caixa de digitação Mensagem, exigindo o preenchimento de conteúdo (*) para que o nó possa ser salvo.

• Layout de Mídias Avançado: Ao alternar para o modo Imagem, a caixa de texto longa é substituída pelo campo URL do arquivo e o botão roxo de Upload, que permite arrastar arquivos diretamente do computador do administrador do fluxo para os servidores da plataforma.

4. Operadores Especiais

As propriedades lógicas deste componente gerenciam a interpolação de strings dinâmicas e o processamento de entrega assíncrona:

• Interpolação de Tags por Chaves Duplas: O campo Mensagem é totalmente compatível com a inserção de metadados salvos no contato utilizando a sintaxe {{...}}. Isso permite personalizar avisos ativos de forma individualizada (ex: "Seu boleto vence amanhã, {{nome}}!").

• Processamento Assíncrono sem Estado de Standby: Diferente do nó de pergunta do Telegram, este componente não gera pausa de execução na jornada. O motor da plataforma envia a requisição de postagem para os servidores da API do Telegram e libera o contato imediatamente para o próximo bloco conectado ao nó.

5. Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para abastecer fluxos de conversação no Telegram:

Tipo de Mensagem Selecionado	URL do Arquivo / Upload	Conteúdo Configurado (Mensagem)	Caso de Uso Prático
Texto	Nenhum	"Seja bem-vindo ao canal oficial de suporte! 🤖"	Disparar uma saudação inicial instantânea assim que o contato ativa o bot por um gatilho receptivo.
Imagem	Upload de comprovante.png	Nenhum	Exibir um infográfico explicativo com o passo a passo de um produto logo após o lead escolher uma opção de menu.
Texto	Nenhum	"Aguarde um momento, {{nome}}. Estamos transferindo seu atendimento para a fila do setor de {{setor_escolhido}}..."	Mostrar um aviso de transição dinâmico antes de acionar o componente de transferência humana.