For the complete documentation index, see llms.txt. This page is also available as Markdown.

◾Reverse integration: messaging

The Smartico platform can notify your system whenever it sends an asset (such as an email, SMS, or push notification) to a user via HTTP call.

For example, Smartico can trigger an HTTP request (typically a POST) to your API each time an asset is sent. This enables you to track user communications in real time. Possible Parameters Included in the Request

Supported Triggers & Actions

Webhooks can be configured to trigger on:

  • Communication Channels – Email, SMS, Push, Inbox, Popups, WhatsApp, Viber, Telegram, and IVR calls.

  • Customer Journey Property Updates – Triggers whenever specified player properties change, sending the updated property name and its new value.

  • Delivery & Status Events – Optionally receive updates when messages are delivered, opened, or failed (or filter to send-only events).

  • Time – Timestamp in epoch milliseconds

  • Campaign Name – The name of the campaign that triggered the asset

  • Asset Type – Communication channel (e.g., Email, SMS, Push)

  • External User ID – The user ID in your system

  • Engagement ID – Unique identifier of the message interaction

  • Campaign ID – The numeric ID of the campaign

  • Brand Name – The name of the brand associated with the user

  • Custom User & Event Tags – Any user property or event property can be injected using dynamic tags (for example, user properties or custom parameters)

  • Resource Title & Meta – The title and metadata associated with the message template

You can configure webhooks directly in the Back-Office under Label > More > WebHooks, or have the Smartico team assist you. When setting up an endpoint, specify:

  • HTTP URL of your API endpoint

  • Preferred HTTP method – POST is recommended, but GET is also supported

  • Content type – "application/json" is suggested

  • Body template – For POST requests, a JSON payload structure must be defined

  • Headers – Custom HTTP headers such as Authorization tokens or API keys can be specified in the webhook configuration

Example of setup

Note: The following is a sample request body. It is fully configurable and can be adapted to match your existing API. In 99% of cases, we can integrate with your current structure without requiring changes on your end.

If you already have an API that handles similar notifications, in most of the cases we can reuse it with minimal to no modification.

Contact your Success Manager or log a JIRA ticket to set up the reverse integration

FAQ

Can reverse integration webhooks export historical communication data to our data warehouse?

No. Reverse integration webhooks fire in real time as individual communication events occur. For historical communication logs and bulk analysis, access the communication tables in your Data Warehouse export or review standard communication reports in the Back-Office.

How can we pass custom user attributes or event parameters in the webhook body?

In addition to standard parameters, you can use dynamic tag replacement (such as user profile attributes or custom event parameters) directly in your JSON body template.

Can we filter webhooks to trigger only on initial message sends rather than delivery callbacks?

Yes. Webhooks can be configured to trigger exclusively on message send events, ignoring downstream status updates.

Last updated

Was this helpful?