# Claves API

Las claves API son opcionales. Complete el [registro](https://docs.voicelogica.ai/es/getting-started/sign-up/), la [suscripción](https://docs.voicelogica.ai/es/getting-started/activate-subscription/) y [su primer agent](https://docs.voicelogica.ai/es/getting-started/your-first-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**.

> **Note:** 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**.

     ![Pestaña API Keys con botón + Api Key](https://docs.voicelogica.ai/assets/getting-started/api-keys-0.png)

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.

     ![Cajón de crear clave API con nombre CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-1.png)

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.

     ![Grupos de restricción de operaciones API](https://docs.voicelogica.ai/assets/getting-started/api-keys-2.png)

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**.

     ![Diálogo Copiar su clave API](https://docs.voicelogica.ai/assets/getting-started/api-keys-3.png)

> **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.

  ![Tabla de claves API con CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-4.png)

- **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:

```bash
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](https://api.voicelogica.ai/api-docs).

> **Note:** 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](https://api.voicelogica.ai/api-docs), luego automatice con [Workflow Triggers](https://docs.voicelogica.ai/workflows/) - 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](mailto:support@voicelogica.ai)
- DESARROLLADORES [developers@voicelogica.ai](mailto:developers@voicelogica.ai)
- REFERENCIA API [api.voicelogica.ai/api-docs](https://api.voicelogica.ai/api-docs)