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

# Создание кампании

> В этом разделе вы можете создавать и настраивать автоматизированные кампании уведомлений или звонков, которые будут выполняться ботами с использованием ранее созданных шаблонов.

<img src="https://mintcdn.com/lovi/Knq0_jkn8h7nw8oT/images/CreateCampaignForm.png?fit=max&auto=format&n=Knq0_jkn8h7nw8oT&q=85&s=46c684c8ca6c5fad5c7fb7c58441c6b4" alt="Create Campaign Form" width="1690" height="782" data-path="images/CreateCampaignForm.png" />

Здесь всё сходится воедино: аудитория (ваш CSV), сообщение (ваш шаблон) и точный момент.

Эта форма — ваш **Центр запуска**. Мы настроим её поле за полем, чтобы сообщение дошло до нужных людей в нужное время.

***

### 📝 1. Конфигурация запуска (Поля)

Заполните эти данные для определения идентичности кампании:

* **Номер телефона:** Выберите номер, с которого будут отправляться сообщения. Если их несколько (Продажи, Поддержка), выбирайте внимательно.
* **Шаблон уведомления:** Выберите один из одобренных шаблонов.

  * *Примечание:* Только шаблоны с зелёным светом от Meta (Статус: *Approved*) будут отображаться.
* **Название кампании:** Название для вашей справки. Что-то вроде `Летняя_Промо_2024`.
* **Название события:** Технический идентификатор события. Полезен, если вы используете webhook или внешние интеграции для отслеживания запуска конкретной кампании.

***

### ⏰ 2. Фактор времени (Планирование)

Время относительно, но в маркетинге оно критично.

* **Часовой пояс:** **Очень важно!** 🌍 Выберите правильный часовой пояс. Вы не хотите отправить сообщение «Доброе утро» в 3:00 ночи, потому что выбрали неправильный часовой пояс.
* **Дата отправки:** Установите точную дату и время отправки.

  * Система запланирует доставку на этот точный момент.

***

### 👥 3. Аудитория (CSV пользователей)

Здесь вы загружаете список **клиентов** 😄

Вы должны загрузить файл **.CSV** (максимум 4 МБ), содержащий данные людей, с которыми хотите связаться.

#### ⚠️ Золотое правило CSV:

Чтобы всё работало, ваш Excel/CSV должен соблюдать одно священное правило:

1. **Столбец `number` (Обязательный):** Должен быть столбец с именем `number`, содержащий номера телефонов с кодом страны (например, `79001234567`). Без этого столбца система не знает, кому отправлять.
2. **Столбцы переменных (Необязательные):** Если ваш шаблон говорит «Привет, `{{name}}`», ваш CSV должен иметь столбец `name`. Система автоматически заполнит пробелы данными из каждой строки.

***

### 👁️ 4. Проверка (Шаблон)

В самом низу вы увидите раздел **Шаблон**.
Он не редактируется; это просто **визуальное напоминание**, чтобы вы подтвердили: *«Да, это тот шаблон, который я хочу отправить.»* Убедитесь, что он соответствует ожиданиям.

***

### ❗ 5. Ошибка: «Params Words Ratio Exceeds Limit» (шаблоны со слишком большим количеством переменных)

Иногда при сохранении или валидации шаблона/кампании вы можете встретить ошибку:

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lovi/mnt/data/f385a90c-187c-493d-a9de-a86f2b4ee98e.png" alt="Error screenshot" />

Сообщение об ошибке обычно звучит примерно так:

> *Invalid parameter - OAuthException - Params Words Ratio Exceeds Limit - This template has too many variables for its length. Reduce the number of variables or increase the message length.*

**Что это значит?**

Meta (WhatsApp) устанавливает правила соотношения между количеством переменных в шаблоне и общей длиной сообщения. Если шаблон содержит слишком много переменных относительно общего количества слов, валидация может не пройти.

**Что делать (быстрые шаги):**

1. Обратитесь к официальным кодам ошибок Business Messaging для понимания точной причины и кода: [https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)

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

   * Объедините поля в CSV в один столбец перед загрузкой (например, используйте `full_name` вместо `first_name` + `last_name`).
   * Замените несколько мелких переменных одной более широкой (например, `{{1}}` = «Иван Петров, VIP-клиент»).

3. Увеличьте длину сообщения, если возможно (добавьте ненавязчивый описательный текст), чтобы улучшить соотношение слов к переменным.

4. Если вам действительно нужно много переменных, рассмотрите создание нескольких шаблонов с меньшим количеством переменных и выбирайте наиболее подходящий для каждого сегмента.

5. Протестируйте шаблон в тестовой среде или с контролируемым количеством номеров телефонов перед запуском в продакшен.

**Практические советы:**

* Избегайте использования переменных для контента, который является постоянным и может быть записан прямо в шаблоне.
* Валидируйте CSV: убедитесь, что имена столбцов переменных точно соответствуют указанным в шаблоне.
* Добавьте короткую техническую заметку в библиотеку шаблонов (например: «используются поля: full\_name, order\_id»), чтобы коллеги, готовящие CSV, делали это правильно.

***

### 🚀 Огонь! (Сохранить)

Когда вы нажимаете **Сохранить**, кампания **Запланирована**.
Она не уйдёт немедленно (если вы не выбрали текущее время); вместо этого она терпеливо будет ждать в очереди до `Даты отправки`.

Вы можете перейти в модуль **Кампании** (который мы рассматривали ранее), чтобы увидеть её со статусом «Ожидание» до наступления времени.

**Готово! Настройте, загрузите список и ждите результатов. 📈**
