Webhook - how to add custom webhooks

Webhooks are a mechanism that allows one application to send automatic notifications to another application in real-time when a specific event occurs. For example, if an unanswered call is registered in our application, a webhook can immediately notify another application, providing details such as the caller's number, call time, or its status. This enables systems to synchronize and respond to events without manual intervention, improving management and process integration.

1. Log in and navigate to integrations settings

   • Log into PhoneHQ and click "Admin panel" to open more options

   • In the left-hand menu, select "Integrations".

2. Go to the Webhook section

   • In the "Integrations" section, find and click on "Webhook"

   • If no webhooks are defined yet, you’ll see a message "There are currently no webhooks defined" and a button "Add new webhooks". Click this button.

3. Create a new webhook

   • After clicking "Add new webhooks", a "New Webhook" form will appear.

   • Fill in the fields:

     • Event type: Select an event type from the dropdown, e.g., "Call answered" or "Call missed".

     • Webhook name: Enter a unique name, e.g., "Webhook1".

     • Webhook URL: Input the full URL where data will be sent (e.g.https://webhook.site/).

     • Webhook scope: Check "Select phone numbers" and choose the relevant phone numbers from the dropdown.

4. Save the configuration

   • After filling in all fields, click the "Save" button to create the webhook.

   • If an "Invalid phone number" message appears, check and correct the entered phone numbers.

5. Verify the integration status

   • Return to the "Webhook" section and ensure the new webhook appears on the list. You can click "View details" to verify the settings.

Done! Your webhook is now integrated with PhoneHQ and will process the selected events according to the provided URL.

FAQ – Frequently Asked Questions

1. What is a webhook?

A webhook is a way for PhoneHQ to automatically send data (e.g., about answered or missed calls) to an external system or app via a specified URL.

2. What event types can I choose when setting up a webhook?

You can choose from events like:

• Call answered

• Call missed

• Call finished

The full list of event types is available in the dropdown when creating a webhook.

3. Can I create more than one webhook?

Yes, you can create multiple webhooks for different events or phone numbers.

4. How can I test if a webhook works?

You can:

• Use tools like Webhook.site to test and inspect payloads.

• Check your server logs to see incoming webhook requests.

• Click “View details” in the Webhook section to verify settings.

Glossary