Skip to main content

Webhooks

By using webhooks, you can tightly integrate your server application with Wildix. The platform supports two kinds of webhooks: HTTP and AWS SQS.

HTTP webhooks follow the common set of rules:

  • Webhook should be reachable from the public internet. Tunneling services like Ngrok are supported
  • Webhook should accept HTTP POST requests with JSON payload
  • Webhook should respond with response codes from 200 to 299
  • Webhook should respond as fast as possible. The exact time given for the response varies between webhook types
  • Webhook should be ready to accept the same call multiple times: in case of network or remote server failure Wildix Service could retry the request

Events​

sms:status​

Triggered when SMS status event received.

Example
{
  "id": "1745855327719vt6k3vztxgct47cz",
  "pbx": "000000000001",
  "company": "it_w000001",
  "time": 1745855330065,
  "type": "sms:status",
  "integrationId": "f2d5rx",
  "data": {
    "from": "+16148970558",
    "to": "+19294457154",
    "status": "DELIVERED",
    "reason": "",
    "id": "1745855327719vt6k3vztxgct47cz",
    "channel": "2-way-sms",
    "parts": 1
  }
}