API et outils IA : connectez vos logiciels et votre assistant IA

La page Développeurs vous permet de connecter à votre compte vos propres logiciels, comme un système de réservation, un CRM, une caisse ou votre propre code, ainsi que des assistants IA. Elle s'adresse à vous ou à la personne qui gère vos outils ; vous n'en avez pas besoin pour utiliser l'application au quotidien.

Si Développeurs n'apparaît pas dans votre menu, l'accès API ne fait pas partie de votre formule — OmniVizi peut vous expliquer comment l'ajouter.

Votre clé API

Votre compte dispose d'une seule clé API avec un accès complet : tout ce que propose l'API et votre connecteur IA. Tout ce qui détient la clé peut lire et modifier vos données ; protégez-la donc comme un mot de passe.

Pour créer votre clé :

1. Ouvrez Développeurs.
2. Sous Clé API, cliquez sur Créer une clé API.
3. Copiez immédiatement la clé affichée dans Votre nouvelle clé et conservez-la en lieu sûr. Vous ne pourrez plus la revoir.
4. Cliquez sur Terminé.

À côté de la nouvelle clé, vous voyez aussi un exemple de requête et l'adresse de votre Connecteur IA (MCP).

Ensuite, la clé n'est plus affichée que par ses derniers caractères, avec qui l'a créée (votre équipe ou OmniVizi), sa date de création et sa dernière utilisation.

• Créer une nouvelle clé la remplace. L'ancienne cesse de fonctionner immédiatement : mettez à jour tout ce qui l'utilise. Faites-le si votre clé a été partagée par erreur.
• Révoquer désactive complètement la clé.

L'URL de base, en haut de la carte, est l'adresse à laquelle vos logiciels envoient leurs requêtes ; Copier la place dans votre presse-papiers.

Seul le propriétaire du compte peut créer ou révoquer des clés. Si un message l'indique, adressez-vous au propriétaire du compte ou à OmniVizi.

Lire la documentation

Cliquez sur Lire la documentation pour la référence complète : toutes les requêtes que votre clé peut faire, regroupées par thème (comme les contacts, les avis et les demandes d'avis), avec la requête exacte pour chacune. Sur la page d'une requête, Essayer permet d'envoyer un test, vers un compte de démonstration (rien n'est enregistré ni envoyé) ou avec votre propre clé. Télécharger OpenAPI fournit un fichier lisible par les outils de développement.

Connecter un assistant IA (MCP)

Votre clé sert aussi de connecteur IA. De nombreux assistants IA permettent d'ajouter un connecteur personnalisé via MCP (Model Context Protocol). Une fois connecté, l'assistant peut utiliser tout ce que propose l'API pour votre compte : vous pouvez par exemple lui demander combien de demandes sont arrivées le mois dernier, ou lui faire envoyer des demandes d'avis.

1. Copiez l'adresse Connecteur IA (MCP) affichée lors de la création de votre clé. C'est l'adresse de votre connecteur, suivie de votre clé.
2. Dans votre assistant IA, ajoutez un connecteur personnalisé et collez l'adresse. La note sous l'adresse indique où trouver cette option dans un assistant courant.

L'adresse contient votre clé : gardez-la privée. Si vous avez créé votre clé auparavant, la carte affiche l'adresse du connecteur suivie de ck_… : remplacez cette fin par votre clé complète. Si vous n'avez plus votre clé, créez-en une nouvelle.

Webhooks

Les webhooks envoient des événements à votre propre serveur au moment où ils se produisent, comme les nouveaux avis, demandes, prospects et contacts. Chaque envoi est signé, pour que votre serveur puisse vérifier qu'il vient bien de votre compte.

1. Sous Webhooks, cliquez sur Ajouter un webhook.
2. Saisissez votre URL de l'endpoint et choisissez les Événements souhaités, ou Tous les événements (y compris ceux ajoutés plus tard).
3. Cliquez sur Ajouter le webhook, puis copiez Votre secret de signature et conservez-le sur votre serveur. Vous ne pourrez plus le revoir.

Pour chaque webhook, vous pouvez Envoyer un test, ouvrir le Journal des envois pour voir chaque envoi et relancer un envoi échoué, le Désactiver, Changer le secret ou le Supprimer. Fonctionnement des webhooks donne les détails à votre développeur.

Questions fréquentes

Ma clé API est-elle la même chose que mon mot de passe ? Non. La clé sert uniquement aux logiciels et aux outils IA. Pour vous connecter à l'application, vous utilisez toujours votre e-mail et votre mot de passe.

Que devient ma clé si ma formule change ? Votre clé ne fonctionne que tant que votre formule inclut l'accès API.

OmniVizi peut-il créer une clé pour moi ? Oui. Une clé créée par OmniVizi affiche son nom comme créateur.