Claves API

Las claves API son opcionales. Complete el registro, la suscripción y su primer agent antes de necesitarlas.

Son credenciales programáticas para la API de Voice Logica. Cada clave tiene alcance a las operaciones que usted permite y puede limitarse a una dirección IP. La misma clave también autentica clientes MCP (ChatGPT, Claude) en su espacio de trabajo.

Abra Team and access desde el grupo Account en la barra lateral, luego seleccione la pestaña API Keys. Esa página también tiene Members, Pending invitations y Access Requests.

Nota

Las claves para proveedores de IA (OpenAI, ElevenLabs, …) se encuentran en la página AI Provider Keys, no aquí.

Crear una clave API

1. Abra API Keys e inicie una nueva clave

   En la pestaña API Keys, haga clic en + Api Key.

   

   api-keys-0Expand

2. Elija una configuración predeterminada, nombre la clave y establezca una IP si es necesario

   El cajón Create API key se abre a la derecha.

   • Preset - comience desde Full access (todas las operaciones) u otra configuración predeterminada, luego refine a continuación.
   • API Key Name - use un nombre de propósito claro como CRM Integration, Webhook Handler o Initiate Call.
   • IP Address - opcional. Déjelo en blanco para permitir cualquier IP. Solo ingrese una dirección real cuando el llamador tenga una IP fija. No ingrese 0.0.0.0 como sustituto de “cualquier IP”; en blanco ya significa cualquier IP.

   

   api-keys-1Expand

3. Elija las operaciones permitidas

   En API operation restrictions, expanda cada grupo y active lo que esta clave puede llamar. Los grupos incluyen Calls, Agents, Workflows, VoIP & SIP, SMS, MCP, Billing, Shopify y Campaigns. Deje todo activado para acceso completo, o desactive lo que la clave no necesita.

   

   api-keys-2Expand

4. Cree la clave y cópiela una vez

   Haga clic en Create API Key. El diálogo Copy your API key muestra el valor completo solo esta vez. Haga clic en Copy, almacene la clave en un lugar seguro, luego haga clic en Done.

   

   api-keys-3Expand

La clave se muestra solo una vez

Después de cerrar ese diálogo, la tabla solo muestra una clave enmascarada. No puede ver el valor completo nuevamente. Si lo pierde, revoque la clave y cree una nueva.

Mínimo privilegio

Otorgue solo las operaciones que una clave necesita, use una clave separada por integración y establezca una restricción de IP cuando el llamador tenga una dirección fija. Si se expone una clave, revóquela inmediatamente.

Gestionar sus claves

La tabla enumera el Name (nombre), Key (clave enmascarada), Last Used (última vez usado) y fecha Created (creado) de cada clave. Use la búsqueda para encontrar una clave por nombre.

api-keys-4Expand

• Edit (lápiz) - cambie el nombre, la restricción de IP y las operaciones permitidas. El valor secreto en sí nunca aparece de nuevo y no se puede rotar en su lugar.
• Revoke (papelera) - abre Revoke API key? Confirme con Revoke para eliminar permanentemente la clave. Las aplicaciones que la usen pierden acceso inmediatamente. No hay una acción Eliminar separada.

Usar su clave API

Autentique solicitudes enviando la clave en el encabezado x-api-key:

x-api-key: YOUR_API_KEY

Por ejemplo, iniciar una llamada de IA saliente:

curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationNumber": "+302101234567",
    "agentId": "your-agent-id",
    "voipPhoneId": "your-voip-phone-id"
  }'

destinationNumber es requerido; pase agentId para llamadas de IA salientes, y ya sea voipPhoneId o sipTrunkId para elegir la línea por la que sale la llamada. La referencia interactiva completa para cada endpoint se encuentra en api.voicelogica.ai/api-docs.

Nota

Las llamadas salientes respetan las reglas de llamadas del país de destino por defecto - por ejemplo, no hay llamadas entre las 21:00-09:00 hora local. La API expone banderas de anulación explícitas si su caso de uso las requiere; las llamadas entrantes nunca están restringidas.

Solución de problemas

Mis solicitudes devuelven 401 Unauthorized

• Confirme que la clave se envía en el encabezado x-api-key - no como un token Bearer.
• Verifique que la clave no haya sido revocada de la tabla API Keys.
• Si la clave tiene una restricción de IP, verifique que la solicitud provenga de esa dirección exacta.

Mis solicitudes devuelven 403 Forbidden

• Las restricciones de operación de la clave no incluyen el endpoint que está llamando - edite la clave y habilite el grupo de operaciones relevante.

Próximos pasos

Construya sobre la API

Explore la referencia interactiva de la API, luego automatice con Workflow Triggers - o conecte un cliente MCP como ChatGPT o Claude a su espacio de trabajo usando la misma clave.

¿Necesita ayuda?

Si tiene algún problema, el equipo de soporte de Voice Logica está disponible:

CORREO ELECTRÓNICO

support@voicelogica.ai

DESARROLLADORES

developers@voicelogica.ai

REFERENCIA API

api.voicelogica.ai/api-docs