---
title: Как создать шаблон WhatsApp в Multi API
description: Создание шаблона WhatsApp в Multi API — категории, типы, переменные, статусы, использование через API
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.




> **Коротко:** шаблон WhatsApp — это предварительно одобренное сообщение. Создаётся в разделе «Активы» → «Шаблоны WhatsApp».

## Кому подходит

- Роль: Клиент, Разработчик
- Уровень: Опытный

## Что это

**Шаблон WhatsApp** — статично определённое содержимое, которое регистрируется в WhatsApp и проходит процесс одобрения. Свободные сообщения (без шаблона) можно отправлять только как ответ в 24-часовом окне.

**В Multi API** шаблоны WhatsApp:

- Создаются в личном кабинете — **Активы** → **Шаблоны WhatsApp**.
- Отправляются через API — параметр `template.id`.
- Проверяются через API — `GET /wa_templates`.

## Возможности шаблона WhatsApp

| # | Возможность | Что даёт |
|---|---|---|
| 1 | **Неограниченное количество** | Для каждого имени отправителя — без ограничений по количеству |
| 2 | **Три категории** | Marketing, Utility, Authentication |
| 3 | **Разные типы** | Карточка, Карусель, Код купона, Ограниченное предложение, Каталог, Аутентификация |
| 4 | **Числовые переменные** | Персонализация через `{{1}}`, `{{2}}` |
| 5 | **Локализуемые переменные** | Currency (валюта) и Date Time (дата и время) |
| 6 | **Предварительно одобренные шаблоны** | Готовые из библиотеки — быстро получают статус **Одобренный** |
| 7 | **Zero-Tap и One-Tap** | Автоматическая подстановка кода для Authentication |
| 8 | **Рейтинг качества** | Оценка на основе отзывов и активности |
| 9 | **Синхронизация** | Ручная синхронизация со статусами WhatsApp |
| 10 | **Отправка через API** | Параметр `template.id` в OMNI API |

## Перед началом

- [ ] У вас есть имя отправителя WhatsApp со статусом **Активно**.
- [ ] Вы работаете в разделе **Активы** → **Шаблоны WhatsApp**.
- [ ] Вы определили категорию шаблона: Marketing, Utility или Authentication.

## Как создать шаблон

### 1. Нажмите «Добавить шаблон WhatsApp»

Кнопка в правом верхнем углу раздела **Активы** → **Шаблоны WhatsApp**.

Доступны два варианта:

- **Общий** — создать шаблон с нуля.
- **Предварительно одобрено** — выбрать из библиотеки готовых шаблонов.

### 2. Укажите имя отправителя

В поле **Отправитель** выберите имя со статусом **Активно**.

### 3. Введите название шаблона

Название — **внутреннее имя**, получатели его не увидят.

<Warning>
Только **строчные латинские буквы, цифры и подчёркивания**. Без пробелов, заглавных букв и дефисов.

Пример: `discount_50_percent_march`
</Warning>

### 4. Выберите категорию

| Категория | Для чего |
|---|---|
| **Marketing** | Рекламные предложения, анонсы, коммерческие сообщения |
| **Utility** | Транзакции, уведомления, выписки |
| **Authentication** | Коды аутентификации |

### 5. Выберите тип шаблона

Тип зависит от категории:

**Marketing:**

- Карточка.
- Карусель.
- Код купона.
- Ограниченное предложение.
- Каталог.

**Utility:**

- Карточка.

**Authentication:**

- Аутентификация.

### 6. Выберите язык

Укажите язык шаблона — получатель увидит текст на этом языке.

### 7. Настройте период действия сообщения

Период — время, в течение которого WhatsApp пытается доставить сообщение.

| Категория | Период по умолчанию |
|---|---|
| Marketing | 30 дней |
| Utility | 30 дней |
| Authentication | 10 минут |

### 8. Настройте содержимое

Содержимое зависит от типа шаблона.

- Для **Карточки** — заголовок, текст, кнопки.
- Для **Карусели** — от 2 до 10 карточек одного формата.
- Для **Аутентификации** — предустановленный текст, кнопки **Копировать код**, **Zero-Tap** или **One-Tap**.

Подробнее о настройке каждого типа:

- [Обзор шаблонов WhatsApp →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-overview)
- [Как создать шаблон →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-how-to-create)

### 9. Сохраните

Доступны три действия:

- **Сохранить в черновик** — шаблон остаётся в системе, не отправляется на одобрение.
- **Сохранить** — шаблон сохраняется и отправляется на одобрение в WhatsApp.
- **Отменить** — отмена.

## Категории и типы

