Справочник автоматизаций WhatsApp: триггеры, шаги, переменные и лимиты
Автоматизации easyCoexistence на номере WhatsApp запускаются сообщением, которое приходит, контактом, получившим тег, или вызовом из вашей системы. У сообщения есть четыре варианта совпадения: «Каждое сообщение», «Есть ключевое слово», «Первое сообщение» и «Вне рабочего времени». Затем идут шаги, до 30 в линии и 60 всего, с ветвлениями, вопросами и ИИ-агентами. На одно сообщение срабатывает не более одной автоматизации, сначала правила с ключевыми словами.
Шаги в одной линии, всего 60, ветвления вложены на 4 уровня; «Остановить» и «Go back to a step» могут только завершать линию.
В автоматизации до 100 символов в каждом ключевом слове; достаточно любого одного, заглавные буквы не учитываются.
Какие символы допустимы в инструкциях шага «Ответить с ИИ», ответы которого ограничены от 50 до 2 000 токенов.
Самое длинное одиночное «Подождать» составляет 23 часа, чтобы следующий текстовый шаг всё ещё попадал в 24-часовое окно Meta.
Сколько времени вебхук должен ответить, прежде чем «Вызвать мой вебхук» выдаст ошибку; поле reply в ответе уходит клиенту.
Срок хранения запусков вместе с каждым начальным сообщением и ответом; текст сообщений удаляется через выбранный вами срок хранения (30, 90 или 365 дней, по умолчанию 90).
Какие триггеры и условия совпадения может использовать автоматизация WhatsApp?
Основной триггер, «Пришло сообщение» (message_received), срабатывает, когда клиент пишет на номер: текст, фото, видео, документы, аудио, стикеры, геолокацию, визитки, ответы кнопками и списками, а также заказы. Голосовое сообщение расшифровывается через ваш ключ OpenAI или OpenRouter и сохраняется как «[voice message]», за которым следуют слова, по ним может сработать ключевое слово; без такого ключа остаётся «[voice message]». Реакции, статусы и системные уведомления никогда не запускают запуск, а групповые чаты не доходят до API на номере Coexistence. Ещё два триггера запускаются не от сообщения. «Контакт получил тег» (tag_added) срабатывает каждый раз, когда контакт, доступный на номере, получает указанный вами тег: из сценария, от ИИ-агента, от вас в «Разговорах» или через update_contact. «Ваша система вызывает URL» (webhook_received) срабатывает, когда ваша собственная система отправляет POST с JSON и номером телефона на URL автоматизации, с секретом автоматизации в качестве Bearer-токена, для нового заказа или бронирования; тело, до 20 КБ, доступно как {{vars.webhook.*}}. В обоих случаях {{message}} пусто, а человек, который не писал в последние 24 часа, может получить только send_template. Триггера по расписанию нет. В триггере сообщения «Вне рабочего времени» считает открытыми дни, отмеченные в «Рабочие дни», в промежутке между «С» и «До» в часовом поясе IANA, например America/Sao_Paulo. Если «До» раньше «С», это ночная смена (с 22:00 до 06:00), а неотмеченный день считается закрытым весь день. В API поле hours принимает timezone, days (1 = понедельник, 7 = воскресенье, дни, когда вы открыты), а также start и end. «Первое сообщение» срабатывает, когда easyCoexistence создаёт запись для чата: это первое сообщение клиента после включения автоматизации на номере, включая давних клиентов, либо первое сообщение после 30 дней тишины. Чат, открытый с телефона, уже считается просмотренным.
Как работают режимы сопоставления ключевых слов?
В блоке «Где должно быть слово» по умолчанию стоит «Содержит» («В любом месте сообщения»), «Начинается с» соответствует режиму «В начале», а «Точно совпадает» соответствует режиму «Всё сообщение». В API поле keywordMode принимает значения contains, starts_with или exact. Сопоставление обрезает пробелы вокруг сообщения и не учитывает регистр букв, но учитывает акценты и знаки препинания, а режим «Содержит» находит слово и внутри более длинных слов. Поле «Проверить» под «Ключевые слова» для любого введённого образца отвечает «Запустится: совпадает» с ключевым словом или «Не запустится: ни одно ключевое слово не совпадает».
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
Что делает каждый шаг и какие поля он принимает?
Шаги выполняются сверху вниз, до 30 в одной линии и 60 в автоматизации, включая ветви, и хотя бы один должен делать что-то помимо «Подождать», «Остановить», «Разделить на пути», «ИИ выбирает путь» и «Вернуться к шагу». Ветвящийся шаг содержит линию шагов для каждого пути и линию «Иначе», а ветви вкладываются на 4 уровня. В меню «Выберите шаг» у каждого есть название и короткая строка, обе приведены ниже для шести базовых шагов. «Задать вопрос» (ask) отправляет своё «Сообщение» с числом кнопок до 10, из которых 3 показываются как нажимаемые кнопки, а остальные перечисляются списком и принимаются ответом по номеру, ждёт ответ до 1380 минут и сохраняет его в поле контакта как текст, email, число, телефон или одну из кнопок; на неверный ответ вопрос задаётся снова до 3 раз. «Ответ агента» (agent) передаёт сообщение одному из ваших ИИ-агентов, «Отправить картинку или файл» (send_file) отправляет картинку или PDF из ваших файлов, а «Передать человеку» (handoff) ставит бота на паузу в этом чате на срок от 1 до 168 часов, по умолчанию 24, и отправляет вам письмо. «Разделить на пути» (condition) и «ИИ выбирает путь» (ai_decide) ветвят по правилам или по смыслу. «ИИ сохраняет данные» (ai_extract), «Сохранить в контакт» (set_field) и «Тег» (tag) записывают поля контакта и теги, а «Вызвать API» (http_request) вызывает любой HTTPS API и сохраняет его JSON-ответ как {{vars.<name>...}}. «Запустить автоматизацию» (start_automation) запускает другую автоматизацию для того же человека, не глубже 3 уровней, «Вернуться к шагу» (goto) переходит к id шага для цикла, а «Уведомить меня» (notify_owner) отправляет вам письмо, не более 20 в час на автоматизацию. Если шаг завершился ошибкой, следующие шаги пропускаются, а запуск получает статус Failed. «Вызвать мой вебхук» отправляет POST с JSON, в котором event со значением "automation.step", dry_run, run_id, номер, контакт (wa_id, name), сообщение (id, type, text, at) и до 10 последних сообщений чата. Подпись записывается в заголовке X-EC-Signature как t=<unix>,v1=<HMAC-SHA256 от "<t>.<body>"> с «Секретом подписи» шага. Адрес должен быть публичным HTTPS, перенаправления не выполняются.
Какие переменные могут подставлять шаги?
Четыре заполняются из сообщения, которое запустило запуск, и записываются в двойных фигурных скобках; {{contact.<field>}} добавляет поле контакта (также contact.name и contact.phone), а {{vars.<path>}} то, что сохранили предыдущие шаги, например ответ шага «Вызвать API». Они работают в «Сообщении» шага «Ответить текстом», в переменных тела шаблона, в «Инструкциях» шага «Ответить с ИИ» и в тексте других шагов, например «Задать вопрос»; в переменных шаблона чипы «Вставить:» добавляют их. Неизвестное значение, например у профиля без имени, становится пустым. Отправка шаблона передаёт только переменные тела, по позиции, поэтому шаблон с именованными переменными, картинкой или переменной в заголовке, а также кнопка с переменной пока недоступны для выбора. Пустая переменная заставляет Meta отклонить отправку.
- {{
first_name}}: первое слово имени профиля клиента в WhatsApp («Имя»). - {{name}}: полное имя профиля («Полное имя»).
- {{message}}: текст сообщения или его заглушка, например «[image]», плюс подпись («Сообщение клиента»).
- {{phone}}: номер клиента в международном формате, только цифры без плюса, например 5511999998888 («Телефон клиента»).
- В тесте клиент называется «Тестовый клиент», а телефон равен 15550000000.
Какие есть настройки и их значения по умолчанию?
Две настройки находятся в разделе «Дополнительно», это кнопка рядом с переключателем «Вкл» в редакторе, а у шага ИИ есть ещё две собственные. Поле, которое не заполнено, получает значение по умолчанию, как в редакторе, так и через create_automation. Таймауты фиксированы и не настраиваются: ответ ИИ получает 45 секунд, а вебхук 20 секунд. Название автоматизации может содержать до 120 символов. У ИИ-агента свои настройки: сколько предыдущих сообщений он читает, от 0 до 40 (по умолчанию 20), самый длинный ответ от 100 до 4000 токенов (по умолчанию 800), до 10 вызовов инструментов на ответ (по умолчанию 5) и часы передачи человеку, от 1 до 168 (по умолчанию 24).
Какая автоматизация ответит, если подходят несколько?
Не более одной, выбранной в фиксированном порядке: сначала «Есть ключевое слово», затем «Первое сообщение», затем «Вне рабочего времени», затем «Каждое сообщение». Внутри одного типа первой идёт самая старая автоматизация. В конкуренции участвуют только включённые и не приостановленные автоматизации, поэтому, если правило с ключевым словом выключено или приостановлено из-за отклонённого ключа ИИ, ответит общая автоматизация. Два следствия удивляют людей. Новый клиент, который пишет ночью, получит автоматизацию «Первое сообщение», а не «Вне рабочего времени», потому что «Первое сообщение» стоит выше. А сообщение, на которое отвечает автоматизация с ключевым словом, никогда не доходит до ИИ-агента или шага «Ответить с ИИ» в автоматизации «Каждое сообщение», поэтому, если нужны оба, поместите агента или шаг ИИ внутрь автоматизации с ключевым словом. Сообщение, которое отвечает на открытый шаг «Задать вопрос», принадлежит этому вопросу, и никакая другая автоматизация по нему не запускается. Автоматизации по тегу и по вебхуку запускаются от собственных событий и в этом порядке не участвуют.
Какие защиты встроены?
Исполнитель применяет их без всяких настроек, а причины пропуска во вкладке «Запуски» указывают на них, когда они останавливают запуск:
- Сообщение, которое Meta доставляет дважды, запускает один запуск: дубликаты отбрасываются по id сообщения.
- Реакции, статусы, собственные отправки автоматизации и ваши эхо-сообщения из приложения никогда не запускают запуск.
- «Ответить текстом», «Задать вопрос», «Отправить картинку или файл», «Ответить с ИИ», ответ агента и ответ вебхука требуют, чтобы последнее сообщение клиента было моложе 24 часов; «Отправить шаблон» этого не требует.
- Ответ, который вы напечатали в приложении WhatsApp Business, приостанавливает автоматизацию в этом чате, а запуск, ожидающий там, пропускает оставшиеся шаги.
- Более новое сообщение, которое запускает ту же автоматизацию в чате, заменяет запуск, всё ещё ожидающий в шаге «Подождать»; сообщение, которое отвечает на открытый вопрос, уходит в этот вопрос.
- Отправки с номера разнесены минимум на 100 мс, что укладывается в лимит Meta в 20 в секунду для номеров Coexistence.
- Об ошибке шага вам приходит письмо не чаще одного раза в 6 часов на автоматизацию. Отклонённый ключ ИИ приостанавливает автоматизации этого провайдера и отправляет одно письмо.
Что принимает инструмент create_automation?
У коннектора MCP девятнадцать инструментов для автоматизаций и того, что они используют. Восемь относятся к автоматизациям: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs и get_automation_run. Восемь относятся к агентам и файлам: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge и test_agent. Три относятся к людям: list_conversations, get_conversation и update_contact. create_automation принимает connection_id (из list_numbers), name, enabled, trigger, steps и settings, в snake_case, например keyword_mode и max_tokens; camelCase тоже принимается. Объекты шагов: reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} и wait {minutes}, затем ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} и stop. update_automation сохраняет поля, которые вы не передали, а steps, если их передать, заменяют весь список. Ошибки указывают на поле, например «trigger.keywords: Add at least one keyword», «steps.2: Stop must be the last step of its line» или «steps.0: save your openai API key on the Automations page first». Ключи ИИ через MCP не передаются. В примере шаг «Подождать» на 1 минуту позволяет клиенту, который отправляет сразу несколько строк, получить один ответ.
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}Распространённые ошибки
- Использовать двухбуквенное ключевое слово с «Содержит». «oi» также совпадает с «noite» и «boi», поэтому автоматизация отвечает на сообщения, для которых не предназначена. Используйте «Точно совпадает» или более длинное ключевое слово.
- Указывать только вариант с акцентом. Сопоставление не учитывает регистр, но учитывает акценты, поэтому «preço» пропускает клиентов, которые пишут «preco». Добавьте оба варианта.
- Ожидать, что «Первое сообщение» пропустит постоянных клиентов. Шаг срабатывает для любого клиента, чат которого easyCoexistence не видел 30 дней, поэтому давние клиенты получат приветствие на первое сообщение после включения.
- Выбрать шаблон, которому нужна картинка в заголовке или кнопка копирования кода. Автоматизации заполняют только переменные тела, поэтому редактор показывает такой шаблон, но не даст его выбрать. Через MCP отправка будет отклонена Meta, а запуск завершится ошибкой.
easyCoexistence запускает эти автоматизации на номере WhatsApp Business, которым вы продолжаете пользоваться в приложении, через Cloud API Meta и Coexistence. Создавайте их в редакторе, в разделе «Автоматизации», «Новая автоматизация», или позвольте ChatGPT или Claude вызвать create_automation и test_automation через коннектор MCP, в котором более 30 инструментов. От US$ 9 до US$ 0,75 за подключённый номер в месяц, цена падает по мере добавления номеров, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли автоматизация ветвиться по тому, что говорит клиент?
Да. «Разделить на пути» (condition) ветвит по тексту сообщения, полю контакта, тегу, более раннему ответу API или вашему рабочему времени, а «ИИ выбирает путь» (ai_decide) выбирает по смыслу, на любом языке, на вашей собственной модели. В каждом пути своя линия шагов, а линия «Иначе» ловит остальное. Решение также можно передать n8n или вашему бэкенду через «Вызвать мой вебхук», который может вернуть разный {"reply": "..."} для каждого случая.
Есть ли ограничение на количество автоматизаций или запусков?
Ограничения на число запусков нет, и за них не берут дополнительную плату. Нет и лимита на количество автоматизаций у номера. Действуют ограничения на каждый чат: ответы ИИ в час, правило Meta про 24 часа для текста и пауза после ответа с телефона.
Можно ли перенести или скопировать автоматизацию на другой номер?
Перенести можно, сменив «Подключение» в редакторе или через update_automation и новый connection_id. Запуски, которые ещё ждут на старом номере, завершаются как superseded. Чтобы скопировать, попросите ИИ прочитать её через list_automations и создать такие же триггер и шаги на другом номере.
Что происходит с ожидающими запусками, когда я меняю автоматизацию?
Они продолжаются. Запуск, остановленный на «Подождать», возобновляется со следующего номера шага автоматизации в том виде, в каком она сохранена на момент пробуждения запуска, поэтому правка может изменить то, что отправляется. Чтобы их остановить, выключите автоматизацию: тогда они завершатся со статусом Skipped и сообщением «Automation is off».
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на