Integrations · Practical guide
Zintara reply.received webhook: payload and matching limits
Handle a matched reply notification without assuming the payload contains the reply body, campaign identity or positive sentiment.
Reviewed · Examples are illustrative
Who this helps: Developers integrating Zintara data and signed webhook notifications.
Define the decision
In the reviewed inbox code, reply.received is dispatched when a message is classified as a reply and matched to a lead. The payload contains email, subject and leadId. It is not a complete inbox-message export or proof of sales qualification.
Work through the procedure
- Subscribe an active endpoint to reply.received.
- Verify the signature over the exact raw request body before parsing.
- Validate the event and required data fields.
- Store the notification durably before acknowledging it.
- Use a separate reviewed process for retrieving context or assigning a sales outcome.
Worked example
The following is a synthetic example for this procedure, not a customer result or performance benchmark.
{"event":"reply.received","data":{"email":"[email protected]","subject":"Re: evaluation","leadId":"00000000-0000-4000-8000-000000000001"},"timestamp":"2026-09-16T10:00:00Z"}Read the result
The subject is message content supplied by an external sender, so render it as text and avoid using it as a command or unique identifier. A reply can be negative or merely informational.
Check before moving on
- Confirm the event arrives only at the intended integration.
- Test repeated notification handling without creating repeated sales tasks.
Limits and next action
The current envelope has no stable event ID or reply-body field, and dispatch is best-effort. Do not promise complete history or exactly-once delivery from this webhook alone.
Source: Zintara product context
Source references
Worked examples are illustrative. Editorial procedures are suggested methods, not measured performance claims or promises of additional product features.
Related guides
- Webhook: an event notification with a receiver you must operate →
- Zintara webhook event schema and signature reference →
- Zintara webhook delivery failures: best-effort dispatch and recovery boundaries →