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

# Inicio rápido

> Tu primera llamada a la API en 5 minutos.

**1. Crea una llave**

En el panel de Impulso entra a **Integraciones → Para desarrolladores → Crear llave**. Ponle un nombre
(«CRM de ventas»), marca los permisos que necesitas y elige los números.

> [!WARNING]
>
> La llave completa se muestra **una sola vez**. Guárdala en un lugar seguro (variables de entorno de tu servidor), nunca en el código del navegador.

**2. Pruébala**

```bash curl theme={null}
curl https://api.impulsodigital.app/v1/me \
  -H "Authorization: Bearer $IMPULSO_API_KEY"
```

```javascript Node theme={null}
const r = await fetch('https://api.impulsodigital.app/v1/me', {
  headers: { Authorization: `Bearer ${process.env.IMPULSO_API_KEY}` },
})
console.log(await r.json())
```

```python Python theme={null}
import os, requests
r = requests.get("https://api.impulsodigital.app/v1/me",
                 headers={"Authorization": f"Bearer {os.environ['IMPULSO_API_KEY']}"})
print(r.json())
```

Responde el negocio y lo que puede hacer la llave:

```json theme={null}
{ "data": { "account": { "id": "…", "name": "Mi Tienda" },
            "key": { "name": "CRM de ventas", "prefix": "imp_live_ab12cd", "scopes": ["mensajes", "conversaciones"], "numbers": "all" } } }
```

**3. Envía un mensaje**

A un cliente que te escribió en las últimas 24 horas:

```bash theme={null}
curl -X POST https://api.impulsodigital.app/v1/messages \
  -H "Authorization: Bearer $IMPULSO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1234-enviado" \
  -d '{ "to": "573001234567", "type": "text", "text": "Hola Ana, tu pedido salió hoy 🚚" }'
```

Si no te ha escrito en 24 horas, envía una [plantilla aprobada](https://docs.impulsodigital.app/conceptos/ventana-24h.md).

**4. Recibe lo que pasa**

Crea un [aviso](https://docs.impulsodigital.app/guias/avisos.md) para que Impulso le cuente a tu sistema cada mensaje nuevo, pedido o cambio de etapa.


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