Enviar mensagem · Telegram
Enviar mensagem usando a conexão Telegram deste workspace.
O que faz
Enviar mensagem usando a conexão Telegram deste workspace.
Quando usar: Use quando o seu fluxo precisar Enviar mensagem usando a conexão Telegram deste workspace..
Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.
Antes de começar
Conexão necessária: Conexão do workspace ou do canal.
Confirme que a integração ou o canal já está conectado no workspace.
Passo a passo
- Adicione Enviar mensagem · Telegram ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Confirme que a integração ou o canal já está conectado no workspace.
- Revise a ação principal descrita no cartão do bloco.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Enviar mensagem | Envia mensagem com o bloco Enviar mensagem · Telegram. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Enviar mensagem
- Padrão:
- Enviar mensagem
Bot do Telegram
Bots conectados em Integrações → Telegram. Com um bot só, ele é usado mesmo sem escolher.
- Exemplo:
- (escolha na lista do campo)
ID do chat
ObrigatórioComo obter o ID do chat: 1. Adicione o bot como membro do canal ou grupo 2. Envie qualquer mensagem no canal 3. Acesse https://api.telegram.org/bot<TOKEN>/getUpdates e copie o valor de chat.id.
- Exemplo:
- id-do-recurso
Mensagem
Obrigatório conforme a operaçãoInforma o texto que será processado pelo bloco.
- Aparece em:
- Enviar mensagem
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <enviarmensagemtelegram.ok>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<enviarmensagemtelegram.ok> | boolean | Indica se a API respondeu com sucesso. |
<enviarmensagemtelegram.result> | json | Objeto completo da mensagem retornado pela API do Telegram. |
<enviarmensagemtelegram.message> | string | Mensagem de sucesso ou de erro. |
<enviarmensagemtelegram.data> | json | Dados da resposta. |
<enviarmensagemtelegram.files> | file[] | Arquivos anexados à mensagem. |
<enviarmensagemtelegram.messageId> | number | ID da mensagem enviada. |
<enviarmensagemtelegram.chatId> | number | ID do chat em que a mensagem foi enviada. |
<enviarmensagemtelegram.chatType> | string | Tipo do chat (private, group, supergroup ou channel). |
<enviarmensagemtelegram.username> | string | Nome de usuário do chat (se houver). |
<enviarmensagemtelegram.messageDate> | number | Data e hora do envio da mensagem (timestamp Unix). |
<enviarmensagemtelegram.messageText> | string | Texto da mensagem enviada. |
<enviarmensagemtelegram.deleted> | boolean | Indica se a mensagem foi excluída com sucesso. |
<enviarmensagemtelegram.update_id> | number | Identificador único da atualização. |
<enviarmensagemtelegram.message_id> | number | Identificador único da mensagem recebida pelo webhook. |
<enviarmensagemtelegram.from_id> | number | ID do usuário que enviou a mensagem. |
<enviarmensagemtelegram.from_username> | string | Nome de usuário do remetente. |
<enviarmensagemtelegram.from_first_name> | string | Nome do remetente. |
<enviarmensagemtelegram.from_last_name> | string | Sobrenome do remetente. |
<enviarmensagemtelegram.chat_id> | number | Identificador único do chat. |
<enviarmensagemtelegram.chat_type> | string | Tipo do chat (private, group, supergroup ou channel). |
<enviarmensagemtelegram.chat_title> | string | Título do chat (para grupos e canais). |
<enviarmensagemtelegram.text> | string | Texto da mensagem recebida pelo webhook. |
<enviarmensagemtelegram.date> | number | Data de envio da mensagem (timestamp Unix). |
<enviarmensagemtelegram.entities> | json | Entidades especiais da mensagem (menções, hashtags etc.). |
Exemplo de uso
Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.
- Operação
- Enviar mensagem
- ID do chat
- id-do-recurso
- Bot do Telegram
- (escolha na lista do campo)
- Mensagem
- Olá! Sua solicitação foi processada com sucesso.
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <enviarmensagemtelegram.ok>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- ArquivoEnviar um documento pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- ÁudioEnviar um áudio pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Botões de açãoEnviar pelo WhatsApp (Z-API) uma mensagem com botões de abrir link, ligar ou copiar código.
- Catálogo e opçõesConsultar a instância Z-API ou enviar catálogo, botões de resposta e lista de opções.
- ContatoEnviar um cartão de contato pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Copiar mensagem · TelegramCopiar mensagem usando a conexão Telegram deste workspace.