| Категория | Типы |
|---|---|
| **Marketing** | Карточка, Карусель, Код купона, Ограниченное предложение, Каталог |
| **Utility** | Карточка |
| **Authentication** | Аутентификация |

<Note>
Полное описание типов — в статьях канала:

- [Шаблон «Карточка» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-card)
- [Шаблон «Карусель» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-carousel)
- [Шаблон «Код купона» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-coupon)
- [Шаблон «Ограниченное предложение» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-limited-offer)
- [Шаблон «Каталог» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-catalog)
- [Шаблон «Аутентификация» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-auth)
</Note>

## Переменные

Переменные в шаблонах WhatsApp должны быть **числовыми** и заключены в двойные фигурные скобки — например, `{{1}}`, `{{2}}`.

Под каждым текстовым полем, где есть переменная, появится **поле для описания**. Заполните его — это помогает ускорить одобрение.

**Пример:**

| Что | Что указать |
|---|---|
| Текст шаблона | `Здравствуйте, {{1}}! Ваш заказ {{2}} готов.` |
| Описание `{{1}}` | Имя клиента |
| Описание `{{2}}` | Номер заказа |

<Note>
**Локализуемые переменные** — Currency и Date Time — также поддерживаются. Они автоматически адаптируются под язык и регион получателя.

