## 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.
