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.

Intégrations et API, dans le back-office

L’administrateur de votre espace gère l’intégration dans le back-office de Vizalia, sans écrire au support : clés, abonnements aux webhooks, journal des événements, consommation et bac à sable. Les captures montrent un espace fictif.

Où la trouver

Dans Réglages, rubrique « Accès et outils reliés », ouvrez Intégrations et API.

Les réglages d’un espace : la rubrique « Accès et outils reliés » contient l’entrée « Intégrations et API », avec le nombre de clés de l’espace.

Clés

Une clé par outil : CRM, centre de contacts, agent vocal. Son préfixe la repère sans dévoiler son secret ; une clé de test porte un badge. Chaque clé se remplace (nouveau secret) ou se révoque d’un bouton.

L’onglet Clés : quatre clés, dont une clé de test et une clé révoquée, avec leurs permissions et leur dernière utilisation.

Nouvelle clé : un nom, une échéance, le mode et les permissions. Le secret ne s’affiche qu’une fois, à la création : copiez-le aussitôt dans votre gestionnaire de secrets.

La création d’une clé : nom, échéance, mode Test ou Production, et les trois permissions de l’API v1.

Permission affichée	Portée de l’API
Lire les sessions	`sessions:read`
Lancer les sessions	`sessions:write`
Gérer les webhooks	`webhooks:manage`
API HTTP historique	L’API historique `/api`

Les permissions des agents vocaux (mcp, vision, rag) se demandent à l’équipe Vizalia. Le détail des portées est sur la page Authentification et portées.

Si une action est refusée, dans les onglets Clés, Webhooks ou Bac à sable, l’écran dit ce qui manque : l’option « Clés d’API » de l’abonnement de l’espace, ou le droit de votre compte. Voyez alors avec l’administrateur principal de l’espace, ou avec l’équipe Vizalia pour l’option.

Webhooks

Chaque abonnement montre son adresse, ses événements et son état : actif, en échec, ou coupé après 3 jours d’échecs. De là, on envoie un essai, on renouvelle le secret (l’ancien reste valable 24 heures), on désactive, réactive ou supprime.

L’onglet Webhooks : un abonnement de test, un abonnement en échec avec l’ancien secret encore valable, et un abonnement coupé.

Livraisons : la liste des envois d’un abonnement, avec chaque tentative et la suivante prévue, et un bouton pour rejouer un envoi.

Les livraisons d’un abonnement : livrées, en attente d’une nouvelle tentative, en échec, chacune avec « Rejouer ».

Journal

Les événements des 30 derniers jours, en production ou en test, avec leurs livraisons et le contenu envoyé, lien du client masqué. L’onglet n’apparaît que pour un espace qui utilise l’API v1. Par l’API, c’est GET /events.

L’onglet Journal : les événements récents, l’état de leur livraison et le contenu envoyé d’une fin de session.

Usage

Les sessions, liens ouverts, vidéos établies, minutes de vidéo et SMS envoyés, sur 30 jours ou 12 mois, en production ou en test. Par l’API, GET /usage donne les mêmes compteurs.

L’onglet Usage : cinq compteurs sur les 30 derniers jours et les sessions par jour.

Bac à sable

Une session de test se crée et avance d’un clic (ouvrir le lien, établir la vidéo, prendre une photo, terminer), et ses événements partent vers vos abonnements de test : le mode test de l’API, sans écrire une ligne.

L’onglet Bac à sable : des sessions de test, et les événements livrés d’une session terminée, rapport compris.

Documentation

L’onglet Documentation mène à ce portail.