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