Events Reference

| event_name | Trigger | Key properties |

|---|---|---|

| contact.created | First inbound message | entry_source, ctwa_clid |

| conversation.opened | New conversation row | contact_id |

| conversation.handed_off | Bot to human | agent_user_id |

| conversation.closed | Status set to closed | resolution_type |

| message.received | Inbound message | message_type, content |

| message.sent | Outbound message | template_name |

| lead.qualified | Classifier output | tier, score |

| campaign.sent | Per-recipient send | campaign_id, template_id |

| campaign.replied | Reply to campaign message | campaign_id |

| order.created | Order row inserted | total_amount, currency |

| payment.initiated | STK push sent | provider, amount |

| payment.completed | Successful callback | mpesa_receipt_number |

| payment.failed | Failed or cancelled callback | provider, error |

| capi.fired | CAPI event sent to Meta | event_type, ctwa_clid |