To integrate Invoca with Evolv you only need the UID used with your analytics stack, a custom event you want to track, and the format of the webhook.
Step 1: Accessing your Invoca webhooks
Login to your Invoca account, then hover over Integrations in the gray menu ribbon and select Custom Webhooks. Here you’ll see a list of each webhook that’s been created in your Invoca account if any.
Step 2: Choose Post-Call webhook
When creating a new webhook, you can choose between three types of Invoca webhooks, which differ from one another based on when they send or request your data. These precise timing differences make them most useful for different tasks:
Step 3: Name your webhook
Step 4: Configure your webhook
Add a GET request
For the Evolv participants API, send your data with this URL:
- https://participants.evolv.ai/v1/<ENVIRONMENT_ID>/events?uid=<EVOLV_UID>&type=<EVOLV_EVENT_KEY>
- EVOLV_UID: Comes from your analytics stack; match the same UID you pass to the webloader script "evolv-data-uid" parameter.
- ENVIRONMENT_ID: Navigate to the Evolv AI Manager > Environments tab and copy the environment key from your Production environment.
Add a POST request
If you're running a session-based project, you'll also need to send the below data request to identify confirmation and conversion events.
Request type | POST |
Request URL | https://participants.evolv.ai/v1/<encironment_id>/data |
Payload | { "uid": "<EVOLV_UID>", "client": "invoca", "messages": [ { "type": "context.initialized", "payload":{}, "timestamp":<CURRENT_TIME_EPOCH_MILLI> }, { "type": "context.value.added", "payload": { "key": "events", "value": [ { "type": "<EVOLV_EVENT_KEY>", "timestamp": <CURRENT_TIME_EPOCH_MILLI> } ] }, "timestamp": <CURRENT_TIME_EPOCH_MILLI> } ] } |
Step 5: Specify the conditions in which you want your webhook to fire
By default, your webhook will fire for every single phone call you receive in your Invoca account. You can add more specific conditions for your webhook firing in the Firing Conditions tab
When you’re finished, click Save. ✅
That’s it! You’ve created a new custom webhook or edited the settings of one of your current webhooks. Your new webhook will be active right away and will start firing whenever your conditions are met, sharing data with your external app.
If you want to pause, unpause, or delete your webhook, see Basic Knowledge: Invoca webhooks.