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

# Notify (fallback multicanal)

> Envíe con cascada declarada: WhatsApp, luego SMS, correo, etc., con waitMinutes entre pasos.

<Tip>
  **Notify** es el atajo para **cascadas**: declare hasta **5** pasos en `fallback[]`; Notifique encola el primer canal y, si está configurado, los siguientes tras `waitMinutes`.
</Tip>

## Endpoint

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

## Body

| Campo      | Obligatorio | Descripción                                             |
| ---------- | ----------- | ------------------------------------------------------- |
| `to`       | Sí          | 1–500 destinatarios (teléfono, correo, device ID, etc.) |
| `fallback` | Sí          | 1–5 pasos ordenados                                     |
| `metadata` | No          | Objeto JSON opcional                                    |

Cada paso en `fallback[]`:

| Campo                                                                     | Descripción                                                                 |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `channel`                                                                 | `whatsapp`, `sms`, `email`, `telegram`, `push`, `rcs`, `instagram`, `voice` |
| `waitMinutes`                                                             | Opcional (0–10080). Espera antes de este paso                               |
| `type`                                                                    | Tipo de mensaje opcional (`text`, `image`, `speak`, …)                      |
| `payload`                                                                 | Objeto específico del canal (se fusiona con campos flat)                    |
| `message`, `subject`, `html`, `text`, `from`, `title`, `body`, `appId`, … | Campos flat por canal                                                       |

## Alcances

Cada canal en `fallback` exige su alcance de envío:

| Canal     | Alcance          |
| --------- | ---------------- |
| WhatsApp  | `whatsapp:send`  |
| SMS       | `sms:send`       |
| Correo    | `email:send`     |
| Telegram  | `telegram:send`  |
| Push      | `push:send`      |
| RCS       | `rcs:send`       |
| Instagram | `instagram:send` |
| Voz       | `voice:call`     |

## Respuesta **202**

```json theme={null}
{
  "success": true,
  "data": {
    "steps": [
      { "channel": "whatsapp", "referenceId": "...", "status": "queued" }
    ],
    "sandbox": true
  }
}
```

Con `sk_test_...`, la respuesta puede incluir `sandbox: true` (inbox sandbox).

## Errores comunes

| HTTP / `code`                 | Situación                                   |
| ----------------------------- | ------------------------------------------- |
| **401** `UNAUTHORIZED`        | API Key inválida                            |
| **402** `WORKSPACE_BLOCKED`   | Plan/trial bloqueado                        |
| **403** `FORBIDDEN`           | Alcance ausente para un canal en `fallback` |
| **429** `SANDBOX_DAILY_LIMIT` | Límite diario sandbox                       |
| **400** `BAD_REQUEST`         | Payload inválido o fallo en cascada         |

Catálogo: [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

## Próximos pasos

* \[Magia de plantillas]\(/es/guides/simples assim/a-magia-dos-templates)
* [Alcances Platform](/es/platform-api/como-funciona/escopos-api-key)
* [Sandbox](/es/guides/sandbox/index)