Démarrage rapide - GPT de Babi Developers

Utilisez d’abord les identifiants sandbox affichés une seule fois dans votre console partenaire. Le sandbox accepte jusqu’à 50 nouveaux messages par jour, avec 20 requêtes par minute et 2 traitements simultanés. Réutiliser le même client_message_id avec le même contenu ne consomme pas un message supplémentaire.

1. Créer un token utilisateur

export GPT_DE_BABI_BASE_URL="https://gpt-de-babi.perfproai.com"
export GPT_DE_BABI_CLIENT_ID="gdb_sandbox_REMPLACEZ_MOI"
export GPT_DE_BABI_CLIENT_SECRET="REMPLACEZ_MOI"

curl --request POST "$GPT_DE_BABI_BASE_URL/api/partners/v1/tokens" \
  --user "$GPT_DE_BABI_CLIENT_ID:$GPT_DE_BABI_CLIENT_SECRET" \
  --header "Content-Type: application/json" \
  --data '{
    "external_user_id": "usr_8f32a9",
    "locale": "fr-CI",
    "timezone": "Africa/Abidjan"
  }'

Copiez access_token depuis la réponse dans USER_TOKEN.

2. Créer une conversation

export USER_TOKEN="COLLEZ_LE_TOKEN_COURT"

curl --request POST "$GPT_DE_BABI_BASE_URL/api/partners/v1/conversations" \
  --header "Authorization: Bearer $USER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"title":"Démarches administratives"}'

La réponse contient toujours l’identifiant à conserver :

{
  "conversation_id": "0d1fc89d-bbb6-4826-a4e7-7e25738c2755",
  "title": "Démarches administratives",
  "created_at": "2026-09-03T20:15:32.182Z"
}

3. Envoyer un message

export CONVERSATION_ID="UUID_RETOURNE"

curl --request POST \
  "$GPT_DE_BABI_BASE_URL/api/partners/v1/conversations/$CONVERSATION_ID/messages" \
  --header "Authorization: Bearer $USER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "client_message_id": "msg_001",
    "message": "Où renouveler mon passeport à Abidjan ?",
    "location": {"city":"Abidjan","commune":"Cocody"}
  }'

Une réponse 202 contient toujours les deux identifiants nécessaires pour gérer le tour :

{
  "turn_id": "944bc91d-a2c9-4c7b-952a-a5237636bf75",
  "conversation_id": "0d1fc89d-bbb6-4826-a4e7-7e25738c2755",
  "status": "queued",
  "created_at": "2026-09-03T20:16:05.426Z",
  "updated_at": "2026-09-03T20:16:05.426Z"
}

Interrogez /api/partners/v1/turns/{turn_id} jusqu’à status: completed, ou utilisez le streaming WebSocket. Les événements associés à un tour contiennent également conversation_id et turn_id.