## What it is
A simply great integration to connect your Typeform account to your Botpress Bot. Send forms to users and receive an event with their responses when they are completed.
## How it works
The `Send Typeform Link` action can be used to create a new link to the form you wish to use. It requires a Conversation Id and Form URL.
`Conversation Id` is a unique identifier for each conversation. You can pass into this field to embed your id. When receiving an Event you can use in the Advanced Options `Conversation ID` field of the `Typeform Event Trigger`. This will push the event to the appropriate conversation.
`Form URL` is url of the form you wish to use. You can find the link under `Share` -> `Copy Link`. Ensure that you have setup the hidden field from the Typeform setup to pass the conversation id.
You can see the full integration code at: https://github.com/SimplyGreatBots/typeform
## Typeform Setup
1. Go to your [Typeform Account](https://admin.typeform.com/user) and click on `Personal Access Tokens`.
2. Click on `Generate New Token`, name your token, and click `Generate Token`.
3. After the token is created, copy, and save it in a safe location. Proceed to the Botpress set up and then return for the final steps.
4. Create/Open the form that you wish to integrate with your bot and click `Connect` in the top menu.
5. Select the Webhooks option and click `Add a Webhook`.
6. Paste your Botpress Typeform Webhook URL into `Endpoint` field and click `Save Webhook`.
7. Click edit on your new Webhook and add Typeform Access token to the `Secret` field and save changes.
8. The final step is to setup a hidden field in your form with a conversation id. Click `Create` in the form -> `Logic` -> `Personalize With Data` -> `Hidden Fields`.
9. Click `Add new field` and name it exactly: `conversation_id`
10. Save and you are now setup to use the Botpress Typeform integration.
## Botpress Setup
1. Click `Install` on the top right and select your bot.
2. Click the popup that appears to configure your integration.
3. Add your Typeform access token to the `Access Token` field.
4. Enable and save the integration.
5. Copy your Webhook URL for the integration. This will be used in Step 6. of the Typeform setup.
