Préproduction : l'API répond sur https://api.visiobank.com/v1, avec une clé de test. Les exemples gardent l'adresse de production, api.vizalia.ai, qui ouvrira à la mise en production.

Mode test

Le mode test se choisit par la clé, pas par l’adresse : une clé vz_test_<préfixe>_… agit en mode test sur la même API, https://api.vizalia.ai/v1. Passer en production, c’est changer de clé ; rien d’autre ne change.

Ce qui change en mode test

Aucun SMS ni e-mail ne part. Une session sms ou email passe pourtant en invited, comme si l’invitation était partie. Ouvrez vous-même join_url pour voir la page du client.
La session n’est pas facturée.
Les objets portent livemode: false : sessions, événements, abonnements aux webhooks.
Le parcours du client se simule avec POST /sessions/{session_id}/simulate, qui n’existe qu’en mode test.

Les webhooks, eux, partent comme en production : votre serveur reçoit les mêmes événements, signés de la même façon. Le bac à sable du back-office fait tout cela sans écrire une ligne.

Simuler le parcours du client

simulate fait avancer une session de test comme si le client agissait. Chaque action envoie ses webhooks.

`action`	Ce qui se passe	Événements
`open`	Le client ouvre le lien.	`session.opened`
`go_live`	La vidéo du client est établie. Aucun clip n’est créé.	`session.live`
`take_photo`	Une photo est prise : un JPEG légendé « Photo simulée (mode test) ».	`photo.created`
`end`	La session se termine.	`session.ended`, puis `report.ready`

Les actions se suivent dans cet ordre, mais aucune n’en exige une autre : une action en avance fait d’abord les étapes manquantes (take_photo sur une session neuve l’ouvre et la passe en live). Une action déjà faite répond 200 sans rien changer.

Ne se simulent pas encore : un clip vidéo, un document, une mesure, l’échec d’une invitation et le dossier case.submitted d’un agent vocal. Pour tester leur traitement, servez-vous des exemples de la référence.

curl https://api.vizalia.ai/v1/sessions/ses_01JC3W8Z5T9QK2N4R6V8X0Y1Z2/simulate \
  -H "Authorization: Bearer $VIZALIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "open"}'

Avec une clé de production, simulate répond 403 test_mode_only.

Tester un abonnement

POST /webhook_endpoints/{endpoint_id}/test envoie tout de suite à votre URL un événement fictif signé (livemode faux), et renvoie la réponse de votre serveur : code HTTP, durée et, en cas d’échec, sa cause dans error (les codes). Sans type, l’événement envoyé est un session.created. L’envoi de test part même vers un abonnement désactivé : de quoi vérifier votre serveur avant de le réactiver.

curl https://api.vizalia.ai/v1/webhook_endpoints/we_01JC40AB12/test \
  -H "Authorization: Bearer $VIZALIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "session.ended"}'