OdyOdy
Essayer gratuitement

API développeur

Votre téléphone professionnel,
désormais programmable.

Chaque contact, conversation, message et appel dans votre espace de travail Ody derrière une REST API épurée | plus un serveur MCP pour les assistants IA, des webhooks signés et des SDKs. Une seule clé, créée en quelques minutes.

Authentification Bearer · clés ody_live_ et ody_test_ · Paramètres → API Développeur

send-sms.sh | votre premier appel API
# Envoyer un SMS depuis votre numéro Ody
curl https://api.ody.co/v1/api/messages \
-H "Authorization: Bearer ody_live_…" \
-H "Idempotency-Key: order-1042-shipped" \
-d '{"to": "+15125550123", "body": "Your order shipped!"}'
201 Créé
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
Idempotency-Key sur POST /messages | les tentatives dans les 24h rejouent la première réponse
Pagination par curseur sur chaque point de terminaison de liste | suivez nextCursor, ne manquez jamais une ligne
En-têtes Standard RateLimit-Limit / -Remaining / -Reset, Retry-After sur 429
Enveloppe d'erreur JSON uniforme avec un écho X-Request-Id sur chaque réponse

LA PLATEFORME

Tout ce dont vous avez besoin pour développer sur Ody

Six éléments, une seule clé API. Conçu pour être d'une fiabilité rassurante : ressources prévisibles, erreurs prévisibles, pages prévisibles.

REST API

CRUD des contacts, conversations, envoi de SMS/MMS, recherche de messages, historique des appels et numéros de téléphone sur https://api.ody.co/v1/api | Authentifié par Bearer avec votre clé ody_live_.

GET /v1/api/contacts

MCP pour les assistants IA

Connectez ChatGPT, Claude ou Cursor à https://api.ody.co/v1/mcp et votre assistant dispose de 11 outils | lister et mettre à jour les contacts, lire les conversations, rechercher des messages, envoyer des SMS | définis par votre clé.

11 tools · /v1/mcp

Webhooks signés

Webhooks sortants avec signature HMAC Standard-Webhooks | en-têtes webhook-id, webhook-timestamp et webhook-signature | tentatives automatiques, et des secrets par point de terminaison que vous pouvez renouveler à tout moment.

webhook-signature: v1,…

Mode test

Les clés ody_test_ se comportent exactement comme les clés live, mais les envois de messages sont simulés | aucun vrai SMS n'est jamais envoyé. Dirigez votre CI vers la production et dormez tranquille.

"simulated": true

SDKs TypeScript & Python

Clients officiels, entièrement typés avec pagination automatique, erreurs typées, envois idempotents et vérification de la signature des webhooks intégrée | pour que vous n'ayez plus jamais à coder HMAC manuellement.

await ody.messages.send(…)

OpenAPI 3.1

L'ensemble de la surface est décrit dans une spécification lisible par machine à /v1/api/openapi.json | générez des clients, des serveurs mock, ou alimentez-en simplement votre agent de codage IA.

GET /v1/api/openapi.json

MOINDRE PRIVILÈGE

Des clés qui n'exécutent que vos instructions

Créez des clés dans l'application Ody sous Paramètres → API Développeur et limitez chacune d'elles aux scopes exacts dont une intégration a besoin | sept scopes couvrant les contacts, les conversations, les messages, les numéros et les webhooks. Une clé de tableau de bord en lecture seule ne peut jamais envoyer de SMS à un client.

ody_live_… · clé à portée limitée
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✕webhooks:manage

MODEL CONTEXT PROTOCOL

Collez un bloc, votre IA est au téléphone

La même clé API alimente le serveur MCP. Intégrez cette configuration dans ChatGPT, Claude ou Cursor et demandez à votre assistant de rattraper les conversations non lues, de rédiger des réponses ou d'envoyer un SMS à un client | chaque appel étant limité à ce que la clé autorise.

Explorer le serveur MCP→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

COMMENCEZ À CONSTRUIRE

De zéro au premier SMS en cinq minutes

Obtenez une clé, faites un appel curl, et vous avez envoyé un message. La référence API complète, les guides de webhook et les démarrages rapides des SDK se trouvent dans le centre d'aide.

Les clés API sont créées par les propriétaires et administrateurs d'espace de travail sous Paramètres → API Développeur.

FAQ

Questions des développeurs, réponses

Que peut faire l'API aujourd'hui ?
CRUD complet des contacts ; lister et lire les conversations et définir leur statut ; envoyer des SMS et des MMS ; rechercher dans l'historique de vos messages ; extraire l'historique des appels et des messages vocaux avec transcriptions ; et lister les numéros de téléphone de votre espace de travail. La référence complète se trouve dans la documentation développeur sur help.ody.co.

Resources

Learn more

Guides to the concepts behind this feature.

What businesses need to know about CPaaSLearn how CPaaS APIs differ from UCaaS employee calling and CCaaS contact-center suites, and where SIP and WebRTC still sit underneath.Read guide What businesses need to know about MCPHow the Model Context Protocol standardizes the connection between AI assistants and external systems, and what an MCP server for a phone system exposes.Read guide What engineers need to know about SIPHow RFC 3261 signaling (INVITE, ACK, BYE) relates to SDP, RTP media, trunks, and registration.Read guide

Mieux avec vos outils

L'API offre toutes les possibilités. Les intégrations sont le chemin sans code.

Les clés à portée limitée, les webhooks et les SDK couvrent tout ce que vous souhaitez créer. Slack, Make et CSV couvrent les tâches que la plupart des équipes ne devraient pas avoir à coder.

MakeAutomatisation

Un scénario au lieu d'un gestionnaire de webhook, quand cela suffit.

Déclenchez un scénario Make à partir d'un événement d'appel Ody. Utilisez l'API lorsque vous avez besoin d'idempotence, de pagination et de votre propre code. Utilisez Make lorsque vous avez besoin d'une diffusion aujourd'hui.

Exécution du scénario
MKon-call-completedID d'exécution retourné
Diffusion sans code
Voir l'intégration Make→
SlackNotifications

Alertes de canal sans écrire l'application Slack.

OAuth, choisissez un canal, c'est fait. Les appels manqués, les messages vocaux et les résumés y sont publiés. Créez le vôtre avec des webhooks lorsque vous avez besoin d'une charge utile différente.

#front-desk
✦Appel manqué · Sophie TranOAuth en un clic
Pas de bot à maintenir
Voir l'intégration Slack→
CSV importImportation de données

Une importation de contacts sans POST /contacts en boucle.

Téléchargez un CSV lorsque la liste existe déjà dans une feuille de calcul. Utilisez l'API de contacts lorsque la source de vérité est votre propre système.

Importation terminée
✓customers-2026.csvDoublons ignorés
Pas de développeur
Voir l'importation CSV→
KlaviyoMarketing

Événements d'appel dans Klaviyo, sans tâche personnalisée.

Envoyez un résultat d'appel comme événement Klaviyo pour déclencher des flux. Construisez la même chose sur l'API si vous avez besoin d'une destination différente.

Événement Klaviyo
STSophie TranRésultat d'appel suivi
Flux
Voir l'intégration Klaviyo→
Parcourir les 43 intégrations→

Ne manquez plus jamais un client.

Portez votre numéro, formez votre agent en quelques minutes et mettez votre ligne en pilote automatique. Ou désactivez complètement l'IA. C'est vous qui décidez.