OdyOdy Ayuda

API para desarrolladores

Claves API, la API REST pública y el servidor MCP para integraciones de IA.

Obtén tu clave API de Ody
Crea, define el alcance y revoca claves API de Ody desde Configuración → API de Desarrollador. Elige el modo en vivo o de prueba — tu clave se muestra una sola vez, así que cópiala de inmediato.
Descripción general y autenticación de la API
Llame a la API REST de Ody en api.ody.co con una clave Bearer: contactos, conversaciones, mensajes, números y 10DLC, llamadas de IA, su agente y webhooks.
Conectar herramientas de IA con MCP
Agregue Ody como un servidor MCP para que ChatGPT, Claude y Cursor puedan gestionar su bandeja de entrada, enviar mensajes de texto, comprar números, realizar llamadas de IA y administrar su agente de IA.
Comprar números y registrar mensajería a través de la API
Busque y compre números de teléfono y registre la mensajería 10DLC a través de la API de Ody o MCP — la misma facturación, requisitos y cuenta que la aplicación.
Realizar llamadas de IA y gestionar Astra a través de la API
Haz que Astra realice llamadas salientes con POST /calls, configura y publica tu agente de IA, y enruta números hacia él — a través de la API REST de Ody o las herramientas MCP.
Límites de tasa de API y mejores prácticas
Cada clave API de Ody recibe 600 solicitudes por minuto. Lea los encabezados RateLimit, retroceda en los 429 y siga estas mejores prácticas de seguridad de claves.
Recibir webhooks y verificar firmas
Registra puntos finales de webhook HTTPS a través de la API de Ody, suscríbete a eventos como message.received y verifica entregas firmadas con tu secreto whsec_.
Desarrolle de forma segura con el modo de prueba
Cree una clave API ody_test_ para desarrollar con datos reales del espacio de trabajo mientras los envíos, las compras de números, las llamadas de IA y los registros 10DLC son simulados.
Paginación, idempotencia y manejo de errores
Pagina a través de listas de la API de Ody con cursores, reintenta envíos de forma segura con el encabezado Idempotency-Key y maneja el sobre de error uniforme y los ID de solicitud.
Inicio rápido del SDK: TypeScript y Python
Comience con los SDK de TypeScript y Python de Ody: envíe mensajes, compre números, realice llamadas de IA, administre su agente, pagine y verifique webhooks.