Webhook

A webhook is an HTTP request sent by one system to notify another system that an event has occurred. Instead of repeatedly asking for updates, the receiving application provides an endpoint where the sender can deliver event data. In telephony, an event might describe a change in a call's lifecycle, but payload structure and delivery behaviour are specific to each integration.

Webhook delivery should not be assumed to happen exactly once or in order. Networks fail, receivers restart and senders may retry requests. A robust consumer validates the sender using the documented mechanism, handles duplicates safely and avoids relying on arrival order alone. It should also keep processing time predictable and protect sensitive data in logs. Receiving a request does not prove that all downstream work completed successfully. Integration testing should cover invalid messages, temporary failures and repeated delivery. Public endpoint addresses and event identifiers should be distinguished from credentials used to authenticate or verify requests.