API et intégrations

La page API relie le standard à vos outils : CRM, facturation, tableau de bord.

Clés d’API

Une clé permet à un outil d’agir sur le standard avec les droits du rôle choisi. Donnez-lui un usage (« CRM »), un rôle et, si vous voulez, une date d’expiration, puis Créer la clé. Copiez-la tout de suite : elle ne sera plus affichée. Révoquer coupe l’accès de l’outil qui l’utilise.

La documentation de l’API de votre espace est servie à l’adresse /api/docs du portail (/api/docs/en en anglais ; description OpenAPI : /api/v1/openapi-client.json et /api/v1/openapi-client.en.json). Une erreur porte un code stable et un detail ; avec l’en-tête Accept-Language: en, le detail est en anglais. Chaque clé peut envoyer 300 requêtes d’affilée, puis 10 par seconde ; au-delà, la réponse est 429 (trop_de_requetes) avec Retry-After, le nombre de secondes à attendre. Une clé sert aussi à brancher un assistant IA : voir Assistants IA (MCP).

Webhook

Un webhook prévient votre outil à chaque événement, en appelant une adresse https de votre choix :

• nouveau message vocal ;
• appel enregistré.

Chaque envoi est signé par un secret (en-tête X-Centrex-Signature) : votre outil vérifie ainsi qu’il vient bien du standard. Le secret s’affiche une seule fois ; Nouveau secret en crée un autre. Derniers envois montre chaque livraison, ses tentatives, son état et la cause du dernier échec (adresse refusée, hôte introuvable, injoignable, réponse en erreur avec son code). Après 20 échecs consécutifs, le webhook se désactive : la date est affichée ; l’enregistrer de nouveau le réactive.