Webhooks (formerly Server Callback) is a feature intended for software developers. They allow you to send real-time notifications to your own web applications and reporting systems. When activated, it sends an HTTP POST request to a URL of your choice immediately after each call is completed. This URL can be configured on a per-company basis. The request will contain data in the JSON format.
For a full overview of the webhooks offered, read our Developer Documentation.
Security keys for Webhooks
CallRail generates a secret, random token for every company. You can view these on the webhooks configuration page as outlined in the next section. The token is used with the request payload to generate a hash signature that is passed as a request header in the webhook request. You can use the secret token on your server to recompute the same hash based on the request payload. If your computed signature matches the header that CallRail sends, the request is valid.
How to Use Advanced Security Settings.
Adding a Webhook to CallRail
- Click the Settings icon on the left navigation bar.
- Choose the company where you’d like to use webhooks.
- Click Integrations at the top of the page.
- Choose Webhooks from the list of integrations.
- Find the webhook you'd like to use, and enter your endpoint.
- Select Activate when finished.
Disabling Webhooks
Disabling a company's webhooks will prevent CallRail from sending your data to your third-party integrations. We'll keep your webhooks saved in case you'd like to reactivate your integration in the future.
- Click the Settings icon on the left navigation bar on the left.
- Choose the company where you'd like to disable webhooks.
- Click Integrations at the top of the page.
- Choose Webhooks from the list of integrations.
- Select Disable Integration on the right side of the page.
FAQs
What if I'm already using cookies to get data on my site visitors?
If you're using a third-party tool to track visitors via cookies, you can use webhooks to associate visitor data with phone calls to your CallRail numbers through our Custom Cookie Capture integration. Use this article to learn more about setup and usage of this feature.
