Sí. Suscríbete a eventos en tiempo real como message.received y call.completed, y Ody los enviará a tu punto final, firmados según la especificación Standard Webhooks | con un historial de entrega navegable y entregas de prueba incorporadas.

API para desarrolladores

Tu teléfono de negocios,
ahora programable.

Q: ¿Puedo desarrollar con la API sin enviar mensajes de texto reales?

Sí | crea una clave de prueba. Las claves de prueba acceden a los mismos puntos finales con las mismas estructuras, pero los envíos son simulados, por lo que puedes desarrollar y ejecutar CI sin que se envíe un solo SMS real. Usa una clave activa cuando implementes.

Q: ¿Hay SDKs oficiales?

Sí | TypeScript y Python. ¿Prefieres otro lenguaje? La superficie completa se envía como una especificación OpenAPI 3.1 en /v1/api/openapi.json, para que puedas generar un cliente para cualquier cosa.

Q: ¿Puede una clave de API acceder a otros espacios de trabajo?

No. Una clave está vinculada al espacio de trabajo en el que fue creada y actúa como el miembro que la creó | se aplican las mismas reglas de permiso que en la aplicación.

Q: ¿Qué planes incluyen acceso a la API?

Todos los planes | la API, los webhooks y el servidor MCP están incluidos a partir del plan Starter.

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.

Obtén tu clave de API→Lee la documentación

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 y números de teléfono en https://api.ody.co/v1/api | autenticado con Bearer y tu clave ody_live_.

GET /v1/api/contacts

MCP para asistentes de IA

Conecta ChatGPT, Claude o Cursor a https://api.ody.co/v1/mcp y tu asistente obtendrá 11 herramientas | listar y actualizar contactos, leer conversaciones, buscar mensajes, enviar textos | con ámbito definido por tu clave.

11 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

Crea claves en la aplicación Ody en Configuración → API para desarrolladores y limita cada una exactamente a los ámbitos que una integración necesita | siete ámbitos entre contactos, conversaciones, mensajes, números y webhooks. Una clave de panel de control de solo lectura nunca podrá enviar un mensaje a un cliente.

ody_live_… · clave con ámbito

✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✕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 los inicios rápidos de SDK se encuentran en el centro de ayuda.

Explora la documentación de la API→Abrir Configuración → API de Desarrollador

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 en tu historial de mensajes; obtener el historial de llamadas y buzón de voz con transcripciones; y listar los números de teléfono de tu espacio de trabajo. La referencia completa se encuentra en la documentación para desarrolladores en help.ody.co.

¿Puedo desarrollar con la API sin enviar mensajes de texto reales?

¿Hay webhooks?

¿Hay SDKs oficiales?

¿Puede una clave de API acceder a otros espacios de trabajo?

¿Qué planes incluyen acceso a la API?

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