Como integrar com a Typeform?

Aprenda a realizar a integração do Notificações Inteligentes e a Typeform

Como configurar a integração?

Precisamos de informações básicas para funcionar! Tenha em todos os formulários o campo de telefone, nome e e-mail como requeridos. Sem eles, nós não conseguimos trabalhar, ok?

Dentro do Notificações Inteligentes

Para criar a integração, acesse a sua conta do Notificações Inteligentes e clique em Lojas:



Na página, clique em Criar loja:



Em seguida, na opção Descrição, é possível dar um apelido para a integração criada:



Na Plataforma, selecione a opção com o nome da integração, na categoria Plataforma de formulário, como demonstrado na imagem abaixo.



Com isso, você irá chegar na tela de configuração da loja, onde irá pedir algumas credenciais necessárias para o funcionamento da integração:



Dentro da Typeform:

Na página inicial da Typeform, clique no seu ícone no canto direito superior e selecione a opção Your settings:



Agora basta você selecionar a opção Personal tokens e no canto direito superior selecionar a opção Generate a new token:



Com isso, irá abrir uma janela para você adicionar um nome para a token e adicionar os escopos da token:



Após selecionar a opção Custom scopes, basta aceitar os seguintes escopos e clicar em Generate token:



Assim que você clicar em Generate token sua token irá ser gerada, salve ela, pois não é possível ter acesso depois:



Agora iremos pegar o id do formulário, para isso:

Abra o formulário que deseja integrar com o Notificações Inteligentes, e na URL dele irá ter seu id, conforme imagem:



Com as credenciais necessárias em mão, basta voltarmos ao Notificações Inteligentes e configuramos a loja:



Após adicionar as credenciais, basta clicar em Reconfigurar!

Para que sua integração funcione da maneira correta, serão necessários os dados nome, e-mail e telefone:

- Você pode optar por escolher o template de Contact Info:



- Ou pode optar por adicionar um campo do tipo Short Text, nesse caso, o nome do campo deverá ser obrigatoriamente alguma dessas opções: Primeiro nome e Último nome, Nome ou First name e Last name. Caso opte por essa opção, você deverá também adicionar os campos de Email e Phone number (o nome do campo é da sua preferência nesse caso):



Pronto! Sua integração foi feita com sucesso! Agora vamos começar a receber os eventos e, consequentemente, enviar as notificações.

Como sei que deu certo?

Quer conferir se a integração do Notificações Inteligentes foi feita de maneira certa? Então, veja como você pode fazer a confirmação, seguindo estas etapas:

Verifique o checklist dentro da sua loja

Temos um checklist que te ajuda a entender se todas as configurações necessárias para o envio das notificações foram feitas.

Você consegue ter um exemplo do checklist logo abaixo:



Se todas as opções estiverem na cor verde, quer dizer que você fez todos os passos. Então, provavelmente, as notificações já devem estar sendo enviadas.

Acompanhe a tela de relatórios

Na tela de relatórios, seja da integração ou da instância, você consegue ter uma ideia geral das notificações que estão sendo enviadas.

Caso não saiba onde fica esta tela, acesse este artigo para saber como verificar os relatórios.


Verifiquei todos os passos acima e mesmo assim acredito que não esteja funcionando

Nesse caso, temos um checklist mais detalhado que você consegue ver aqui.

Quando as notificações serão disparadas?

Como essa é uma integração instantânea, assim que a plataforma nos enviar as informações, iremos processar e agendar a mensagem na fila de envios. Caso você não saiba o que é uma fila de envios, clique aqui.


Limite de Requisições da API

A API dessa integração tem limites definidos pela plataforma, o que faz com que o processamento precise ser mais lento. Por conta disso, algumas notificações podem acabar sendo perdidas.

Os limites são:
- 2 requisições a cada segundo.

Após exceder este limite, não iremos conseguir enviar as notificações corretamente, lembre-se que é uma limitação da plataforma integrada, e não do Notificações Inteligentes.

Atualizado em: 25/09/2024