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

# Autenticación

> Llaves por cuenta, permisos y números.

Cada petición lleva una llave de la cuenta en la cabecera:

```http theme={null}
Authorization: Bearer imp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

También se acepta `X-API-Key: imp_live_…`.

## Quién crea las llaves

* El dueño de la cuenta (o quien tenga el permiso **Tienda en línea, CRM y desarrolladores** y atienda todos los números), en **Integraciones → Para desarrolladores**.
* Si tu cuenta la maneja un socio de Impulso, el socio también puede crearlas desde su panel.

La llave completa se muestra una sola vez; después solo se ve su prefijo (`imp_live_ab12cd`). **Revocar es inmediato.**
Cada creación y revocación queda en el historial de la cuenta.

## Permisos

| Permiso | Qué permite |
| - | - |
| `mensajes` | Enviar textos, archivos y plantillas; ver el estado de un mensaje |
| `conversaciones` | Leer conversaciones y sus mensajes; pasarlas al equipo o al agente; cambiar la etapa |
| `contactos` | Leer, crear y actualizar contactos |
| `plantillas` | Leer las plantillas de WhatsApp |
| `programados` | Programar, listar y cancelar mensajes |
| `avisos` | Manejar los avisos (webhooks) de la cuenta |

Sin el permiso la API responde `403 INSUFFICIENT_SCOPE`.

## Números

Una llave puede usar **todos los números** de la cuenta o **solo algunos**. Una llave limitada solo ve las
conversaciones y contactos de sus números; lo demás responde `404`, como si no existiera. Los avisos son de toda la
cuenta, así que solo se manejan con una llave de todos los números (`403 KEY_RESTRICTED_TO_NUMBERS`).

> [!WARNING]
>
> Usa la llave solo desde tu servidor. Nunca la pongas en el código de una página web o una app móvil: cualquiera podría verla.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.