About Webhooks

Webhooks allow you to get automatic notifications from Zingle about changes to your data as they happen.

Rather than requiring you to pull information via our API, webhooks will push information to your endpoint. When one of those events is triggered, Zingle will send this notification as an HTTP POST request, with a JSON body, to the endpoint(s) you specify.

Setup

1. Start by navigating to the Webhooks integration page. Admin Settings > Integrations > Webhooks. 

2. Insert your Webhook URL, something like this:

3. Select the events to send, currently Contact Opt-In Status is the only available event to push. (More to come!)

4. If you'd like use to set any header values, enter the header name on the left and value on the right.

5. Toggle on the webhook and select Save Configuration to enable.

Example payload from "Opt-in" event Webhook

{
    // block or unblock
    "action":              "block",
    // inbound or outbound
    "direction":           "outbound",
    // Zingle service ID
    "service_id":          "b08c6005-b53d-4f06-4324-2938a6812d94",
    "service_name":        "Hotel California",
    // Zingle contact ID
    "contact_id":          "124f6027-b73d-4f06-8fec-2938a683ce93",
    // Contact PMS Profile ID
    "contact_external_id": "19878887",
    "contact_phone":       "+18585551874",
    "service_phone":       "+16195558727",
    // If true, block was initiated by contact.  If false, block was initiated by Zingle user
    "is_auto_blocked":     true
}
Did this answer your question?