API développeur
Clés API, l'API REST publique et le serveur MCP pour les intégrations IA.
Obtenir votre clé API Ody
Créez, définissez la portée et révoquez les clés API Ody depuis Paramètres → API Développeur. Choisissez le mode Live ou Test — votre clé n'est affichée qu'une seule fois, copiez-la immédiatement.
Présentation de l'API et authentification
Appelez l'API REST Ody à api.ody.co avec une clé Bearer : contacts, conversations, messages, numéros et 10DLC, appels IA, votre agent et webhooks.
Connecter les outils d'IA avec MCP
Ajoutez Ody comme serveur MCP pour que ChatGPT, Claude et Cursor puissent gérer votre boîte de réception, envoyer des SMS, acheter des numéros, passer des appels IA et gérer votre agent IA.
Acheter des numéros et enregistrer la messagerie via l'API
Recherchez et achetez des numéros de téléphone et enregistrez la messagerie 10DLC via l'API Ody ou MCP — même facturation, mêmes passerelles et même compte que l'application.
Passer des appels IA et gérer Astra via l'API
Faites composer des numéros par Astra avec POST /calls, configurez et publiez votre agent IA, et acheminez des numéros vers celui-ci — via l'API REST Ody ou les outils MCP.
Limites de débit de l'API et meilleures pratiques
Chaque clé API Ody reçoit 600 requêtes par minute. Lisez les en-têtes RateLimit, reculez en cas de 429, et suivez ces meilleures pratiques de sécurité des clés.
Recevoir des webhooks et vérifier les signatures
Enregistrez des points de terminaison de webhook HTTPS via l'API Ody, abonnez-vous à des événements comme message.received et vérifiez les livraisons signées avec votre secret whsec_.
Développer en toute sécurité avec le mode test
Créez une clé API ody_test_ pour développer avec des données d'espace de travail réelles, tandis que les envois, les achats de numéros, les appels IA et les dépôts 10DLC sont simulés.
Pagination, idempotence et gestion des erreurs
Parcourez les listes de l'API Ody avec des curseurs, réessayez les envois en toute sécurité avec l'en-tête Idempotency-Key, et gérez l'enveloppe d'erreur uniforme et les ID de requête.
Démarrage rapide du SDK : TypeScript et Python
Démarrez avec les SDK TypeScript et Python d'Ody — envoyez des messages, achetez des numéros, passez des appels IA, gérez votre agent, paginez et vérifiez les webhooks.