ORYKSA API, webhooks et portail développeur

L’API ORYKSA permet aux développeurs d’utiliser votre employé IA depuis leurs propres applications, sites web et systèmes : envoyer des messages clients et recevoir des réponses, synchroniser la connaissance (Brain), signaler des conversions, et recevoir des webhooks lorsque l’IA répond ou réserve un rendez-vous.

Où commencer : documentation complète en anglais, portugais et espagnol sur developer.oryksa.com, avec un fichier OpenAPI, une collection Postman et une console "Try it".

Créer une clé API

1. Connectez-vous sur developer.oryksa.com avec votre compte ORYKSA et ouvrez Keys.
2. Saisissez un nom (par exemple "iOS app") et cliquez sur Create key.
3. Copiez la clé immédiatement. Pour des raisons de sécurité, elle n’est affichée qu’une seule fois.

Vous pouvez révoquer une clé à tout moment : les applications qui l’utilisent cessent de fonctionner immédiatement. Gardez les clés sur un serveur, jamais dans un site web ou une application.

Webhooks

Au même endroit, ajoutez l’adresse (https) qui doit recevoir les événements et choisissez les événements : réponse à un message, création d’une réservation, limite du plan atteinte, mise à jour de la connaissance. Enregistrez le secret de signature affiché une seule fois, et utilisez Test pour vérifier la livraison.

Conversions

Votre site ou application peut informer ORYKSA lorsqu’une conversation aboutit à un résultat avec POST /v1/conversions (vente, prospect, inscription ou réservation). Vous recevez une alerte, et ORYKSA peut vous répondre à ce sujet dans le chat du tableau de bord.

Plans

L’API est un canal web, comme le chat du site. Chaque réponse de l’IA compte comme une interaction du plan, avec les mêmes limites que WhatsApp.