Desafixar mensagem · Telegram
Desafixar mensagem usando a conexão Telegram deste workspace.
O que faz
Desafixar mensagem usando a conexão Telegram deste workspace.
Quando usar: Use quando o seu fluxo precisar Desafixar 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 Desafixar 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 |
|---|---|
| Desafixar mensagem | Desafixa mensagem com o bloco Desafixar mensagem · Telegram. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Desafixar mensagem
- Padrão:
- Desafixar 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
ID da mensagem
Obrigatório conforme a operaçãoIdentificador da mensagem alvo.
- Aparece em:
- Desafixar mensagem
- 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 <desafixarmensagemtelegram.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 |
|---|---|---|
<desafixarmensagemtelegram.ok> | boolean | Indica se a API respondeu com sucesso. |
<desafixarmensagemtelegram.result> | json | Objeto completo da mensagem retornado pela API do Telegram. |
<desafixarmensagemtelegram.message> | string | Mensagem de sucesso ou de erro. |
<desafixarmensagemtelegram.data> | json | Dados da resposta. |
<desafixarmensagemtelegram.files> | file[] | Arquivos anexados à mensagem. |
<desafixarmensagemtelegram.messageId> | number | ID da mensagem enviada. |
<desafixarmensagemtelegram.chatId> | number | ID do chat em que a mensagem foi enviada. |
<desafixarmensagemtelegram.chatType> | string | Tipo do chat (private, group, supergroup ou channel). |
<desafixarmensagemtelegram.username> | string | Nome de usuário do chat (se houver). |
<desafixarmensagemtelegram.messageDate> | number | Data e hora do envio da mensagem (timestamp Unix). |
<desafixarmensagemtelegram.messageText> | string | Texto da mensagem enviada. |
<desafixarmensagemtelegram.deleted> | boolean | Indica se a mensagem foi excluída com sucesso. |
<desafixarmensagemtelegram.update_id> | number | Identificador único da atualização. |
<desafixarmensagemtelegram.message_id> | number | Identificador único da mensagem recebida pelo webhook. |
<desafixarmensagemtelegram.from_id> | number | ID do usuário que enviou a mensagem. |
<desafixarmensagemtelegram.from_username> | string | Nome de usuário do remetente. |
<desafixarmensagemtelegram.from_first_name> | string | Nome do remetente. |
<desafixarmensagemtelegram.from_last_name> | string | Sobrenome do remetente. |
<desafixarmensagemtelegram.chat_id> | number | Identificador único do chat. |
<desafixarmensagemtelegram.chat_type> | string | Tipo do chat (private, group, supergroup ou channel). |
<desafixarmensagemtelegram.chat_title> | string | Título do chat (para grupos e canais). |
<desafixarmensagemtelegram.text> | string | Texto da mensagem recebida pelo webhook. |
<desafixarmensagemtelegram.date> | number | Data de envio da mensagem (timestamp Unix). |
<desafixarmensagemtelegram.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
- Desafixar mensagem
- ID do chat
- id-do-recurso
- Bot do Telegram
- (escolha na lista do campo)
- ID da mensagem
- id-do-recurso
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 <desafixarmensagemtelegram.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.