Obtén tu clave API de Ody

Creas claves API en Configuración → API de Desarrollador: nombra la clave, elige sus alcances, selecciona En vivo o Prueba, haz clic en Crear clave y copia el secreto del banner que aparece una sola vez.

Antes de empezar

• Debes ser administrador o propietario del espacio de trabajo para crear o revocar claves.
• Las claves actúan como el miembro que las creó — nunca pueden hacer más de lo que esa persona puede hacer en la aplicación.

Paso a paso

1. Haz clic en Configuración en la barra lateral, luego en API de Desarrollador. (En tu teléfono: Más → Configuración → API de Desarrollador.)

2. En el formulario de creación, ingresa un nombre para la clave — por ejemplo, "Zapier" o "Servidor de producción" — para que puedas distinguir las claves más tarde.

3. Elige los alcances de la clave usando las etiquetas debajo del campo de nombre. Las diez están preseleccionadas, lo que crea una clave de acceso total; deselecciona las etiquetas para restringirlo. Los alcances disponibles son Leer contactos, Administrar contactos, Leer conversaciones, Actualizar conversaciones, Enviar mensajes, Leer números, Administrar webhooks, Comprar números y 10DLC, Realizar llamadas de IA y Administrar agente de IA.

4. En Tipo de clave, elige En vivo o Prueba. Las claves en vivo comienzan con ody_live_ y hacen todo de verdad. Las claves de prueba comienzan con ody_test_ y leen datos reales, pero los envíos de mensajes se registran como simulados y nunca se transmiten — perfecto para la construcción y CI. Consulta Construye de forma segura con el modo de prueba.

5. Haz clic en Crear clave.

6. Copia la clave del banner verde — "Copia tu nueva clave ahora — no la volverás a ver." Ody solo almacena un hash, por lo que el texto sin formato se muestra exactamente una vez.

7. Almacena la clave como una contraseña — en un gestor de secretos o variable de entorno, nunca en código del lado del cliente o en un documento compartido.

Administrar claves existentes

Debajo del formulario de creación, cada clave se lista con su nombre, una pista enmascarada (ody_live_…WXYZ o ody_test_…WXYZ), una insignia de Prueba para las claves de prueba, sus alcances como etiquetas ("Acceso total" cuando no está restringido), y cuándo fue utilizada por última vez. Haz clic en Revocar para deshabilitar una clave de inmediato — las claves revocadas dejan de autenticarse al instante y no se pueden restaurar.

Artículos relacionados

• Descripción general de la API y autenticación
• Construye de forma segura con el modo de prueba
• Conecta herramientas de IA con MCP
• Límites de tasa de la API y mejores prácticas