Integration
To integrate Typeform into CamBuildr a Webhook has to be added to the created form. This Webhook is triggered each time someone completes the typeform and sends data to the Cambuildr.
In the Form view, click the 'Connect' Tab, then 'Webhooks' and finally the button 'Add a webhook' (see screenshot):
In the popup, the Webhook URL, that defines where the data will be sent, has to be entered. This is a CamBuildr endpoint and can be located in your CamBuildr (Information > Interfaces). Your URL will look similar to the one in the screenshot:
After adding the URL you need to enable the Webhook, as it is disabled by default, and you are ready to go.
Basic Configuration
CamBuildr always requires an email address to be able to store data. Thus, exactly one of the answers in your typeform needs to be of type 'Email', otherwise no data will be stored in CamBuildr:
CamBuildr Action
For every person that completes the typeform, an action in the CamBuildr is set. By default the action has the following properties:
name: submitted
source: Typeform-{Form-ID}
vendor: Typeform
The following screenshot shows the default action in the action overview of a person:
It is possible to overwrite name and source (and define a context) by appending the respective query parameter to the Webhook URL, for instance:
https://demo.cambuildr.com/api/v1/hooks/typeform?action=my_action&source=my_source&context=my_context
Extended Configuration
Custom Fields
The user input of specific questions can be stored in custom fields of CamBuildr.
For this to work, a custom field needs to exist, whose name can be found in the text of one of the typeform questions. If this is the case, the answer is stored into this custom field. We would suggest to use the complete text of the typeform question as custom field name.
As an example, we created a question "How satisfied are you?" and created a custom field with exactly that name in the CamBuildr. After completing the typeform, the participant now has his answer set in the custom field:
If the typeform field accepts multiple values, these values are stored in the custom field comma-separated.
Tags
To set specific tags to all people that complete a typeform, the query parameter person_tags can be appended to the Webhook URL (can also contain a list of comma separated tags):
https://demo.cambuildr.com/api/v1/hooks/typeform?person_tags=tag1,tag2
Action Value
If a 'score' is passed from the typeform, this score is stored as 'value' for the created CamBuildr action.