Report a deferred conversion
Records a conversion against a tenant goal — typically a sale completed
after the chat ended. Attach it to a conversation_id for attribution,
or to an external_ref carried through your funnel. Repeated calls for
the same conversion are deduplicated.
Authorizations
Deploy-wide server-to-server bearer token (ENGINE_API_TOKEN),
validated by the engine_api firewall. Authenticates the Engine API,
Knowledge base, and Conversions surfaces. The tenant_id rides in the
request body and is trusted in V1 — keep this token strictly
server-side.
Body
Code of the tenant goal this conversion fulfils.
Attach for conversation attribution.
Reference carried through your funnel (e.g. order id) for attribution/dedupe.
When the conversion happened; defaults to now.
Free-form payload, e.g. value + currency.