Obtenir votre clé API Ody
Vous créez des clés API dans Paramètres → API Développeur : nommez la clé, choisissez ses portées, sélectionnez Live ou Test, cliquez sur Créer la clé, et copiez le secret depuis la bannière unique.
Avant de commencer
- Vous devez être un administrateur ou propriétaire d'espace de travail pour créer ou révoquer des clés.
- Les clés agissent en tant que membre qui les a créées — elles ne peuvent jamais faire plus que ce que cette personne peut faire dans l'application.
Étape par étape
Cliquez sur Paramètres dans la barre latérale, puis sur API Développeur. (Sur votre téléphone : Plus → Paramètres → API Développeur.)
Dans le formulaire de création, saisissez un nom de clé — par exemple "Zapier" ou "Serveur de production" — afin de pouvoir distinguer les clés plus tard.
Choisissez les portées de la clé à l'aide des puces sous le champ du nom. Les dix sont présélectionnées, ce qui crée une clé à accès complet ; désélectionnez les puces pour la restreindre. Les portées disponibles sont Lire les contacts, Gérer les contacts, Lire les conversations, Mettre à jour les conversations, Envoyer des messages, Lire les numéros, Gérer les webhooks, Acheter des numéros et 10DLC, Passer des appels IA, et Gérer l'agent IA.
Sous Type de clé, choisissez Live ou Test. Les clés Live commencent par
ody_live_et effectuent toutes les actions pour de vrai. Les clés Test commencent parody_test_et lisent des données réelles, mais les envois de messages sont enregistrés comme simulés et jamais transmis — parfait pour le développement et l'intégration continue. Voir Développer en toute sécurité avec le mode test.Cliquez sur Créer la clé.
Copiez la clé depuis la bannière verte — "Copiez votre nouvelle clé maintenant — vous ne la reverrez plus." Ody ne stocke qu'un hachage, donc le texte en clair n'est affiché qu'une seule fois.
Stockez la clé comme un mot de passe — dans un gestionnaire de secrets ou une variable d'environnement, jamais dans du code côté client ou un document partagé.
Gérer les clés existantes
Sous le formulaire de création, chaque clé est listée avec son nom, un indice masqué (ody_live_…WXYZ ou ody_test_…WXYZ), un badge Test pour les clés de test, ses portées sous forme de puces ("Accès complet" lorsqu'il n'est pas restreint), et la date de sa dernière utilisation. Cliquez sur Révoquer pour désactiver une clé immédiatement — les clés révoquées cessent d'authentifier instantanément et ne peuvent pas être restaurées.
Articles connexes
Questions fréquemment posées
J'ai perdu ma clé API — puis-je la revoir ?
Non. La clé complète n'est affichée qu'une seule fois, lors de sa création. Révoquez la clé perdue et créez-en une nouvelle.
Quelle est la différence entre une clé Live et une clé Test ?
Les clés Live (ody_live_…) envoient de vrais SMS. Les clés Test (ody_test_…) se comportent de manière identique mais les envois de messages sont simulés — enregistrés dans le fil de discussion, jamais transmis.
Qui peut créer des clés API ?
Les administrateurs et propriétaires d'espace de travail. Les clés agissent avec les permissions du membre qui les a créées.
Quels forfaits incluent l'API ?
Tous — l'API et le MCP sont inclus à partir du forfait Starter.