[Форматы payload по каналам →](https://iba-platform.jamdesk.app/03-multiapi/02-api/mapi-104-omni-payload)
</Note>

## Ограничения

| Что | Ограничение |
|---|---|
| **Название шаблона** | Только строчные латинские буквы, цифры, подчёркивания |
| **Текст шаблона** | Зависит от типа — например, для Карточки: заголовок до 50, текст до 550, подпись до 60 |
| **Кнопки** | До **10 кнопок**, из них максимум **2 — типа URL** |
| **URL-адреса кнопок** | Должны быть **уникальными** |
| **Тексты кнопок** | Должны быть **уникальными** |
| **Переменные** | Все должны быть заполнены при отправке |
| **Формат заголовков в карусели** | Должен быть **одинаковым** для всех карточек |

<Note>
**По кнопкам** — ограничения для каждого типа шаблона:

- **Карточка** — до 10 кнопок, максимум 2 из них URL.
- **Карусель** — до 10 кнопок на каждую карточку.
- **Код купона** — обязательна **одна** кнопка «Копировать код».
- **Ограниченное предложение** — минимум одна кнопка «Переход по ссылке».
- **Аутентификация** — обязательна кнопка «Копировать код».
</Note>

## Статусы шаблона

### Черновик

Единственный **внутренний статус системы**. Шаблон сохранён в системе, но не отправлен в WhatsApp на одобрение.

### Поданный

Шаблон отправлен на одобрение в WhatsApp.

### В ожидании

WhatsApp рассматривает шаблон.

### Одобренный

Шаблон одобрен, можно использовать.

### Отклонённый

Шаблон отклонён. Причина — в поле `rejection_reason`.

### В апелляции

Подана апелляция на отклонение.

### Ожидает удаления

Запрошено удаление шаблона.

### Удалён

Шаблон удалён.

### Отключён

Шаблон отключён WhatsApp.

### Приостановлен

Шаблон приостановлен WhatsApp.

### Предел превышен

Превышен лимит по шаблону.

## Рейтинг качества

WhatsApp оценивает шаблон на основе отзывов, жалоб и активности получателей.

| Рейтинг | Что означает |
|---|---|
| **Высокое качество** | Хорошая репутация |
| **Среднее качество** | Средняя репутация |
| **Низкое качество** | Плохая репутация |
| **Не определено** | Рейтинг ещё не рассчитан |

<Note>
Рейтинг отображается после обработки **1 000 или более заявок**. До этого WhatsApp возвращает статус **Не определено**.
</Note>

## Как использовать шаблон через API

Для отправки сообщения по шаблону WhatsApp используйте параметр `template` вместо `payload`.

**Пример curl:**

```bash
curl --location 'https://web.multiapi.ru/api/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <ваш-ключ>' \
  --data-raw '{
    "contact": "79123456789",
    "channel": 4,
    "senderId": "<senderID>",
    "template": {
      "id": <templateID>,
      "params": {
        "attribute.name": "Александр",
        "attribute.code": "1234"
      }
    }
  }'
```

**Проверить список шаблонов WhatsApp:**

```bash
curl --location 'https://web.multiapi.ru/api/v1/wa_templates' \
  --header 'X-API-Key: <ваш-ключ>'
```

**Поля ответа `GET /wa_templates`:**

| Поле | Что означает |
|---|---|
| `id` | ID шаблона |
| `template_name` | Имя шаблона |
| `category` | MARKETING, UTILITY, AUTHENTICATION |
| `language`, `language_name_en` | Язык |
| `sender_id`, `sender_display_name` | Отправитель |
| `status` | Статус одобрения |
| `rejection_reason` | Причина отклонения |
| `content` | Содержимое в виде JSON-строки |
| `last_synced_at` | Когда синхронизировано |
| `status_updated_at` | Когда изменился статус |

[Справочные эндпоинты →](https://iba-platform.jamdesk.app/03-multiapi/02-api/mapi-107-api-reference)

## Синхронизация с WhatsApp

В интерфейсе **Активы** → **Шаблоны WhatsApp** доступна иконка **синхронизации**. Она получает актуальные статусы из WhatsApp по всем вашим шаблонам.

**Когда использовать:**

- После отправки шаблона на одобрение — проверить смену статуса.
- Периодически — для актуализации данных.
- После изменений на стороне WhatsApp.

## Предварительно одобренные шаблоны

В разделе **Активы** → **Шаблоны WhatsApp** доступна **библиотека предварительно одобренных шаблонов** WhatsApp.

**Что это даёт:**

- Быстрое создание шаблона на основе готового.
- Такие шаблоны быстро получают статус **Одобренный**.
- Не требуют повторного согласования.

**Как использовать:**

1. Нажмите **Добавить шаблон WhatsApp** → **Предварительно одобрено**.
2. Выберите отправителя.
3. Примените фильтры — по сценарию, отрасли, теме, языку.
4. Выберите шаблон из библиотеки.
5. Введите своё название.
6. Сохраните.

[Предварительно одобренные шаблоны →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-pre-approved)

## Результат

Шаблон WhatsApp создан и отправлен на одобрение. После получения статуса **Одобренный** его можно использовать в рассылках и через API.

- [Обзор шаблонов WhatsApp →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-overview)
- [Шаблон «Аутентификация» →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-auth)
- [Настройка WhatsApp →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/whatsapp)

## Частые проблемы

### Шаблон не одобрен

**Причина:** шаблон не соответствует правилам WhatsApp.

**Решение:** проверьте содержимое и отправьте снова.

[Обзор шаблонов WhatsApp →](https://iba-platform.jamdesk.app/05-channels/04-whatsapp/templates/templates-overview)

### Ошибка «URL повторяется»

**Причина:** два одинаковых URL среди кнопок.

**Решение:** сделайте URL-адреса уникальными — каждая кнопка ведёт на свой адрес.

### Ошибка «Переменная пуста»

**Причина:** при отправке не заполнены все переменные.

**Решение:** заполните все переменные, которые есть в шаблоне.

### Ошибка «Больше 2 URL-кнопок»

**Причина:** в шаблоне больше 2 кнопок типа URL.

**Решение:** максимум 2 URL-кнопки. Остальные замените на «Ответное действие» или удалите.

### Ошибка «Разные форматы заголовков в карусели»

**Причина:** форматы заголовков карточек отличаются.

**Решение:** приведите все заголовки к одному формату — изображение, видео, документ или локация.

### Долго нет статуса

**Причина:** WhatsApp обрабатывает шаблон.

**Решение:** подождите 24–48 часов. Проверьте статус через синхронизацию.

[Контакты поддержки →](https://iba-platform.jamdesk.app/06-reference/03-troubleshooting/ts-support-contacts)

### Не удаётся сохранить название

**Причина:** в названии есть заглавные буквы, пробелы или дефисы.

**Решение:** используйте только строчные латинские буквы, цифры и символ подчёркивания. Пример: `discount_50_percent_march`.

## См. также

<Columns cols={2}>
  <Card title="Обзор шаблонов WhatsApp" icon="book" href="/05-channels/04-whatsapp/templates/templates-overview">
    Категории, статусы, рейтинг качества
  </Card>
  <Card title="Как создать шаблон" icon="square-plus" href="/05-channels/04-whatsapp/templates/templates-how-to-create">
    Общий шаблон или из библиотеки
  </Card>
  <Card title="Шаблон «Карточка»" icon="image" href="/05-channels/04-whatsapp/templates/templates-card">
    Изображение, текст, кнопки
  </Card>
  <Card title="Шаблон «Аутентификация»" icon="shield" href="/05-channels/04-whatsapp/templates/templates-auth">
    Коды с поддержкой Zero-Tap
  </Card>
  <Card title="Справочные эндпоинты" icon="list" href="/03-multiapi/02-api/mapi-107-api-reference">
    Получить список шаблонов WhatsApp
  </Card>
  <Card title="Настройка WhatsApp" icon="comment" href="/05-channels/04-whatsapp/whatsapp">
    Возможности канала
  </Card>
</Columns>

## Нужна помощь?

- **Multi API:** support@multiapi.ru