Este artigo explica como integrar o Yay! Forms com o Telegram para que você receba notificações sempre que novas respostas forem enviadas.
Configuração da Integração com o Telegram
Para configurar a integração com o Telegram, siga os passos abaixo:
-
Abra o formulário desejado
-
Clique na aba Integrar
-
Role a página até a integração do Telegram
-
Clique em Configurar
Etapa 1: Conecte sua Conta do Telegram
Antes de receber notificações, você precisa conectar ou selecionar uma conta do Telegram.
Selecionar uma Conta Existente
Se você já possui contas do Telegram conectadas, selecione uma delas no dropdown.
Conectar uma Nova Conta
Para adicionar uma nova conta do Telegram, clique em Configurações de Telegram e preencha os campos abaixo.
Nome da Conta
Utilize um nome amigável para identificar a conta.
Exemplo:
Rafael Girao
Chat ID
O Chat ID define para qual conversa do Telegram as notificações serão enviadas.
Para obtê-lo:
-
Clique aqui para enviar uma mensagem e obter seu Chat ID
-
Envie a mensagem solicitada para o bot do Telegram
-
Copie o número retornado
-
Cole no campo Chat ID
Exemplo:
123456789
Código de Verificação
Este código é usado para confirmar a conexão da conta do Telegram.
-
Insira o código de verificação recebido no seu chat do Telegram
-
Se você deixar este campo em branco e clicar em Salvar, um novo código será enviado automaticamente
Exemplo:
98765432
Após salvar, a conta ficará disponível no dropdown de seleção de contas.
Etapa 2: Assunto (Opcional)
Utilize este campo para definir o assunto da mensagem enviada pelo Telegram.
Você pode:
-
Inserir um texto fixo, ou
-
Utilizar placeholders para personalizar o assunto dinamicamente
Exemplo:
Nova resposta do seu formulário {{form.title}}
Os placeholders permitem inserir dados dinâmicos, como:
-
Título do formulário
-
Valores dos campos
-
Detalhes da resposta
Para mais informações, consulte o Guia de Placeholders para Personalização de E-mails e Mensagens.
Etapa 3: Condição de Disparo (Opcional)
Opcionalmente, você pode definir uma condição de disparo para controlar quando a notificação do Telegram será enviada.
Para configurar:
-
Clique em Adicionar condição de disparo
-
Defina uma regra que determine quando os dados devem ser enviados
Condição de Disparo sem Diferenciação de Maiúsculas e Minúsculas
Ative a opção Condição de disparo sem distinção entre maiúsculas e minúsculas se desejar ignorar diferenças de capitalização.
Quando ativada, os valores abaixo serão tratados como iguais:
-
Aceito
-
aceito
-
ACEITO
Isso ajuda a garantir um comportamento consistente, independentemente de como os usuários preencham os campos do formulário.
Gerenciando a Integração
Após a configuração, você pode gerenciar a integração da seguinte forma:
-
Ativar ou desativar usando o botão de status
-
Editar a configuração a qualquer momento
-
Testar a integração pelo menu de três pontos (⋮)
Observações Importantes
Preenchimento do Formulário
- O formulário deve ter pelo menos uma resposta válida para que o teste funcione
Envio de Dados
- Os testes utilizam os dados da resposta válida mais recente
Status de Envio
-
Executar um teste não marca a resposta como enviada
-
Os testes servem apenas para verificar se a integração está funcionando corretamente
Suporte
Se você tiver dúvidas ou sugestões, entre em contato pelo e-mail:
Conclusão
Agora você sabe como:
-
Conectar e gerenciar contas do Telegram
-
Configurar o assunto das mensagens com placeholders
-
Aplicar condições de disparo
-
Ativar, desativar e testar a integração com o Telegram
Essa configuração garante que você receba notificações no Telegram exatamente quando precisar.