How to integrate your ThruTalk account with your VAN committee


Both ThruTalk and ThruText have two-way VAN integration. ThruTalk-enabled VAN API keys can import your lists from VAN and sync back script results from ThruTalk.


TABLE OF CONTENTS


Setting up your 2 way sync:

  • Set up your VAN key: See section below.
  • Import contacts from VAN into ThruTalk: Import a VAN List into ThruTalk to create a GetThru Group by pulling the external contact list.
  • Pulling survey data into scripts: By creating VAN-enabled scripts, you can import survey questions and activist codes into your scripts. Please review our guide on Script Mapping for more information.
  • Sync data collected in ThruTalk to VAN; by using scripts with VAN-enabled mapping within campaigns, dial results will be synced to VAN. The starting question is preset to sync as Canvass Results and responses recorded in ThruTalk Survey Questions will be written back to VAN Survey Questions or VAN Activist Codes. 


Integrate ThruTalk and your VAN committee:

  1. Request an API key from VAN.
  2. Set up your VAN Integration from the GetThru Integrations page.
If you encounter trouble, please reach out to support@getthru.io. If necessary, for security purposes, we recommend sending the key using a site like https://onetimesecret.com or https://1ty.me/.

Getting started

To get started, you will need a VAN API key to link your ThruTalk and VAN accounts. You can request the VAN API key and application name from within your VAN committee by navigating to the API integrations page in the sidebar. Then, you will want to click on "Request an API Key":


Screenshot of the "Request an API Key" modal to submit a request. "RelayDial" has been selected from the first drop down.


NOTE - If you cannot find this page, you will need to contact your VAN administrator or the person who created your VAN account to request this information.


You will want to request a key for the"ThruTalk/Relaydial" integration. Once you submit this request, a VAN support ticket will be opened where your VAN administrator can authorize the request:


Screenshot of a populate API integrations "request a key" page.


Once your key request has been authorized, you will be provided with a link to navigate back to the API Integrations page to generate your key.

 

EveryAction/NGP8 users may require two keys - one for MyVoters and one for their EveryAction/NGP8 account. Please inquire with your VAN/EveryAction admins for your committee's API key needs.


Once a key has been generated, it will be listed in the same section, but in place of the 'Generate Key' button, there will be a '...' menu with an option for regenerating; this will disappear after 7 days to avoid unintentional issues with active integrations.


NOTE - If you regenerate your key, it will break any existing integration with your ThruTalk account until the new key is set up in your GetThru account.