Take advantage of the full potential of Voxloud by integrating the phone system with third-party software using webhooks.
Summary
What is a webhook?
The webhook is a link that you can create and later use in configuring your phone number rules. When the rule is activated, your phone system will take the webhook URL, transmitting the call parameter information you specified in the webhook.
What can you do with a webhook?
You can use automation platforms like Zapier or Make to set up webhook automations. And of course, you can develop your own custom solution and leverage the full power of Voxloud webhooks.
How to activate the webhook
To use the webhook, go to the Control Panel shop and purchase the “API & Integrations” addon or upgrade your plan.
How to create and configure a webhook
Once activated, you will find the "Wehooks" item in the main menu of your Control Panel.
This is the main webhook section, where you can manage them.
In the Webhooks section, you will see the list of your activated webhooks.
In the "Actions" column you can:
Edit a webhook
Delete a webhook
Test a webhook
Create a new webhook
To create a new webhook, click on the "+" button at the top right. This screen will open:
Here you will need to enter:
Name: The name you want to give your webhook
URL: The webhook URL of the software you want to integrate with Voxloud
Number of attempts: Choose the number of attempts to invoke the webhook
Attempts Delay: Choose how often to retry the webhook
Webhook parameters: select the switchboard parameters you want to associate with the webhook
Preview: Here you can see how the webhook URL will look
Once you have filled in all the fields, click on the "Add" button at the bottom right to create your new webhook.
How to properly test a new webhook
When testing a webhook, the phone system will hit the provided url with some example data. You can then consume and analyze it on the URL side.
Here there are some technical details on how the phone system webhook works.
It will trigger HTTP POST request to the specified URL, including all available information in request body.
For example, to simulate the webhook using cURL tool, you can use a code like this:
curl -X POST https://example.com \ -H "Content-Type: application/json" \ -d '{ "call_id": "1234345", "caller_number": "+39061234567", "callee_number": "+39069876543", "crm_name": "SOME CRM", "crm_contact_name": "John Smith", "rule_name": "Office opening", "labels": ["label1", "label2"] }'
How to use the webhook in Voxloud
You can use the webhook in a rule by simply selecting "Choose a webhook" in the settings of the rule you are creating or editing.
How to use the webhook with third-parties platforms (Zapier, Make)
To manage webhooks with third-party applications, such as Zapier and Make, we recommend reading the documentation for the two platforms.
Receiving a webhook on Zapier: https://help.zapier.com/hc/en-us/articles/8496288690317-Trigger-Zaps-from-webhooks#h_01HBGES5DWT8NFWCHFQYSRSK62
Receiving a webhook on Make: https://www.make.com/en/help/connections/receiving-a-webhook-from-a-web-service
Do you need more assistance?
The Voxloud support team is always by your side.
Contact support at [email protected] or open a chat by clicking the button at the bottom right.