Conecta-seEntrar na plataforma

Telegram

Ler e enviar mensagens, mídias e outras ações em bots e conversas do Telegram.

Integrações e ferramentasComunicaçãoConexão: Credencial protegida

O que faz

Integre o Telegram ao fluxo. Envie, edite, encaminhe, copie, fixe e exclua mensagens; envie mídias, localizações, contatos e enquetes; reaja a mensagens; mostre ações no chat (como "digitando..."); e consulte informações de chats e membros. Também pode ser usado no modo gatilho para iniciar um fluxo quando uma mensagem for enviada a um chat.

Quando usar: Use quando o seu fluxo precisar ler e enviar mensagens, mídias e outras ações em bots e conversas do Telegram.

Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Telegram ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. No Telegram, envie "/newbot" para o @BotFather para criar um bot e copie o token dele.
  2. Informe o token do bot acima.
  3. Depois que o fluxo for publicado, qualquer mensagem enviada ao seu bot vai disparar o fluxo.

Operações

OperaçãoO que faz
Enviar mensagemEnvia mensagem com o bloco Telegram.
Enviar fotoEnvia foto com o bloco Telegram.
Enviar vídeoEnvia vídeo com o bloco Telegram.
Enviar áudioEnvia áudio com o bloco Telegram.
Enviar animaçãoEnvia animação com o bloco Telegram.
Enviar documentoEnvia documento com o bloco Telegram.
Enviar localizaçãoEnvia localização com o bloco Telegram.
Enviar contatoEnvia contato com o bloco Telegram.
Enviar enqueteEnvia enquete com o bloco Telegram.
Enviar ação de chatEnvia ação de chat com o bloco Telegram.
Editar texto da mensagemEdita texto da mensagem com o bloco Telegram.
Encaminhar mensagemEncaminha mensagem com o bloco Telegram.
Copiar mensagemCopia mensagem com o bloco Telegram.
Excluir mensagemExclui mensagem com o bloco Telegram.
Fixar mensagemFixa mensagem com o bloco Telegram.
Desafixar mensagemDesafixa mensagem com o bloco Telegram.
Reagir à mensagemReage à mensagem com o bloco Telegram.
Obter chatObtém chat com o bloco Telegram.
Obter membro do chatObtém membro do chat com o bloco Telegram.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar mensagem · Enviar foto · Enviar vídeo · Enviar áudio · Enviar animação · Enviar documento · Enviar localização · Enviar contato · Enviar enquete · Enviar ação de chat · Editar texto da mensagem · Encaminhar mensagem · Copiar mensagem · Excluir mensagem · Fixar mensagem · Desafixar mensagem · Reagir à mensagem · Obter chat · Obter membro do chat
    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ório

    Como 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ção

    Informa o texto que será processado pelo bloco.

    Aparece em:
    Enviar mensagem, Editar texto da mensagem
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Foto

    Enviar foto.

    Aparece em:
    Enviar foto
    Exemplo:
    (selecione um arquivo de teste)

  • Foto

    Em campos adicionais

    Referencie um arquivo de um bloco anterior.

    Aparece em:
    Enviar foto

  • ID ou URL da foto

    Em campos adicionais

    Alternativa à foto. O próprio Telegram resolve este valor.

    Aparece em:
    Enviar foto
    Exemplo:
    cliente@exemplo.com

  • Vídeo

    Enviar vídeo.

    Aparece em:
    Enviar vídeo
    Exemplo:
    (selecione um arquivo de teste)

  • Vídeo

    Em campos adicionais

    Referencie um arquivo de um bloco anterior.

    Aparece em:
    Enviar vídeo

  • ID ou URL do vídeo

    Em campos adicionais

    Alternativa ao vídeo. O próprio Telegram resolve este valor.

    Aparece em:
    Enviar vídeo
    Exemplo:
    file_id do Telegram ou URL HTTP pública

  • Áudio

    Enviar áudio.

    Aparece em:
    Enviar áudio
    Exemplo:
    (selecione um arquivo de teste)

  • Áudio

    Em campos adicionais

    Referencie um arquivo de um bloco anterior.

    Aparece em:
    Enviar áudio

  • ID ou URL do áudio

    Em campos adicionais

    Alternativa ao áudio. O próprio Telegram resolve este valor.

    Aparece em:
    Enviar áudio
    Exemplo:
    file_id do Telegram ou URL HTTP pública

  • Animação

    Enviar animação (GIF).

    Aparece em:
    Enviar animação
    Exemplo:
    (selecione um arquivo de teste)

  • Animação

    Em campos adicionais

    Referencie um arquivo de um bloco anterior.

    Aparece em:
    Enviar animação

  • ID ou URL da animação

    Em campos adicionais

    Alternativa à animação. O próprio Telegram resolve este valor.

    Aparece em:
    Enviar animação
    Exemplo:
    file_id do Telegram ou URL HTTP pública

  • Documento

    Arquivo a enviar (PDF, ZIP, DOC etc.). Tamanho máximo: 50 MB.

    Aparece em:
    Enviar documento
    Exemplo:
    (selecione um arquivo de teste)

  • Documento

    Em campos adicionais

    Referencie um arquivo de documento de um bloco anterior.

    Aparece em:
    Enviar documento

  • Legenda

    Legenda da mídia (opcional).

    Aparece em:
    Enviar foto, Enviar vídeo, Enviar áudio, Enviar animação, Enviar documento, Copiar mensagem
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • ID da mensagem

    Obrigatório conforme a operação

    Identificador da mensagem alvo.

    Aparece em:
    Excluir mensagem, Editar texto da mensagem, Encaminhar mensagem, Copiar mensagem, Fixar mensagem, Desafixar mensagem, Reagir à mensagem
    Exemplo:
    id-do-recurso

  • ID do chat de origem

    Obrigatório conforme a operação

    ID do chat onde a mensagem original está.

    Aparece em:
    Encaminhar mensagem, Copiar mensagem
    Exemplo:
    id-do-recurso

  • Latitude

    Obrigatório conforme a operação

    Latitude do local que será enviado no Telegram, em graus decimais (ex.: -23.5505 para São Paulo).

    Aparece em:
    Enviar localização
    Exemplo:
    -23.5505

  • Longitude

    Obrigatório conforme a operação

    Longitude do local que será enviado no Telegram, em graus decimais (ex.: -46.6333 para São Paulo).

    Aparece em:
    Enviar localização
    Exemplo:
    -46.6333

  • Telefone

    Obrigatório conforme a operação

    Telefone do contato.

    Aparece em:
    Enviar contato
    Exemplo:
    +5511999999999

  • Nome

    Obrigatório conforme a operação

    Nome do contato.

    Aparece em:
    Enviar contato
    Exemplo:
    Exemplo de atendimento

  • Sobrenome

    Em campos adicionais

    Sobrenome do contato (opcional).

    Aparece em:
    Enviar contato
    Exemplo:
    Exemplo de atendimento

  • vCard

    Em campos adicionais

    Dados adicionais do contato em vCard (opcional).

    Aparece em:
    Enviar contato
    Exemplo:
    Dados adicionais do contato em vCard (opcional)

  • Pergunta da enquete

    Obrigatório conforme a operação

    Escreva a pergunta.

    Aparece em:
    Enviar enquete
    Exemplo:
    Escreva a pergunta

  • Opções da enquete

    Obrigatório conforme a operação

    Escreva cada opção de resposta em uma linha.

    Aparece em:
    Enviar enquete
    Exemplo:
    Uma opção por linha (2 a 10 opções)

  • Enquete anônima

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Enviar enquete
    Opções:
    Sim · Não
    Exemplo:
    Sim

  • Permitir várias respostas

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Enviar enquete
    Opções:
    Sim · Não
    Exemplo:
    Sim

  • Ação do chat

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Enviar ação de chat
    Opções:
    Digitando · Enviando foto · Gravando vídeo · Enviando vídeo · Gravando áudio · Enviando áudio · Enviando documento · Escolhendo figurinha · Buscando localização · Gravando videomensagem · Enviando videomensagem
    Padrão:
    Digitando

  • Emoji da reação

    Emoji usado como reação à mensagem, que precisa ser um dos aceitos pelo Telegram (ex.: 👍); deixe vazio para remover a reação.

    Aparece em:
    Reagir à mensagem
    Exemplo:
    👍

  • Reação grande

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Reagir à mensagem
    Opções:
    Sim · Não
    Exemplo:
    Sim

  • Fixar em silêncio

    Em campos adicionais

    Define se este comportamento fica ativado ou desativado.

    Aparece em:
    Fixar mensagem
    Opções:
    Sim · Não
    Exemplo:
    Sim

  • ID do usuário

    Obrigatório conforme a operação

    Informe o ID do usuário.

    Aparece em:
    Obter membro do chat
    Exemplo:
    id-do-recurso

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 <telegram.ok>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<telegram.ok>booleanIndica se a API respondeu com sucesso.
<telegram.result>jsonObjeto completo da mensagem retornado pela API do Telegram.
<telegram.message>stringMensagem de sucesso ou de erro.
<telegram.data>jsonDados da resposta.
<telegram.files>file[]Arquivos anexados à mensagem.
<telegram.messageId>numberID da mensagem enviada.
<telegram.chatId>numberID do chat em que a mensagem foi enviada.
<telegram.chatType>stringTipo do chat (private, group, supergroup ou channel).
<telegram.username>stringNome de usuário do chat (se houver).
<telegram.messageDate>numberData e hora do envio da mensagem (timestamp Unix).
<telegram.messageText>stringTexto da mensagem enviada.
<telegram.deleted>booleanIndica se a mensagem foi excluída com sucesso.
<telegram.update_id>numberIdentificador único da atualização.
<telegram.message_id>numberIdentificador único da mensagem recebida pelo webhook.
<telegram.from_id>numberID do usuário que enviou a mensagem.
<telegram.from_username>stringNome de usuário do remetente.
<telegram.from_first_name>stringNome do remetente.
<telegram.from_last_name>stringSobrenome do remetente.
<telegram.chat_id>numberIdentificador único do chat.
<telegram.chat_type>stringTipo do chat (private, group, supergroup ou channel).
<telegram.chat_title>stringTítulo do chat (para grupos e canais).
<telegram.text>stringTexto da mensagem recebida pelo webhook.
<telegram.date>numberData de envio da mensagem (timestamp Unix).
<telegram.entities>jsonEntidades especiais da mensagem (menções, hashtags etc.).

Exemplo de uso

Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.

InícioTelegrampróxima etapa
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 <telegram.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”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
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