Typeform

The source connector for Typeform allows you to stream form responses in near real time to the DataCater platform.


Configuration

This source connector supports the following configuration options:

Personal access token

The personal access token from your Typeform account. When creating a new token please make sure that the token has been assigned to the following scopes: read forms and read responses.

Workspace id

If you are managing different workspaces in Typeform, you may provide a workspace id here to only retrieve forms of a certain workspace.

Form id

The id of the form that shall be consumed. Given that the form is available under the URI https://[account_name].typeform.com/to/rddGwBRA the id would be rddGwBRA.

You may retrieve the list of forms available in your Typeform account by clicking on Fetch available forms.

Interval between requests

The interval in milliseconds between requests made by DataCater to the Typeform REST API to retrieve new responses that have been created since the last request (default: 60000).

Interval between requests, when catching up

The interval in milliseconds between requests made by DataCater to the Typeform REST API to retrieve new responses, when catching up because not all new responses could be retrieved at the previous request (default: 30000).


Attributes

When importing forms into DataCater, DataCater creates the following fixed attributes:

Attribute name DataCater data type Description
response_id String The id of the response, which is unique per form but not unique globally.
landed_at String The time when the user landed at the form. In ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time.
submitted_at String The time when the form response was submitted. In ISO 8601 format, UTC time, to the second, with T as a delimiter between the date and time.
metadata_user_agent String The user agent of the user.
metadata_platform String The platform of the user, derived from the user agent.
metadata_referer String The referer URI.
metadata_network_id String The IP of the user.
metadata_browser String The browser of the user.

In addition to the fixed attributes, DataCater creates one attribute for each question of the form. DataCater uses the Question reference of each question as the attribute name. By default, question references are randomly-generated alphanumeric values. However, after the first publishing of your form, you may change the question references to custom values to allow a better identification of attributes in DataCater. The data type of the attribute in DataCater depends on the type of the question in Typeform:

Typeform question type DataCater data type
Multiple Choice List[String]
Phone Number String
Short Text String
Long Text String
Statement Ignored, no attribute will be created.
Picture Choice List[String]
Yes/No Boolean
Opinion Scale Long
Rating Long
Date String
Number Long
Dropdown String
Legal Boolean
File Upload String
Payment String
Website String