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
- Go to your Typeform Account and click on
Personal Access Tokens
. - Click on
Generate New Token
, name your token, and clickGenerate Token
. - 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.
- Create/Open the form that you wish to integrate with your bot and click
Connect
in the top menu. - Select the Webhooks option and click
Add a Webhook
. - Paste your Botpress Typeform Webhook URL into
Endpoint
field and clickSave Webhook
. - Click edit on your new Webhook and add Typeform Access token to the
Secret
field and save changes. - 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
. - Click
Add new field
and name it exactly:conversation_id
- Save and you are now setup to use the Botpress Typeform integration.
Botpress Setup
- Click
Install
on the top right and select your bot. - Click the popup that appears to configure your integration.
- Add your Typeform access token to the
Access Token
field. - Enable and save the integration.
- Copy your Webhook URL for the integration. This will be used in Step 6. of the Typeform setup.