# Attentive

Integrating Zigpoll with Attentive automatically pushes survey responses into Attentive as a custom event and profile attributes — and can optionally subscribe respondents to your Attentive marketing. Use this to trigger journeys, build segments, and personalize SMS/email based on real customer feedback.

***

### Step 1: Get Your Attentive API Key

1. Log into your Attentive account.
2. Create a **private API key** (used as a Bearer token). See Attentive's [authentication guide](https://docs.attentive.com/docs/authentication).
3. Copy the key.

{% hint style="info" %}
Treat the API key like a password — it can send messages to your subscribers on your behalf.
{% endhint %}

***

### Step 2: Enable the Attentive Integration in Zigpoll

1. Log in to your Zigpoll Dashboard.
2. Navigate to **Integrations** from the left-hand menu.
3. Find **Attentive** and toggle it on.
4. Paste your **API Key**.
5. *(Optional)* Enter a **Sign-up Source ID** — found in Attentive under **Sign-up Units** (the ID column). Only used when Auto Subscribe is on.
6. *(Optional)* Toggle **Auto Subscribe** to opt respondents into Attentive marketing on submission.
7. Press **Save**.

{% hint style="warning" %}
**Auto Subscribe** opts the respondent into Attentive SMS/email marketing. Only enable it if you have valid consent and a real sign-up source — subscribing survey respondents to SMS marketing has TCPA/consent implications.
{% endhint %}

***

### What Data Gets Sent

Once enabled, every survey submission sends the following to Attentive:

**Custom event** (`POST /events/custom`):

* Event type: `Completed a Zigpoll` (configurable per action — see below)
* Properties include the survey title, sentiment and sentiment label, a link to the participant's Zigpoll profile, and all slide responses (snake\_cased)

**Custom attributes** (`POST /attributes/custom`):

* The same properties, attached to the user's Attentive profile for segmentation

**Subscription** (`POST /subscriptions`, only if Auto Subscribe is on):

* Uses your Sign-up Source ID if set; otherwise subscribes to `MARKETING` with a default locale

Users are matched by **phone number** when a phone-number slide is present (E.164 format, e.g. `+14155551234`), otherwise by **email**. If neither is available, nothing is sent.

{% hint style="info" %}
Attentive has no concept of "lists." Segmentation is driven by custom events (journey triggers), profile attributes, and sign-up sources — which is exactly what this integration sends.
{% endhint %}

***

### Conditional events via survey & slide logic

You can fire a **specific** Attentive event based on how someone answered. On the survey **Behavior → Actions** tab, or in any slide's **Logic** section, add a condition and choose **Track in Attentive** as the action.

Each action has an optional **event name** field. Whatever you enter becomes the Attentive custom-event `type`, so you can point different conditions at different journeys — e.g. route detractors into a win-back journey and promoters into a referral journey. Leave it blank to use `Completed a Zigpoll`.

{% hint style="warning" %}
The event name must **exactly** match the custom event configured in your Attentive journey trigger (case- and space-sensitive).
{% endhint %}

***

### Shopify stores

If you use Zigpoll's Shopify integration, the Attentive event, attributes, and subscription are sent **after** Shopify enrichment — so they include the customer's Shopify email (even when it wasn't typed into the survey) and order metadata, the same as our Klaviyo and Brevo integrations.

***

### Example Use Cases

* **Trigger an SMS journey** when a customer leaves negative feedback.
* **Build segments** from survey responses such as attribution, product preferences, or sentiment.
* **Personalize messaging** using profile attributes synced from survey data.
* **Route by condition** — fire a distinct Attentive event per answer to drive different journeys.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigpoll.com/integrations/attentive.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.