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

# Claves API

> Crea y administra claves API para integrar servicios externos con tu cuenta de Jelou

Las claves API te permiten autenticar solicitudes a la API de Jelou desde aplicaciones o servicios externos. Con ellas puedes enviar mensajes, gestionar campañas, consultar conversaciones y más, de forma programática.

## Acceso a Claves API

Para gestionar tus claves API, dirígete a **Configuración** > **Claves API** en el menú lateral.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/settings-sidebar.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae70ce82a0d0a9c840af8a93191ad784" alt="Menú lateral de Configuración mostrando la opción Claves API en la sección General" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/settings-sidebar.png" />
</Frame>

Verás una tabla con todas las claves API existentes en tu cuenta, incluyendo:

* **Clave**: Identificador parcialmente oculto de la clave
* **Fecha de creación**: Cuándo fue generada
* **Acciones**: Opciones disponibles para cada clave

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-keys-list.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=ae8a8c68e75a94df0134eee969ae0f4b" alt="Vista de la tabla de Claves API mostrando las claves existentes con su fecha de creación y acciones disponibles" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-keys-list.png" />
</Frame>

## Crear una clave API

<Steps>
  <Step title="Inicia la creación">
    Haz clic en el botón **Crear** ubicado en la esquina superior derecha de la página.
  </Step>

  <Step title="Confirma la creación">
    Se mostrará un diálogo de confirmación. Haz clic en **Crear** para generar la nueva clave.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/create-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=6dcaa96abbf0f9a0017d1b81e61a0bcd" alt="Diálogo de confirmación para crear una nueva clave API" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/create-api-key-modal.png" />
    </Frame>
  </Step>

  <Step title="Copia tu clave">
    La clave generada se mostrará en pantalla. Usa el botón de copiar para guardarla en tu portapapeles.

    <Frame>
      <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/api-key-created.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=8c124f1e1fbb8b3cc7bd3babc0ac7519" alt="Diálogo mostrando la clave API recién creada con botón de copiar y advertencia de visibilidad única" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/api-key-created.png" />
    </Frame>

    <Warning>
      La clave solo se muestra **una vez**. Cópiala y guárdala en un lugar seguro antes de cerrar el diálogo. Si la pierdes, deberás crear una nueva.
    </Warning>
  </Step>
</Steps>

## Eliminar una clave API

Para eliminar una clave que ya no necesites, haz clic en el icono de eliminar (papelera) en la columna **Acciones** de la clave correspondiente.

Se mostrará un diálogo de confirmación antes de proceder.

<Frame>
  <img src="https://mintcdn.com/jelouai/08YACpW3IdmHicgd/assets/images/configuracion/api-keys/delete-api-key-modal.png?fit=max&auto=format&n=08YACpW3IdmHicgd&q=85&s=1536199cea71c2ac4a7d573bd0c99632" alt="Diálogo de confirmación para eliminar una clave API, advirtiendo que la acción no se puede deshacer" style={{ borderRadius: "0.5rem", width: "100%" }} width="3024" height="1722" data-path="assets/images/configuracion/api-keys/delete-api-key-modal.png" />
</Frame>

<Warning>
  Eliminar una clave API es una acción **irreversible**. Cualquier integración que utilice esa clave dejará de funcionar inmediatamente. Verifica que ningún servicio activo dependa de la clave antes de eliminarla.
</Warning>

## Usar tu clave API

Incluye la clave API en el header `x-api-key` de tus solicitudes HTTP:

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://gateway.jelou.ai/platform/v1/company/{companyId} \
    --header 'x-api-key: TU_CLAVE_API'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://gateway.jelou.ai/platform/v1/company/{companyId}",
    {
      headers: {
        "x-api-key": "TU_CLAVE_API",
      },
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://gateway.jelou.ai/platform/v1/company/{companyId}",
      headers={"x-api-key": "TU_CLAVE_API"},
  )
  ```
</CodeGroup>

<Tip>
  Consulta la [referencia de la API](/api/introduction) para conocer todos los endpoints disponibles.
</Tip>

## Buenas prácticas

* **No compartas claves** en repositorios públicos o mensajes. Usa variables de entorno para almacenarlas.
* **Rota tus claves periódicamente**. Crea una nueva clave, actualiza tus integraciones y elimina la anterior.
* **Usa una clave por integración**. Si una clave se compromete, podrás revocarla sin afectar otros servicios.