> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpressbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Typeform

> Send a WhatsApp message when someone submits a Typeform.

## What is this?

The **Typeform** integration messages people on WhatsApp right after they fill in one of your Typeforms — for example *Thanks for your enquiry, we'll be in touch*. Each connection watches **one form**.

## What can I do here?

* Send a WhatsApp template when a form is submitted
* Connect several forms, each with its own message
* See every submission Typeform sent, including failures
* Have every submission checked with a signature the platform generates

## How to use it

**1. Open the Typeform page**

Go to **Integrations**, click **Typeform**, then **Connect**.

**2. Enter your Typeform details**

1. Paste your **Typeform personal access token** (in Typeform under **Account → Personal tokens**).
2. Enter the **Typeform form ID or link** of the form to watch, for example `https://yourname.typeform.com/to/AbC123`.

**3. Choose your messages**

Pick the WhatsApp template to send when the form is submitted:

| Event | When it happens |
| - | - |
| **Form submitted** | Someone submits the form |

Leave an event empty to send nothing for it.

**4. Set up and activate**

Click **Set up and activate**. The platform registers the webhook with Typeform for you and creates a ready-made automation that sends the right template for each event. You can open that automation in the builder any time.

## Things to know

* **The customer's phone number** is taken from a **Phone Number** question, a hidden field called `phone`, or a text answer to a question about a phone number. The name comes from a hidden field called `name`, or the first short-text answer to a name question. Make sure your form asks for a phone number — submissions without one can't be messaged.
* **Repeats are ignored.** If Typeform sends the same event twice, the customer isn't messaged twice.
* **One connection per form.** To watch another form, connect Typeform again with that form's ID.

## Troubleshooting / Technical Notes

* **Connecting fails.** Check the details you entered and that they belong to the right Typeform account. The error from Typeform is shown on the page.

* **No messages are sent.** Check the connection shows **Connected**, a template is chosen for the event, and the template is approved.

* **A request shows as failed.** Open the connection's **Activity** tab and select the request to see the error and its raw body. A missing phone number is the most common cause.

* **Webhooks look missing.** On the connection page, click **Verify on Typeform** to check they are still registered. If any are missing, disconnect and reconnect to register them again.

* **You rotated your key or token.** Open the connection's **Settings** tab and update the credentials.

## Related docs

* [Integrations Overview](https://docs.xpressbot.org/workspace/integrations/overview.md)
* [Webhooks](https://docs.xpressbot.org/workspace/integrations/webhooks.md)
* [Templates](https://docs.xpressbot.org/workspace/whatsapp/templates.md)
* [Automation Overview](https://docs.xpressbot.org/workspace/automation/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.