Integrate Privy with Attentive

Jessica Labulis

Feb 23, 2024

317

The Privy integration with Attentive allows contact information collected by Privy to be used for SMS marketing in Attentive. The combination provides an opportunity to expand your brand's reach beyond the traditional email channel and meet your customers with compelling promotions in other areas.

Note: This guide reviews configuring version 2.0 of the Privy - Attentive integration. If you integrated with Attentive before August 19, 2021, you must follow these updated steps to access the expanded features outlined below. Otherwise, you will remain on the legacy integration, which only supports the sharing of phone numbers via compatible displays.

Features of the integration

The integration currently supports:

Autosync of all Privy displays submissions that include a single phone number collected using the default Phone field from Privy to Attentive.
Syncing of all default customer attribute fields included in a Privy display submission.
Syncing of all custom fields included in a Privy display except for those using the multi-select checkbox format.

Configuration

The integration must be enabled, and a display must be created with the proper settings before information collected via Privy can be synced to Attentive.

Enable the integration

To enable the Privy-Attentive integration:

Select the Account dropdown menu at the top-right. Your business name appears there.
Select the Integrations option from the dropdown menu.
Locate and select the Attentive option in the Available Integrations area.
If you aren't already logged into your Attentive account, log in and select Continue.
In Attentive, select the Authorize option. If your Privy credentials are associated with multiple Privy accounts, please select the Link option next to the account you'd like to connect.
Once linked, your Attentive account will appear in the Authorized Accounts section of your Privy integrations area, along with an option to Test() the account's connection.

Create a compatible display

An Attentive API Source ID is required to complete the display setup. If you do not already have this, please contact your Attentive representative to request it. Prior to receiving an Attentive API Source ID, your Attentive representative will look to see that you are displaying an appropriate legal disclosure. Attentive's standard disclosure language can be found in the example below. To create a compatible display once the integration is enabled and you have your Attentive Source ID:

Navigate to Convert > All Displays and select or create a display that includes a form.
In the Create step of the display builder, edit the form and ensure that the Phone number field is included. If it isn't, use the Add Field dropdown menu to add it and Save any changes.

Note: Adding a Phone number field automatically adds a Text Opt-in field. This additional field is not required and should be removed.

After finalizing the form used in your display, select the Design card in the Create step and ensure the design of your display is still satisfactory. For example, adding fields to an existing display can change the overall look of the original design as the form takes up more space.

Next, ensure the marketing consent disclosure on the display reflects the inclusion of the text opt-in. This disclosure should link to your Messaging Terms of Service and Privacy Policy. An example of the standard Attentive legal disclosure is shown below, along with its required placement before the form fields in a display. That said, please consult with your Attentive representative to ensure your legal language meets your specific needs. Save any changes.

By signing up, you agree to receive recurring automated promotional and personalized marketing messages from Wicked Wicks Candle at the email and number used at signup. Consent is not a condition of any purchase. Reply HELP for help and STOP to cancel texts. Msg frequency varies. Msg & data rates may apply. View our Terms & Privacy Policy.

Now, switch to the Follow-up step of the display builder and select the Sync signups button listed below the default after signup email.

In the prompt, select your Attentive account from the dropdown menu, input your Attentive Source ID, and then click Save.

Lastly, finish customizing the display's settings and click Publish in the upper right to make the display available on your site.

The information captured by your display will now sync to your Attentive account, where it will be available for additional SMS marketing.

Retain records

You must retain records showing opt-ins through the Attentive integration, such as screenshots of the implementation at the time it goes live and when any edits are made.

Troubleshoot the integration

If you are encountering issues with your Privy - Attentive integration, please consider the following:

Signups

Signups only sync to Attentive if the submission includes a single phone number collected via the default Phone (contact_phone) field.
Fields with blank values will not sync.
Fields with multiple values collected via multi-select checkboxes will not sync.
The integration does not support transactional opt-ins.

Eligibility for text and email

When a phone number is synced to Attentive, that number will be 'subscribed' to the 'TEXT' channel for the type of messages associated with their 'Source ID'.
- If the contact is a new subscriber, they'll receive a double opt-in text from Attentive.
- If the contact is an existing subscriber, they may receive a text from Attentive letting them know they're already subscribed.
When an email address is synced to Attentive, that email address will be 'subscribed' to the 'EMAIL' channel for the type of messages associated with their 'Source ID.'

Sync Errors

Syncs are reported as a 'success' as long as the phone field and/or email field were successfully shared during the attempt.
Errors that occur when syncing custom fields are ignored.

More information on troubleshooting integrations is available here.

Remove the integration

To remove your Privy - Attentive integration:

In Privy, navigate to the Integrations section of your account settings.
Locate the Attentive integration and select the Delete() option.

In Attentive, navigate to the Connected Apps section of your account settings and select the Revoke Application option next to Privy. Confirm your decision in the prompt.

The integration and all of its associated permissions are now removed.