5. Outbound Webhooks (Events API)

Siteti notifies your server about platform events via POST requests to your configured listener URL.

Event Payload Sample (Failure):

{
  "event_type": "message.delivery_failed",
  "timestamp": "2026-03-10T19:00:00Z",
  "data": {
    "to": "2348011223344",
    "reason": "Receiver phone number not on WhatsApp",
    "template_id": 402
  }
}

Event Catalog:

• contact.first_interaction: Triggered by a new incoming message from an unknown number.
• session.started: Triggered when a 24-hour service window opens.
• message.delivery_failed: Triggered by Meta delivery errors (e.g., invalid number).
• billing.issue: Triggered by payment failures on Meta or Siteti.
• subscription.expiring: Warning sent 7 days and 24 hours before your plan ends.
• subscription.expired: Final notice when the plan or trial ends.