OdyOdy
Pruébalo gratis

API para desarrolladores

Tu teléfono de negocios,
ahora programable.

Cada contacto, conversación, mensaje y llamada en tu espacio de trabajo de Ody detrás de una API REST limpia | además de un servidor MCP para asistentes de IA, webhooks firmados y SDKs. Una sola clave, creada en minutos.

Autenticación Bearer · claves ody_live_ y ody_test_ · Configuración → API para desarrolladores

send-sms.sh | tu primera llamada a la API
# Envía un SMS desde tu número de 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 Created
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
Idempotency-Key en POST /messages | los reintentos dentro de 24h reproducen la primera respuesta
Paginación por cursor en cada endpoint de lista | sigue nextCursor, nunca te pierdas una fila
Encabezados estándar RateLimit-Limit / -Remaining / -Reset, Retry-After en 429
Envoltorio de error JSON uniforme con un eco de X-Request-Id en cada respuesta

LA PLATAFORMA

Todo lo que necesitas para desarrollar en Ody

Seis piezas, una clave de API. Diseñado para sentirse aburrido de la mejor manera: recursos predecibles, errores predecibles, páginas predecibles.

REST API

CRUD de contactos, conversaciones, envío de SMS/MMS, búsqueda de mensajes, historial de llamadas, números de teléfono, su agente de IA y su base de conocimientos en https://api.ody.co/v1/api | Autenticado con Bearer con su clave ody_live_.

GET /v1/api/contacts

MCP para asistentes de IA

Conecte ChatGPT, Claude o Cursor a https://api.ody.co/v1/mcp y su asistente obtendrá 29 herramientas | listar y actualizar contactos, leer conversaciones, buscar mensajes, enviar mensajes de texto, configurar el agente de IA, mantener su base de conocimientos | con alcance definido por su clave.

29 tools · /v1/mcp

Webhooks firmados

Webhooks salientes con firma HMAC de Standard-Webhooks | encabezados webhook-id, webhook-timestamp y webhook-signature | reintentos automáticos y secretos por endpoint que puedes rotar en cualquier momento.

webhook-signature: v1,…

Modo de prueba

Las claves ody_test_ se comportan exactamente como las claves en vivo, pero los envíos de mensajes son simulados | ningún SMS real se envía. Apunta tu CI a producción y duerme tranquilo.

"simulated": true

TypeScript & Python SDKs

Clientes oficiales, completamente tipados con auto-paginación, errores tipados, envíos idempotentes y verificación de firma de webhook incorporada | para que nunca más tengas que implementar HMAC manualmente.

await ody.messages.send(…)

OpenAPI 3.1

Toda la superficie se describe en una especificación legible por máquina en /v1/api/openapi.json | genera clientes, servidores simulados o simplemente aliméntala a tu agente de codificación de IA.

GET /v1/api/openapi.json

PRIVILEGIO MÍNIMO

Claves que solo hacen lo que tú dices

Cree claves en la aplicación Ody en Configuración → API de Desarrollador y restrinja cada una exactamente a los alcances que necesita una integración | doce alcances entre contactos, conversaciones, mensajes, números, llamadas, el agente de IA, conocimientos y webhooks. Una clave de panel de control de solo lectura nunca puede enviar un mensaje de texto a un cliente.

ody_live_… · clave con ámbito
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✓knowledge:read
✕knowledge:write
✕webhooks:manage

MODEL CONTEXT PROTOCOL

Pega un bloque, tu IA está al teléfono

La misma clave API alimenta el servidor MCP. Coloca esta configuración en ChatGPT, Claude o Cursor y pídele a tu asistente que se ponga al día con las conversaciones no leídas, redacte respuestas o envíe un mensaje de texto a un cliente, cada llamada limitada a lo que la clave permite.

Explora el servidor MCP→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

EMPIEZA A CONSTRUIR

De cero al primer SMS en cinco minutos

Obtén una clave, haz una llamada curl y habrás enviado un mensaje de texto. La referencia completa de la API, las guías de webhooks y las guías de inicio rápido del SDK se encuentran en dev.ody.co.

Las claves API son creadas por los propietarios y administradores del espacio de trabajo en Configuración → API de Desarrollador.

PREGUNTAS FRECUENTES

Preguntas de desarrolladores, respondidas

¿Qué puede hacer la API hoy?
CRUD completo de contactos; listar y leer conversaciones y establecer su estado; enviar SMS y MMS; buscar su historial de mensajes; obtener historial de llamadas y buzón de voz con transcripciones; listar, comprar y enrutar sus números de teléfono; configurar y publicar el agente de IA; y leer, escribir, buscar e importar a la base de conocimientos de la que responde cada IA. La referencia completa se encuentra en la documentación para desarrolladores en dev.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

Mejor con tu stack

La API es la superficie completa. Las integraciones son el camino sin código.

Las claves con ámbito, los webhooks y los SDK cubren todo lo que quieras construir. Slack, Make y CSV cubren las tareas que la mayoría de los equipos no deberían tener que programar.

MakeAutomatización

Un escenario en lugar de un manejador de webhook, cuando eso es suficiente.

Activa un escenario de Make desde un evento de llamada de Ody. Usa la API cuando necesites idempotencia, paginación y tu propio código. Usa Make cuando necesites una distribución hoy mismo.

Escenario ejecutado
MKon-call-completedID de ejecución devuelto
Distribución sin código
Ver la integración de Make→
SlackNotificaciones

Alertas de canal sin escribir la aplicación de Slack.

OAuth, elige un canal, listo. Las llamadas perdidas, los mensajes de voz y los resúmenes se publican allí. Crea tu propia solución con webhooks cuando necesites una carga útil diferente.

#front-desk
✦Missed call · Sophie TranOAuth con un clic
Sin bot que mantener
Ver la integración de Slack→
CSV importImportación de datos

Una importación de contactos sin POST /contacts en un bucle.

Sube un CSV cuando la lista ya esté en una hoja de cálculo. Usa la API de contactos cuando la fuente de verdad sea tu propio sistema.

Importación finalizada
✓customers-2026.csvDuplicados omitidos
Sin desarrollador
Ver importación CSV→
KlaviyoMarketing

Eventos de llamada en Klaviyo, sin un trabajo personalizado.

Envía el resultado de una llamada como un evento de Klaviyo para activar flujos. Construye lo mismo en la API si necesitas un destino diferente.

Evento de Klaviyo
STSophie TranResultado de llamada rastreado
Flows
Ver la integración de Klaviyo→
Explorar las 43 integraciones→

Nunca pierdas otro cliente.

Porta tu número, entrena a tu agente en minutos y pon tu línea en piloto automático. O mantén la IA completamente desactivada. Tú decides.