Typeform

Atualizado 24/2/21 por Aline Alberguini

A integração com o Typeform permite o mapeamento de resposta de usuários específicos.

Para que a integração aconteça, é necessário que você configure alguns campos do Typeform. De início, é necessário que sua empresa tenha uma conta dedicada na plataforma Typeform.

Configuração da integração

  1. Configuração dos campos ocultos:

Depois que o cliente tiver criado o formulário no Typeform, o primeiro passo para que a integração tenha sucesso é a configuração dos campos ocultos. 

Veja a seguir como configurar os campos ocultos.

Dentro do Typeform, no momento da configuração do seu formulário, clique no ícone de adição (+), e selecione Campos Ocultos (Hidden Fields), como na imagem abaixo:

Agora inclua os seguintes campos: name, username, id, email, provisioning_id e session_id.

  1. Habilitar webhook:

A segunda etapa para que a integração ocorra é a conexão via webhook. Você precisa configurar aquele formulário para submeter suas respostas para o Heartbeat do Skore 3. Para isto, basta entrar no formulário, seguindo o caminho: CONNECT > WEBHOOKS > Add a webhook, inserir este URL no campo:

https://knowledge.skore.io/integration/v1/survey/typeform/events?key=0000, salvar e habilitar o webhook.

Nós fornecemos o link acima para que ele possa ser inserido no webhook. Para a configuração do URL, no final o key=0000 deve ser substituído pelo company id. Exemplo: se o company id for 1234, então o final do URL deve ser alterado para key=1234. Caso você não saiba o company ID da sua empresa, é só enviar um e-mail para support@skore.io e nós te diremos. 

  1. Com este passo concluído, a API de provisionamento já está habilitada para enviar para o Typeform os dados no URL que preenchem os campos ocultos, isto é quem foi o usuário e qual o conteúdo respondido.
  2. Adicionar o link de um conteúdo Typeform no Skore é muito simples! Basta adicionar um conteúdo do tipo link e a integração acontece, considerando todos os passos anteriores já devidamente configurados. 
Ao copiar o link do Typeform para compartilhá-lo, ele virá com os hidden fields preenchidos com 'xxxx' no URL. Essa parte toda não é necessária ao adicionar o link no Skore. Assim, basta adicionar o URL até o ponto de interrogação. por exemplo: https://skore.typeform.com/to/abcde

Como funciona a integração?

Uma vez que o Skore estiver integrado com a sua conta no Typeform, basta que você insira o link do formulário conforme explicado acima e ele já vai ser reconhecido pela API de provisionamento.

Quando a API de provisionamento entregar o conteúdo para o player, ela já vai entregar o formulário com os campos ID, nome, email preenchidos, assim você consegue mapear quem foram os usuários que responderam o formulário.

Cuidados

  • A integração só vai funcionar corretamente se cada formulário do Typeform for inserido em um único conteúdo no Skore. Ou seja, não insira o link do mesmo formulário em diversos conteúdos do Skore.
  • Não é uma boa prática substituir um conteúdo já existente no Skore pelo link do formulário. Sempre que criar um novo formulário no Typeform, adicione-o em um novo conteúdo no Skore.


O que você achou desse artigo? Gostou?


Powered by HelpDocs (opens in a new tab)