Typeform Integration

Vixiees integrates with Typeform to automatically capture leads from forms.

Connecting Typeform

Requirements

Typeform account with forms created
Administrator permissions in Vixiees

Steps to Connect

Go to Settings > Integrations > Typeform
Click Connect with Typeform
Log in to your Typeform account
Authorize the requested permissions
Your forms will be synchronized automatically

Data Synchronized

When connecting, Vixiees retrieves:

List of forms
Fields of each form (regular and hidden)
Form metadata

Configuring Forms

Field Mapping

Select the form from the list
For each field, choose the corresponding contact attribute
Map email or phone (required)
Configure Sales Brain (Playbook) and initial stage
Save changes

Required Fields

Each form must have at least one of the following mapped:

Email or
Phone

Without these fields, leads will be ignored.

Lead Capture

Automatic Flow

When a user completes a Typeform form:

Typeform sends the data to Vixiees via webhook
Vixiees looks up or creates the contact
The configured field mapping is applied
The contact is assigned to the indicated Sales Brain (Playbook)
The contact becomes available for the team

Supported Field Types

Typeform Type	Processing
Text	Direct value
Email	Contact email
Phone	Contact phone
Single choice	Selected label
Multiple choice	Array of labels
Date	Converted to date

UTM Data and Tracking

Typeform allows sending hidden fields that are not shown to the user.

Common Hidden Fields

Field	Use
utm_source	Traffic source
utm_medium	Campaign medium
utm_campaign	Campaign name
utm_content	Ad variant
utm_term	Keyword

How to Configure

In Typeform, add hidden fields to the form
In Vixiees, map these fields to custom attributes
Values will be captured automatically from the URL

Example URL

javascript

https://yourform.typeform.com/to/ABC123?utm_source=google&utm_campaign=summer2024

Webhooks

Automatic Configuration

When connecting Typeform, Vixiees automatically configures webhooks for each form.

Captured Events

form_response: Form completed
form_response_partial: Partial response (optional)

Security

Webhooks are verified with HMAC-SHA256 signature to ensure authenticity.

Form History

Each submission is recorded in the contact:

Submission date and time
Form used
Complete responses
Captured hidden fields

Existing Contacts

If the contact already exists:

Their data is updated
The new submission is recorded
If they were in a closed state, they can be reassigned

Conclusion

The Typeform integration allows you to:

Capture leads automatically
Map fields flexibly
Capture UTM data for tracking
Keep a complete form history

Relevant Scenarios

Landing pages: Capture forms connected to Vixiees
Campaign tracking: Use hidden fields to identify the source
Lead qualification: Map responses to custom attributes