Typeform

  
## O que é
Uma integração simplesmente fantástica para ligar a sua conta Typeform ao seu Botpress Bot. Envie formulários aos utilizadores e receba um evento com as suas respostas quando estiverem concluídos.

## Como funciona
A ação `Send Typeform Link` pode ser usada para criar um novo link para o formulário que deseja usar. Ela requer um Id de Conversa e uma URL de Formulário. 

O `Conversation Id` é um identificador único para cada conversa. Pode passar para este campo para incorporar o seu ID. Quando receber um evento, pode utilizar nas opções avançadas o campo `Conversation ID` do `Typeform Event Trigger`. Isso enviará o evento para a conversa apropriada.

`Form URL` é a url do formulário que deseja utilizar. Pode encontrar o link em `Share` -> `Copy Link`. Certifique-se de que configurou o campo oculto da configuração do Typeform para passar o ID da conversa.

É possível ver o código de integração completo em: https://github.com/SimplyGreatBots/typeform

## Configuração do Typeform
1. Aceda à sua [Typeform Account] (https://admin.typeform.com/user) e clique em `Personal Access Tokens`.
2. Clique em `Generate New Token`, dê um nome ao seu token e clique em `Generate Token`.
3. Depois de o token ser criado, copie-o e guarde-o num local seguro. Prossiga para a configuração do site Botpress e retorne para as etapas finais.
4. Crie/abra o formulário que pretende integrar com o seu bot e clique em `Connect` no menu superior.
5. Selecione a opção Webhooks e clique em `Adicionar um Webhook`.
6. Cole o seu Botpress Typeform Webhook URL no campo `Endpoint` e clique em `Save Webhook`.
7. Clique em editar no seu novo Webhook e adicione o token de acesso do Typeform ao campo `Secret` e salve as alterações.
8. A etapa final é configurar um campo oculto no seu formulário com um ID de conversa. Clique em `Create` no formulário -> `Logic` -> `Personalize With Data` -> `Hidden Fields`.
9. Clique em `Adicionar novo campo` e dê-lhe um nome exato: `conversation_id`
10. Guarde e está agora preparado para utilizar a integração do Botpress Typeform.

## Botpress Configuração
1. Clique em `Install` no canto superior direito e seleccione o seu bot.
2. Clique no popup que aparece para configurar a sua integração.
3. Adicione o seu token de acesso ao Typeform no campo `Access Token`.
4. Active e guarde a integração.
5. Copie o URL Webhook para a integração. Ele será usado na Etapa 6. da configuração do Typeform.