Send AI SMS Messages Using Conversr¶
Conversr by Kudosity uses AI to engage donors in personalized SMS conversations. Evergiving integrates with Conversr to send donor cohorts at specific times, triggering actions based on donor responses. These actions might include calling the donor instantly or scheduling a follow-up visit.
Steps to Configure the Integration¶
1. Configure an Export to Send Data to Conversr¶
- Create a New Export:
- In Evergiving, create a new export.
-
Name the export, select the Type and Campaigns, and choose Output Type: Webhooks.
-
Select Target:
-
Under JSON POST (WEBHOOK), set Target to:
Conversr - Add Contact to List
. -
Enter API Key and Secret:
- Obtain your API Key and API Secret from Conversr by navigating to the 'API Settings' section of the Settings page at Conversr.
-
Enter the API credentials in the export configuration.
-
Set Filters and Schedule:
- Apply a Filter to determine which records will be sent.
-
Configure the Export Schedule to specify when and how often the export should run.
-
Configure the Schema:
- In the Schema section, click the clipboard button with an UP arrow (hover text: "Bulk import column header names from a CSV file").
- Drag and drop the CSV file with the required schema fields. Alternatively, manually configure the fields as shown below.
Manual Schema Configuration:¶
Field | Description |
---|---|
list_id | The campaign contact list ID in Conversr |
msisdn | The mobile number in e.164 format (without '+') |
countrycode | ISO country code (lowercase) |
first_name | Supporter's first name |
last_name | Supporter's last name |
field_1 | Pledge ID - used for return data (crm_id ) |
field_2 | Lead import label - used for return data (source ) |
field_3-5 | Campaign merge fields (ensure correct order) |
Your export will run according to the schedule and send the filtered data to your campaign in Conversr. After the first export, send one test and create a response for the next step.
2. Configure Zapier to Return Data to Evergiving¶
You will need a paid Zapier account since this process uses Webhooks (a premium feature).
- Create a Zap:
-
Set up a new Zap in Zapier with two steps:
- Step 1: Catch Hook in Webhooks by Zapier.
- Step 2: Create Lead in Evergiving.
-
Copy the Webhook URL:
- After creating the Zap, Zapier will provide a Webhook URL (e.g.,
https://hooks.zapier.com/hooks/catch/{ID}/{ID}
). -
Copy this URL and go to Conversr.
-
Add Webhook to Conversr:
-
In Conversr, paste the Webhook URL into the Add Webhook section of the campaign.
-
Create an API Token in Evergiving:
- In Evergiving, go to Account > API Tokens to generate an API token.
- Copy the token for use in the Zapier setup.
Once configured, Conversr will automatically trigger responses and actions, and Zapier will push the data back to Evergiving for further processing.