01-22-2018 07:43 PM - edited 07-22-2022 02:58 PM
A webhook is a rule you can create in your Invoca account to let it communicate with your other marketing apps and systems. Your webhooks will “fire” whenever a certain condition is met in your Invoca account — usually, any phone call received — and your Invoca account will automatically send or request data to another system.
Webhooks are most frequently used to power your Invoca certified integrations, and each integration guide in this knowledge base includes detailed instructions on how to set up a webhook specifically for that integration. However, with a bit more savvy, you can also use webhooks to build your own custom integrations, sharing data between Invoca and any other app or system with an API.
There are three kinds of Invoca webhooks, which differ from one another based on when they send your data. These precise timing differences make them most useful for different tasks:
Invoca webhooks supports the following HTTP verbs: GET, POST, PUT, PATCH, DELETE. We support the following formatting standards: JSON, XML, HTTP form values, and plain text.
First, you’ll need to How to create an Invoca webhook (or several of them!). While creating that webhook, you’ll specify the condition in which you want it to fire. Usually, your webhooks will fire for every phone call you receive, but you can set up more restrictive conditions if you’d like. Whenever that condition takes place, your webhook will automatically either send data to or request data from an API address of your choice. You can also pause or unpause your Invoca webhooks at any time to stop or resume them firing – see the create a webhook article linked above for more details.
And that’s it! Just like that, your Invoca account automatically shares data with all your other apps, moving your marketing data to the systems where it’s most useful so you don’t have to.
Once you have webhooks in your account, you can pause, unpause, or delete them at any time. Pausing a webhook will keep it in your account but prevent it from firing until you unpause it; deleting a webhook will remove it from your platform entirely.
To do so, login to your Invoca account, then click on Integrations in the side menu ribbon and select Manage Integrations. Choose the Custom Webhooks tile in your Integration Library. Here you’ll see a list of each webhook that’s been created in your Invoca account for integrations that haven't been converted to no-code templates. Find the webhook you want to adjust, then scroll right to the Actions column. Click the settings button, then select Pause, Unpause, or Delete.
Now that you’ve learned a little bit about webhooks, why not try following one of our Invoca integration guides for a full-service tutorial for installing a webhook-powered integration yourself. Or, if you’re up to the task, you can read How to create, edit, or clone an Invoca webhook. or Using Real-Time Routing Webhooks to include Invoca data with third-party call routing.