> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sofiachat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraciones y API

> Crear y administrar API keys para conectar Sofia Chat con tus sistemas.

<Info>Configuración → **API** · Owner y Admin crean; solo Owner revoca</Info>

La API permite que tus sistemas (CRM, ERP, sitio web, herramientas de automatización) usen Sofia Chat sin el panel: enviar notificaciones por WhatsApp, sincronizar clientes y contactos, lanzar campañas o leer conversaciones. La documentación técnica está en la [Guía para desarrolladores](/desarrolladores/introduccion) y la [Referencia de API](/referencia-de-api).

## Crear una API key

Una API key es la contraseña con la que un sistema se identifica ante la API. Trátala como tal: no la compartas ni la publiques.

<Steps>
  <Step title="Nueva key">
    Pulsa **Nueva key** y completa:

    | Campo          | Notas                                                                                                                                 |
    | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
    | **Nombre**     | Identifica el sistema que la usará: *ERP facturación*, *Integración con HubSpot*.                                                     |
    | **Permisos**   | **Lectura** (consultar) y/o **Escritura** (crear y modificar). Da solo los necesarios: un tablero que solo lee no necesita escritura. |
    | **Expiración** | **Nunca**, 30, 90 o 365 días. Para integraciones permanentes, *Nunca*; para pruebas o proveedores externos, una fecha.                |
  </Step>

  <Step title="Cópiala">
    La key completa se muestra **una sola vez**. Cópiala con **Copiar** y guárdala en el gestor de secretos de tu equipo técnico. Al cerrar, el panel te pide confirmar que ya la guardaste: si la pierdes, no se puede recuperar; habrá que revocarla y crear otra.
  </Step>

  <Step title="Entrégala a tu equipo técnico">
    Con la key y la [guía para desarrolladores](/desarrolladores/autenticacion) pueden hacer la primera llamada en minutos.
  </Step>
</Steps>

## La tabla de keys

| Columna        | Qué muestra                                                                                                                              |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Prefijo**    | Los primeros caracteres (`sk_live_a1b2…`), para identificar cuál es cuál sin exponerla.                                                  |
| **Permisos**   | Lectura / Escritura.                                                                                                                     |
| **Último uso** | Cuándo se usó por última vez, o *Sin uso*. Una key que lleva meses sin uso probablemente pertenece a una integración retirada: revócala. |
| **Estado**     | **Activa** · **Expirada** · **Revocada**.                                                                                                |

Máximo **10 keys activas** por organización.

## Revocar

**Revocar** (solo Owner) invalida la key de inmediato y de forma permanente; la integración que la use dejará de tener acceso. Hazlo si sospechas que se filtró, cuando un proveedor deje de trabajar contigo, o al retirar una integración.

<Tip>
  **Una key por sistema.** Si tres integraciones comparten la misma key y una se ve comprometida, tendrás que revocarla y reconfigurar las tres. Con una key por sistema, revocas solo la afectada.
</Tip>