Conecta-seEntrar na plataforma

Enviar contato · Telegram

Enviar contato usando a conexão Telegram deste workspace.

Integrações e ferramentasComunicaçãoConexão: Conexão do workspace ou do canal

O que faz

Enviar contato usando a conexão Telegram deste workspace.

Quando usar: Use quando o seu fluxo precisar Enviar contato 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

  1. Adicione Enviar contato · Telegram ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Confirme que a integração ou o canal já está conectado no workspace.
  3. Revise a ação principal descrita no cartão do bloco.
  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.

Operações

OperaçãoO que faz
Enviar contatoEnvia contato com o bloco Enviar contato · Telegram.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar contato
    Padrão:
    Enviar contato

  • 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

  • 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)

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 <enviarcontatotelegram.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
<enviarcontatotelegram.ok>booleanIndica se a API respondeu com sucesso.
<enviarcontatotelegram.result>jsonObjeto completo da mensagem retornado pela API do Telegram.
<enviarcontatotelegram.message>stringMensagem de sucesso ou de erro.
<enviarcontatotelegram.data>jsonDados da resposta.
<enviarcontatotelegram.files>file[]Arquivos anexados à mensagem.
<enviarcontatotelegram.messageId>numberID da mensagem enviada.
<enviarcontatotelegram.chatId>numberID do chat em que a mensagem foi enviada.
<enviarcontatotelegram.chatType>stringTipo do chat (private, group, supergroup ou channel).
<enviarcontatotelegram.username>stringNome de usuário do chat (se houver).
<enviarcontatotelegram.messageDate>numberData e hora do envio da mensagem (timestamp Unix).
<enviarcontatotelegram.messageText>stringTexto da mensagem enviada.
<enviarcontatotelegram.deleted>booleanIndica se a mensagem foi excluída com sucesso.
<enviarcontatotelegram.update_id>numberIdentificador único da atualização.
<enviarcontatotelegram.message_id>numberIdentificador único da mensagem recebida pelo webhook.
<enviarcontatotelegram.from_id>numberID do usuário que enviou a mensagem.
<enviarcontatotelegram.from_username>stringNome de usuário do remetente.
<enviarcontatotelegram.from_first_name>stringNome do remetente.
<enviarcontatotelegram.from_last_name>stringSobrenome do remetente.
<enviarcontatotelegram.chat_id>numberIdentificador único do chat.
<enviarcontatotelegram.chat_type>stringTipo do chat (private, group, supergroup ou channel).
<enviarcontatotelegram.chat_title>stringTítulo do chat (para grupos e canais).
<enviarcontatotelegram.text>stringTexto da mensagem recebida pelo webhook.
<enviarcontatotelegram.date>numberData de envio da mensagem (timestamp Unix).
<enviarcontatotelegram.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ícioEnviar contato · Telegrampróxima etapa
Operação
Enviar contato
ID do chat
id-do-recurso
Bot do Telegram
(escolha na lista do campo)
Telefone
+5511999999999
Nome
Exemplo de atendimento

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 <enviarcontatotelegram.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