Typeform

  
## Ce que c'est
Une intégration tout simplement géniale pour connecter votre compte Typeform à votre Botpress Bot. Envoyez des formulaires aux utilisateurs et recevez un événement avec leurs réponses lorsqu'ils sont complétés.

## Comment ça marche
L'action `Send Typeform Link` peut être utilisée pour créer un nouveau lien vers le formulaire que vous souhaitez utiliser. Elle nécessite un identifiant de conversation et une URL de formulaire. 

`Conversation Id` est un identifiant unique pour chaque conversation. Vous pouvez passer dans ce champ pour intégrer votre identifiant. Lorsque vous recevez un événement, vous pouvez utiliser dans les options avancées le champ `Conversation ID` du `Typeform Event Trigger`. Ceci poussera l'événement vers la conversation appropriée.

`Form URL` est l'url du formulaire que vous souhaitez utiliser. Vous pouvez trouver le lien sous `Share` -> `Copy Link`. Assurez-vous que vous avez configuré le champ caché de la configuration de Typeform pour passer l'identifiant de la conversation.

Vous pouvez voir le code d'intégration complet sur : https://github.com/SimplyGreatBots/typeform

## Configuration de Typeform
1. Allez sur votre [Compte Typeform] (https://admin.typeform.com/user) et cliquez sur `Personal Access Tokens`.
2. Cliquez sur `Generate New Token`, nommez votre token, et cliquez sur `Generate Token`.
3. Une fois le token créé, copiez-le et sauvegardez-le dans un endroit sûr. Passez à l'installation de Botpress et revenez pour les étapes finales.
4. Créez/Ouvrez le formulaire que vous souhaitez intégrer à votre bot et cliquez sur `Connect` dans le menu du haut.
5. Sélectionnez l'option Webhooks et cliquez sur "Add a Webhook".
6. Collez votre Botpress Typeform Webhook URL dans le champ `Endpoint` et cliquez sur `Save Webhook`.
7. Cliquez sur edit sur votre nouveau Webhook et ajoutez le jeton d'accès Typeform dans le champ `Secret` et sauvegardez les changements.
8. La dernière étape consiste à créer un champ caché dans votre formulaire avec un identifiant de conversation. Cliquez sur `Create` dans le formulaire -> `Logic` -> `Personalize With Data` -> `Hidden Fields`.
9. Cliquez sur `Add new field` et nommez le exactement : `conversation_id`
10. Sauvegardez et vous êtes maintenant prêt à utiliser l'intégration de Botpress Typeform.

## Botpress Configuration
1. Cliquez sur `Install` en haut à droite et sélectionnez votre bot.
2. Cliquez sur le popup qui apparaît pour configurer votre intégration.
3. Ajoutez votre jeton d'accès Typeform dans le champ "Jeton d'accès".
4. Activez et enregistrez l'intégration.
5. Copiez votre URL Webhook pour l'intégration. Elle sera utilisée à l'étape 6 de la configuration de Typeform.