Skip to main content
NGP VAN Integration Overview

How to setup the NGP VAN integration

Judd Bobin avatar
Written by Judd Bobin
Updated over a week ago

What does the integration do?

The NGP VAN integration allows you to automatically collect new SMS opt-ins from various online forms, such as surveys, donations, petitions, and more. This integration checks for new form submissions every minute, ensuring your contact list is always up to date. Before adding or updating a subscriber, the integration verifies that they have opted in to receive SMS messages. If SMS opt-in consent is confirmed, the contact is added or updated in your Tatango list.

You can map the following fields from NGP VAN to Tatango to use for segmentation or personalizing your messages:

  • Campaign ID

  • City

  • Contacts Online Form ID

  • Date of Birth

  • Date Submitted

  • Email

  • First Name

  • Form ID

  • Form Name

  • Form Tracking ID

  • Last Name

  • Market Source

  • Sex

  • Source Code

  • State

  • VAN ID

  • Zip

How do I set up the integration?

This process involves configuration in Tatango and NGP VAN.

NGP VAN Steps

Prerequisite: Ensure you've configured your online forms to collect SMS Opt-In consent. You'll want to make sure mobile field and SMS Signup are both enabled. Also, make sure the SMS Signup default value is checked / set to true. This ensures that if the subscriber provides their mobile phone number, they are opted in. Lastly, make sure to fill out the disclaimer language for SMS Signup.
โ€‹

  1. From the NGP VAN home page, open the API Integrations page from the sidebar on the left-hand side.

  2. From the API Integrations page, click Request an API Key

  3. Then select Tatango from the Preferred Partner dropdown
    โ€‹

  4. Select the contact to send the request to

  5. Lastly, click Submit Request

After you have requested a new key, the contact you selected will receive a ticket in the Support Request System for the API key request. Once approved follow the next steps.

  1. The API Key will appear in the API Keys section

  2. Click Generate API Key

  3. Copy down the Application Name and API Key, you will use these when configuring the integration in Tatango.

Tatango Steps

Prerequisite: Ensure you've configured any custom fields on your Tatango list that you'd like available to map when configuring the integration (e.g. VAN ID).

  1. From the Tatango home page, click My Account -> Integrations

  2. From the Integrations page, select the All Apps tab

  3. Locate the NGP VAN app tile, and click Configure

  4. You will be presented with the option to create a custom name for the integration, you can leave this as NGP VAN or customize to your choosing. Click Continue

  5. While in the configuration wizard, you will be prompted to configure your NGP VAN authorization. If you have not done so previously, click Add a new account.

    • For Username, enter the Application Name you saved from the NGP VAN configuration steps earlier

    • For API Key, enter the API Key

    • For Database mode, select My Campaign

  6. Click Create

  7. With the authorization now entered, click Next

  8. Select the List Name that you'd like contacts added to, then click Next

  9. Now on the Data Mapper step, map the NGP VAN fields to your Tatango fields, when finished click Next

  10. Click Finish

Did this answer your question?