Webhooks
JustAI uses inbound webhooks to receive engagement and delivery events from your messaging platform. This data powers the bandit optimization engine — the more events JustAI receives, the faster it learns which variants perform best.
How It Works
Section titled “How It Works”- You configure your messaging platform to forward events (sends, opens, clicks, conversions) to a JustAI webhook URL.
- JustAI matches each event to the variant that was served, using the
tracking_idor platform-specific identifiers. - The optimization engine updates its model, improving future variant selection.
Webhook URLs
Section titled “Webhook URLs”Each integration has its own webhook endpoint:
| Platform | Endpoint |
|---|---|
| Customer.io | POST https://worker.justwords.ai/api/webhook/cio/:org_slug |
| Iterable | POST https://worker.justwords.ai/api/webhook/itbl/:org_slug |
| Braze | POST https://worker.justwords.ai/api/webhook/braze/:org_slug |
| Segment | POST https://worker.justwords.ai/api/webhook/segment/:org_slug |
| Salesforce Marketing Cloud | POST https://worker.justwords.ai/api/webhook/sfmc/:org_slug |
| Custom Events | POST https://worker.justwords.ai/api/webhook/events/:org_slug |
Replace :org_slug with your organization identifier (e.g., your-company-name).
Event Types
Section titled “Event Types”JustAI processes the following event types from each platform:
- Delivery events — confirms the message was sent.
- Engagement events — opens, clicks, and other interactions.
- Conversion events — downstream actions tied to a message.
The exact event names and payload formats vary by platform. JustAI normalizes them internally.
Webhook configuration is done in your messaging platform’s settings. For step-by-step setup instructions, see the integration guide for your platform:
Salesforce Marketing Cloud webhook ingestion is available for existing configured integrations, but it is not self-service. Contact your JustAI representative for setup.
Custom Events
Section titled “Custom Events”The custom events endpoint (/api/webhook/events/:org_slug) accepts JSON event data that doesn’t come from a native provider integration. Before sending production traffic, work with JustAI to validate the payload mapping and confirm which identifiers are required for attribution.