Event Handlers

Event Handlers define where events should be sent. Each handler represents an external system that will receive event data when a subscribed event fires.

Two handler types are supported: Webhook and SMPP.

Webhook

A Webhook handler delivers event notifications to an HTTP endpoint via an HTTP POST request. The POST includes a JSON payload containing details about the event.

❗️
Important: The Webhook is a delivery mechanism only. Stacuity sends the payload and moves on -- it does not wait for a response or retry if the receiving system is unavailable.

Adding a Webhook Event Handler

Name your handler -- Give it a descriptive name to identify its purpose.
Set the Moniker -- A unique identifier used internally by the system.
Choose the Type -- Select Webhook.
Configure VSlice -- Set to Any to apply across all vSlices, or select a specific VSlice.
Enter the URL -- The endpoint where event payloads should be delivered.
Set Timeout -- How long to wait for a response, in seconds. Defaults to 5.
Add Authentication -- Optionally provide a Bearer Token, Basic Auth username, and Basic Auth password so the receiving service can verify incoming requests.
Test first -- Click Test Webhook to verify connectivity before saving. This sends a test payload to your endpoint:

   { "message": "webhook test" }

Create -- Click Create to save the handler.

Important: You are responsible for creating and managing the receiving application at your webhook URL. Stacuity only delivers the event payload to the endpoint you specify.

SMPP

An SMPP (Short Message Peer-to-Peer) handler delivers event notifications via the SMPP protocol, typically used for SMS routing integration.

Adding an SMPP Event Handler

Name your Handler -- Give it a descriptive name to identify its purpose.
Set the Moniker -- A unique identifier used internally by the system.
Choose the Type -- Select SMPP.
Configure VSlice -- Set to Any to apply across all VSlices, or select a specific VSlice.
Credential -- Select a stored SMPP credential to authenticate with the SMPP service.
Create -- Click Create to save the handler.