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

> Envie com cascata declarada: tenta WhatsApp, depois SMS, e-mail, etc., com waitMinutes entre passos.

<Tip>
  **Notify** é o atalho para **cascata**: você declara até **5** passos em `fallback[]`; a Notifique enfileira o primeiro canal e, se configurado, os seguintes após `waitMinutes`.
</Tip>

## Endpoint

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

## Body

| Campo      | Obrigatório | Descrição                                               |
| ---------- | ----------- | ------------------------------------------------------- |
| `to`       | Sim         | 1–500 destinatários (telefone, e-mail, device ID, etc.) |
| `fallback` | Sim         | 1–5 passos ordenados                                    |
| `metadata` | Não         | Objeto JSON anexado ao fluxo                            |

Cada passo em `fallback[]`:

| Campo                                                                     | Descrição                                                                   |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `channel`                                                                 | `whatsapp`, `sms`, `email`, `telegram`, `push`, `rcs`, `instagram`, `voice` |
| `waitMinutes`                                                             | Opcional (0–10080). Espera antes deste passo na cascata                     |
| `type`                                                                    | Opcional. Tipo de mensagem (`text`, `image`, `speak`, …)                    |
| `payload`                                                                 | Opcional. Objeto específico do canal (mescla com campos flat)               |
| `message`, `subject`, `html`, `text`, `from`, `title`, `body`, `appId`, … | Campos flat por canal                                                       |

## Escopos

Cada canal no `fallback` exige o escopo de envio correspondente:

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

## Resposta **202**

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

Com `sk_test_...`, a resposta pode incluir `sandbox: true` (Inbox sandbox).

## Erros comuns

| HTTP / `code`                 | Situação                                   |
| ----------------------------- | ------------------------------------------ |
| **401** `UNAUTHORIZED`        | API Key inválida                           |
| **402** `WORKSPACE_BLOCKED`   | Plano/trial bloqueado                      |
| **403** `FORBIDDEN`           | Escopo ausente para um canal em `fallback` |
| **429** `SANDBOX_DAILY_LIMIT` | Limite diário sandbox                      |
| **400** `BAD_REQUEST`         | Payload inválido ou falha na cascata       |

Catálogo: [Respostas de erro](/guides/conceitos/resposta-de-erros).

## Próximos passos

* \[Templates multicanal]\(/guides/simples assim/a-magia-dos-templates)
* [Escopos Platform](/platform-api/como-funciona/escopos-api-key)
* [Sandbox](/guides/sandbox/index)