Typeform

  
## Wat het is
Een geweldige integratie om je Typeform-account te koppelen aan je Botpress Bot. Stuur formulieren naar gebruikers en ontvang een event met hun antwoorden als ze zijn ingevuld.

## Hoe het werkt
De actie `Stuur Typeform Link` kan worden gebruikt om een nieuwe link te maken naar het formulier dat je wilt gebruiken. Hiervoor zijn een conversie-ID en een formulier-URL nodig. 

De `Conversation Id` is een unieke identifier voor elke conversatie. Je kunt dit veld gebruiken om je id in te sluiten. Wanneer je een gebeurtenis ontvangt, kun je in de geavanceerde opties het veld `gesprek-id` van de `Typeform Event Trigger` gebruiken. Hierdoor wordt de gebeurtenis naar de juiste conversatie gestuurd.

`Form URL` is de url van het formulier dat je wilt gebruiken. Je kunt de link vinden onder `Delen` -> `Kopiëren Link`. Zorg ervoor dat je het verborgen veld van de Typeform-instelling hebt ingesteld om de conversatie-id door te geven.

U kunt de volledige integratiecode bekijken op: https://github.com/SimplyGreatBots/typeform

## Typeform instellen
1. Ga naar uw [Typeform Account] (https://admin.typeform.com/user) en klik op `Personal Access Tokens`.
2. Klik op `Nieuw token genereren`, geef uw token een naam en klik op `Token genereren`.
3. Nadat het token is aangemaakt, kopieert u het en slaat u het op een veilige locatie op. Ga verder met het instellen van Botpress en kom dan terug voor de laatste stappen.
4. Maak/open het formulier dat u wilt integreren met uw bot en klik op `Connect` in het bovenste menu.
5. Selecteer de optie Webhooks en klik op `Een Webhook toevoegen`.
6. Plak uw Botpress Typeform Webhook URL in het `Endpoint` veld en klik op `Opslaan Webhook`.
7. Klik op bewerken op uw nieuwe Webhook en voeg Typeform Toegangstoken toe aan het veld `Geheim` en sla de wijzigingen op.
8. De laatste stap is het instellen van een verborgen veld in je formulier met een conversatie-id. Klik op `Creëer` in het formulier -> `Logica` -> `Personaliseren met gegevens` -> `Verborgen velden`.
9. Klik op `Nieuw veld toevoegen` en geef het een exacte naam: `conversation_id`.
10. Sla op en u bent nu klaar om de Botpress Typeform integratie te gebruiken.

## Botpress Instelling
1. Klik rechtsboven op `Installeren` en selecteer je bot.
2. Klik op de popup die verschijnt om je integratie te configureren.
3. Voeg je Typeform toegangstoken toe aan het `Access Token` veld.
4. Schakel de integratie in en sla deze op.
5. Kopieer uw Webhook URL voor de integratie. Deze wordt gebruikt in Stap 6. van de Typeform setup.