M
Meza AI

🔗 Webhooks & Segment

Connect Meza AI to external systems via webhooks.

Overview

Webhooks allow Meza AI to send data to external systems when workflow triggers fire. Use webhooks to integrate with tools not natively supported, or to send data to your own systems.

Webhook Action Setup

When adding a webhook action to a workflow:

  1. Select Webhook as the action type
  2. Enter the destination URL (must be HTTPS)
  3. Choose HTTP method (POST recommended)
  4. Configure headers (e.g., Authorization)
  5. Customize the payload using available variables

Payload Variables

VariableDescriptionExample
{{account.id}}Account IDacc_123abc
{{account.name}}Account nameAcme Corp
{{account.health_score}}Current health score72
{{account.stage}}Journey funnel stageEngaged
{{signal.name}}Triggered signal nameChurn Risk
{{signal.severity}}Signal severityhigh
{{timestamp}}Event timestamp2024-01-15T10:30:00Z

Example Payload

{
  "event": "signal_fired",
  "account": {
    "id": "{{account.id}}",
    "name": "{{account.name}}",
    "health_score": {{account.health_score}},
    "stage": "{{account.stage}}"
  },
  "signal": {
    "name": "{{signal.name}}",
    "severity": "{{signal.severity}}"
  },
  "timestamp": "{{timestamp}}"
}

Segment Integration

To send Meza AI events to Segment, configure a webhook with your Segment Write Key:

Webhook URL:

https://api.segment.io/v1/track

Headers:

Authorization: Basic {base64(writeKey:)}

⚠️ Warning

Always use HTTPS for webhook URLs. Test webhooks with a service like webhook.site before connecting to production systems.

What's Next?