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

# Quick Start

> Create a multi-channel template and dispatch SMS and email in one call, with official WhatsApp notes.

<Tip>
  From **zero to first dispatch in the queue**: create the template, enable the channels you need, and call **`POST /v1/templates/send`**. Management (`templates:*`) and send (per-channel scopes) are **different** permission families.
</Tip>

## In short

* A template **does not need** all seven channels, enable only what you use.
* On send, **`channels`** must be a **subset** of enabled channels.
* **202** response = queued. Delivery → each **channel's** webhooks. Meta approval → **`template.*`** webhooks.

Context: [Introduction](/en/template-api/como-funciona/introducao). Scopes: [API Key scopes](/en/template-api/como-funciona/escopos-da-api-key). Official WhatsApp: [Official Meta templates](/en/template-api/como-funciona/templates-oficiais-meta).

## Before you start

* **Management:** `templates:create` (create), `templates:read` (list)
* **Send:** scope for **each** channel used (`sms:send`, `email:send`, `whatsapp:send`, …)
* **WhatsApp:** active instance. **Email:** verified domain. **Push:** app. **Voice:** ACTIVE number
* Auth: `Authorization: Bearer sk_live_...` or `x-api-key`
* Base URL: `https://api.notifique.dev`

***

## 1. Create template

#### 1A, Via dashboard

1. Templates → **New template**
2. Enable channels (SMS, email, WhatsApp, …)
3. Write content with `{{variables}}` and save

For **official WhatsApp**: after create, use **Sync** or **Publish to Meta** on the official instance, [full guide](/en/template-api/como-funciona/templates-oficiais-meta).

#### 1B, Via API

Scope: **`templates:create`**.

```http theme={null}
POST /v1/templates
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "order_alert",
  "category": "TRANSACTIONAL",
  "language": "pt_BR",
  "sms": {
    "enabled": true,
    "payload": { "content": "Order {{code}} shipped." }
  },
  "email": {
    "enabled": true,
    "payload": {
      "subject": "Order {{code}}",
      "html": "<p>Hi {{name}}, your order shipped.</p>"
    }
  },
  "whatsapp": { "enabled": false, "payload": {} },
  "telegram": { "enabled": false, "payload": {} },
  "rcs": { "enabled": false, "payload": {} },
  "push": { "enabled": false, "payload": {} },
  "voice": { "enabled": false, "payload": {} }
}
```

Expected response: **200** with `enabledChannels` (e.g. `["email","sms"]`).

Other channel payloads: [Variables and CRUD](/en/template-api/como-funciona/variaveis-disponiveis-e-crud).

***

## 2. Send by template

Scopes in this example: **`sms:send`**, **`email:send`**.

```http theme={null}
POST /v1/templates/send
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "template": "order_alert",
  "channels": ["sms", "email"],
  "to": ["5511999999999", "customer@email.com"],
  "variables": {
    "code": "12345",
    "name": "Maria"
  },
  "from": "hello@yourdomain.com",
  "fromName": "Notifique Team"
}
```

Expected response: **202**

```json theme={null}
{
  "success": true,
  "data": {
    "smsIds": ["clsms1..."],
    "emailIds": ["clemail1..."],
    "status": "QUEUED",
    "count": 2
  }
}
```

Only IDs for channels that **generated** sends appear. Per channel: `messageIds` (WhatsApp), `smsIds`, `emailIds`, `telegramIds`, `rcsIds`, `pushIds`, `voiceCallIds`.

### WhatsApp in the same template

Include `whatsapp` in `channels` and `instanceId` (if no workspace default):

```json theme={null}
{
  "template": "order_alert",
  "channels": ["whatsapp", "sms"],
  "to": ["5511999999999"],
  "variables": { "code": "12345", "name": "Maria" },
  "instanceId": "whatsapp_instance_id"
}
```

**Official line:** template must be **linked/approved on Meta** (`WHATSAPP_OFFICIAL`, `APPROVED`). See [Official Meta templates](/en/template-api/como-funciona/templates-oficiais-meta).

***

## 3. Track results

| What                                | Where                                                                                           |
| ----------------------------------- | ----------------------------------------------------------------------------------------------- |
| SMS, email, WhatsApp delivery       | **Channel** webhooks (`sms.delivered`, `message.sent`, …)                                       |
| Meta **approved/rejected** template | **`template.*`** webhooks, [Webhook events](/en/template-api/como-funciona/eventos-do-webhooks) |
| Validation / Meta errors            | [Error responses](/en/guides/conceitos/resposta-de-erros)                                       |

***

## Next steps

* [Official Meta templates](/en/template-api/como-funciona/templates-oficiais-meta): sync and approval
* [Variables and CRUD](/en/template-api/como-funciona/variaveis-disponiveis-e-crud): merge and edit
* [Scopes](/en/template-api/como-funciona/escopos-da-api-key): permissions
* [Webhook events](/en/template-api/como-funciona/eventos-do-webhooks): `template.*`