Outbound Webhooks

Outbound Webhooks can be used to forward the following events on Webex Connect to your web application:

❗️

URL Endpoint Requirement

We only support HTTPs URLs. All URLs must return a 200 HTTP Response to a HEAD request to be successfully saved on the UI.

All notifications will be delivered as POST requests and expect a 200 HTTP Response

📘

Configuring Outbound Webhooks

For more information on how to configure Outbound Webhooks, refer to Outbound Webhooks

Enable Hub Secret (Optional)

The value of the hub secret is used as the key to creating a signature of the notification data, and is sent along with the notification, which can then be verified by the receiving server. The signature is the hexadecimal (40-byte) representation of an SHA-1, SHA-256, or SHA-512 signature computed using the HMAC algorithm as defined in RFC2104.

When enabled, you will receive an additional header called x-hub-signature.

Delivery Receipts

To receive delivery receipts for your messages -

  • Select a service under entity
  • Select the outbound channel for which you want to receive the delivery receipts - These messages must've gone from a Messaging API authenticated with the selected service key or through flows or rules inside the selected service
  • Select the delivery receipt type for the selected channel - Different channels have different capabilities in terms of the kind of the receipts that are available
Example Delivery Receipt Webhook - Entity is One-way intelligent service and channel is SMSExample Delivery Receipt Webhook - Entity is One-way intelligent service and channel is SMS

Example Delivery Receipt Webhook - Entity is One-way intelligent service and channel is SMS

Incoming Messages & Events

To receive incoming messages or events sent to your numbers or your apps by your customers -

  • Select a Number or an App under entity
  • Select the Incoming messages/events option for the corresponding app/number
Example Inbound Message & Event Webhook - Entity is JS SDK AppExample Inbound Message & Event Webhook - Entity is JS SDK App

Example Inbound Message & Event Webhook - Entity is JS SDK App