Enregistrer une conversion

curl --request POST \ --url https://api.zelinqa.ai/v1/sessions/{session_id}/conversion \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: <idempotency-key>' \ --data ' { "outcome": "purchase", "metadata": { "order_value": 1290, "currency": "EUR" } } '

Autorisations

Authorization

string

header

requis

Transmettez votre clé API NBQ dans l'en-tête Authorization : Bearer nbq_live_xxx

En-têtes

Idempotency-Key

string<uuid>

requis

Une clé unique générée côté client (UUID recommandé). Sûr à réessayer — rejouer la même clé est une opération nulle.

Paramètres de chemin

session_id

string

requis

L'identifiant de session utilisé lors de l'appel à /v1/next-questions.

Corps

application/json

outcome

enum<string>

requis

Le résultat de la conversation.

Options disponibles:

purchase,

lead,

abandon,

other

Exemple:

"purchase"

metadata

object

Informations clé/valeur libres pour votre propre usage. Non interprétées par NBQ. Taille maximale sérialisée 4096 octets.

Exemple:

{ "order_value": 1290, "currency": "EUR" }

Réponse

Conversion enregistrée

conversion_id

string

Identifiant de la conversion enregistrée.

Exemple:

"cv_4a7b9c0d1e2f3a4b5c6d7e8f"

request_id

string

Identifiant unique de cette requête. À inclure dans toute demande de support.

Exemple:

"req_77a8b9c0d1e2f3a4"