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

# Empieza aquí

> De cero a tu primer envío exitoso en unos pocos pasos.

<Tip>
  Esta guía es tu **primera carta en el correo**: en unos pocos pasos pasas de la cuenta a tu primer `HTTP 202`, confirmación de que Notifique recibió tu envío.
</Tip>

## ¿Qué es esta guía?

Es el camino más corto desde **la cuenta hasta el primer envío**. Documentación por desarrolladores, para desarrolladores: directa, sin jerga legal.

Notifique es la **infraestructura de mensajería** de tu producto. Las colas, los reintentos y los protocolos permanecen de nuestro lado; obtienes una **API REST** predecible.

## ¿Qué lograrás?

Al final de esta guía:

* **Cuenta** creada en el panel
* **API Key** guardada (`sk_test_` o `sk_live_`)
* **Primer mensaje** en cola en SMS o WhatsApp

## ¿Por dónde empezar?

Para tu primer envío, **SMS** o **WhatsApp** suele ser la ruta más corta:

| Canal        | Por qué empezar aquí                                      |
| ------------ | --------------------------------------------------------- |
| **SMS**      | Una llamada HTTP, sin emparejar teléfono                  |
| **WhatsApp** | Empareja tu número con un código QR y luego envía vía API |

Otros canales (correo electrónico, push, Telegram) tienen sus propios inicios rápidos cuando los necesites.

## Paso a paso

### 1. Crea tu cuenta

[**Crea tu cuenta en el Panel**](https://app.notifique.dev)

Completa la incorporación para obtener acceso completo a tu Workspace.

### 2. Crea una API Key

En el panel, abre **Developer → API Keys**. Ponle un nombre, selecciona [scopes](/es/guides/api-key/index#scopes-and-permissions) para el canal que probarás y cópiala de inmediato.

<Warning>
  Las claves comienzan con `sk_live_...` o `sk_test_...`. Después de cerrar el modal, no volvemos a mostrar el valor completo. Guárdala en `.env` o en el administrador de secretos de tu proyecto.
</Warning>

* **Producción** (`sk_live_...`): envíos reales, usa créditos, el mensaje puede llegar a un teléfono real
* **Sandbox** (`sk_test_...`): mismos endpoints, sin entrega real. Revisa **Developer → Bandeja de entrada Sandbox**

Recomendamos comenzar con `sk_test_...`. Más información en [Sandbox](/es/guides/sandbox/index) y [API Keys](/es/guides/api-key/index).

### 3. Envía tu primer mensaje

Reemplaza `YOUR_API_KEY` con la clave que generaste.

#### SMS

Usa tu número en formato internacional (por ejemplo, `5511999999999`). El texto del mensaje debe tener entre 9 y 160 caracteres.

```http theme={null}
POST https://api.notifique.dev/v1/sms/messages
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
```

```json theme={null}
{
  "to": ["5511999999999"],
  "type": "text",
  "payload": {
    "message": "¡Hola! Primer SMS con Notifique."
  }
}
```

Respuesta esperada: `HTTP 202` con el mensaje en cola. Con `sk_live_`, va al operador. Con `sk_test_`, abre **Developer → Bandeja de entrada Sandbox** para ver el envío simulado.

Guía completa: [Inicio rápido SMS](/es/sms-api/como-funciona/quick-start).

#### WhatsApp

Necesitas una Instance emparejada y los scopes `whatsapp:instances:create`, `whatsapp:instances:list` y `whatsapp:send`.

**Crea la Instance y obtén el QR**

```http theme={null}
POST https://api.notifique.dev/v1/whatsapp/instances
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
```

```json theme={null}
{
  "name": "Mi instancia"
}
```

En la respuesta, usa `connection.base64` para mostrar el QR y escanéalo en tu teléfono. Cuando el estado es `ACTIVE`, anota `instance.id`.

**Enviar texto**

```http theme={null}
POST https://api.notifique.dev/v1/whatsapp/messages
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
```

```json theme={null}
{
  "instanceId": "INSTANCE_ID",
  "to": ["5511999999999"],
  "type": "text",
  "payload": {
    "message": "¡Hola! Primer mensaje de WhatsApp."
  }
}
```

Respuesta esperada: `HTTP 202`. Con `sk_live_` y una Instance activa, el mensaje pasa a WhatsApp. Con `sk_test_`, revisa **Developer → Bandeja de entrada Sandbox**.

Guía completa: [Inicio rápido WhatsApp](/es/whatsapp-api/como-funciona/quick-start).

## ¿Listo?

Si obtuviste `HTTP 202`, la integración básica funciona. La carta salió de tu sistema y entró en la cola de Notifique.

***

## Próximos pasos

* [API Keys](/es/guides/api-key/index): scopes, mejores prácticas y rotación de claves
* [Sandbox](/es/guides/sandbox/index): prueba de forma segura antes de la puesta en marcha
* [Webhooks](/es/guides/webhooks/index): recibe alertas de entrega en tu servidor
* [Logs](/es/guides/logs/index): depura llamadas a la API