Appels HTTP avec curl - Zelinqa

Ce guide s’adresse aux intégrations HTTP directes. Pour commencer avec les SDK officiels, consultez le démarrage rapide. Il vous faut une configuration publiée et une clé portant le scope runtime.

1. Créer une session

curl --request POST 'https://api.zelinqa.ai/v1/sessions' \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: session-$(uuidgen)" \
  --data '{
    "client_reference": "lead-8842",
    "max_turns": 10
  }'

Conservez session_id et versions.state_version dans la réponse. Une session neuve commence à la version 0.

2. Obtenir la première question

export ZELINQA_SESSION_ID="ses_01J8Z"

curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/next" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: next-$(uuidgen)" \
  --data '{"state_version": 0}'

Quand action vaut ask, affichez ou reformulez candidates[0]. Conservez la nouvelle valeur versions.state_version et, si possible, decision_id.

3. Envoyer la réponse du visiteur

curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/next" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: next-$(uuidgen)" \
  --data '{
    "state_version": 1,
    "previous_turn": {
      "decision_id": "dec_7f2a",
      "question_id": "q_budget",
      "assistant_text": "Quel budget souhaitez-vous consacrer au projet ?",
      "user_text": "Autour de 2 000 euros.",
      "message_id": "msg_18"
    }
  }'

Utilisez toujours la state_version réellement reçue ; la valeur 1 ci-dessus est seulement illustrative.

4. Enregistrer le résultat final

curl --request POST "https://api.zelinqa.ai/v1/sessions/$ZELINQA_SESSION_ID/feedback" \
  --header "Authorization: Bearer $ZELINQA_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: feedback-$(uuidgen)" \
  --data '{
    "result": "success",
    "label": "lead_qualified"
  }'

Retrouvez les schémas complets, exemples et erreurs dans la référence API.