Ответ в WhatsApp
Нода Ответ в WhatsApp отправляет ответ клиенту, который написал в канал WhatsApp и этим запустил процесс: текст, изображения или голосовое сообщение. Если с последнего сообщения клиента прошло больше 24 часов, нода может отправить вместо ответа одобренный шаблон. В палитре нода находится в разделе Интеграции.
Результат процесса, запущенного сообщением из WhatsApp, автоматически клиенту не отправляется. Ответ уходит только тогда, когда выполняется нода Ответ в WhatsApp. Сервисные сообщения канала (например, о том, что запрос не удалось обработать) канал по-прежнему отправляет сам.
Назначение
- Ответ агента клиенту в WhatsApp: текст ответа обычно берется из
{{lastOutput}}. - Отправка изображений (каталог, схема проезда, чек) вместе с текстом или без него.
- Голосовой ответ на голосовое сообщение клиента.
- Несколько сообщений за один запуск: например, «Принято, проверяю заказ» в начале процесса и итоговый ответ в конце -- каждая нода отправляет свое сообщение.
Перед началом
- Подключите номер WhatsApp. Раздел Интеграции → вкладка WhatsApp → Подключить номер.
- Привяжите процесс к каналу. В настройках канала выберите процесс в поле Сценарий: все входящие сообщения на этот номер запускают выбранный процесс. Канал запускает процесс из активной публикации, поэтому изменения в процессе начнут действовать для клиентов WhatsApp после публикации.
- Для голосовых ответов включите в настройках канала Отвечать голосом.
- Для ответа после 24 часов создайте шаблон в WhatsApp Manager, дождитесь одобрения и синхронизируйте шаблоны: у канала Изменить → вкладка Шаблоны → Синхронизировать.
Когда процесс запущен сообщением из WhatsApp, в его входных данных есть объект input.whatsapp. Из него нода берет канал и номер клиента; его же можно использовать в своих полях:
| Переменная | Описание |
|---|---|
{{input.message}} | Текст сообщения клиента |
{{input.whatsapp.wa_id}} | Номер клиента в WhatsApp |
{{input.whatsapp.contact_name}} | Имя клиента в WhatsApp (может отсутствовать) |
{{input.whatsapp.channel_id}} | ID канала, в который написал клиент |
24-часовое окно
WhatsApp разрешает отправлять обычные сообщения -- текст, изображения, голос -- только в течение 24 часов после последнего сообщения клиента. Такие ответы бесплатны. Когда окно закрыто, Meta принимает только одобренный шаблон, и каждая доставка шаблона платная: стоимость зависит от категории шаблона и страны получателя.
| Окно | Что отправляет нода |
|---|---|
| Открыто | Изображения, затем голос или текст |
| Закрыто, включено «Отвечать шаблоном после 24 часов» и шаблон выбран | Выбранный шаблон вместо ответа; изображения не отправляются |
| Закрыто, шаблон не выбран или переключатель выключен | Ничего; ошибка WindowClosed |
Текст шаблона фиксирован при одобрении, поэтому шаблон не может передать сам ответ -- только значения своих переменных.
Настройки
Поля перечислены в порядке, в котором они показаны в панели.
Текст
Текст ответа, многострочное поле. По умолчанию {{lastOutput}} -- результат предыдущей ноды. Принимает переменные; кнопка с фигурными скобками (Вставить переменную) вставляет переменную в позицию курсора. Подсказка «?»: «Поддерживаются переменные {{variable}}. Пустой текст без изображений завершится ошибкой EmptyText.»
- Не более 4096 символов после подстановки переменных, иначе ошибка
TooLong. - Markdown-разметка преобразуется в форматирование WhatsApp: например,
**жирный**станет жирным текстом, а ссылка[текст](url)-- просто адресом. - Длинный текст может уйти несколькими сообщениями.
Изображения
Список ссылок на изображения, до 10 штук. Справа от названия -- счетчик «N / 10». Строки добавляются кнопкой Добавить изображение (недоступна, когда ссылок 10) и удаляются кнопкой корзины. Каждая строка принимает переменные. Подсказка «?»: «Изображения отправляются до текста. Не более 10 — если больше, ничего не отправится (TooManyImages).»
- Пустые строки (и переменные, давшие пустое значение) пропускаются.
- Каждое изображение отправляется отдельным сообщением. Если одно изображение не удалось отправить, остальные и текст все равно уходят, а причина записывается в поле
imagesрезультата. - Если текст пустой и ни одно изображение не дошло, нода завершается с ошибкой.
Ответить на входящее сообщение
Переключатель, по умолчанию включен. Подсказка «?»: «Ответ цитирует сообщение, с которого начался запуск.» Работает только для ответа клиенту, написавшему в WhatsApp; для получателя, указанного вручную, не используется.
Голосом на голосовые
Переключатель, по умолчанию выключен. Подсказка «?»: «Отправляет аудио, если клиент писал голосом и в канале включены голосовые ответы; иначе — текст.»
Нода отправит текст вместо голоса также, если:
- текст слишком длинный для голосового сообщения -- больше «Максимум голосового (с)» из настроек канала × 15 символов;
- синтез речи или загрузка аудио не удались.
Для получателя, указанного вручную, голосовой ответ не используется.
Отвечать шаблоном после 24 часов
Переключатель, по умолчанию включен. Подсказка «?»: «Если клиент писал больше 24 часов назад, WhatsApp не пропустит обычный ответ — Meta принимает только одобренные шаблоны. Включите, чтобы вместо ответа отправить выбранный ниже шаблон; каждая такая отправка платная. Если выключено или шаблон не выбран, ответ не отправится и нода вернёт ошибку.»
Пока шаблон не выбран, под переключателем написано: «Шаблон не выбран: если клиент писал больше 24 часов назад, ответ не отправится и узел вернёт ошибку.»
При включенном переключателе появляются поля:
- Канал для выбора шаблона -- канал, из которого загружается список шаблонов. Он нужен только для выбора: шаблон уходит через канал, в котором идет диалог. Справа -- кнопки + («Открыть интеграции») и Обновить список. При смене канала выбранный шаблон и параметры сбрасываются.
- Шаблон -- «Выберите одобренный шаблон». Неодобренные шаблоны видны, но недоступны. Подсказка «?»: «Доступны только одобренные шаблоны. Шаблон с таким же именем и языком должен быть одобрен и в WhatsApp Business-аккаунте того канала, через который реально уйдёт сообщение, иначе отправка не пройдёт.»
- Параметры шаблона -- появляются после выбора шаблона. Значения переменных текста шаблона, каждое принимает переменные
{{...}}. Число строк задается шаблоном: пока оно совпадает с ожидаемым, добавлять и удалять строки нельзя. Над строками -- предпросмотр сообщения с подставленными значениями.
Шаблон отправляется только клиенту, который написал в WhatsApp. Получателю, указанному вручную, шаблон не отправляется -- для рассылок используйте ноду WhatsApp-шаблон.
Указать получателя вручную
Сворачиваемый раздел; раскрыт, если в нем уже есть значения. Подсказка «?»: «По умолчанию нода отвечает тому, кто написал в WhatsApp и запустил процесс. Заполните оба поля, чтобы отправить сообщение другому получателю — например, когда процесс запущен не из WhatsApp. Сообщение дойдёт, только если этот номер уже писал в выбранный канал и с его последнего сообщения прошло меньше 24 часов.»
- Канал WhatsApp-интеграции -- выбор канала из списка; можно очистить.
- Номер телефона получателя -- номер в международном формате, принимает переменные (
+79991234567или{{variable}}).
Получатель учитывается, только если заполнены оба поля. Если заполнено одно, в разделе показывается предупреждение «Заполните и канал WhatsApp-интеграции, и номер получателя, иначе они не учитываются.», и нода отвечает тому, кто написал в WhatsApp.
Для получателя, указанного вручную, не используются цитирование, голосовой ответ и шаблон после 24 часов.
Списки каналов показывают каналы всей организации, но отправить можно только через канал текущего проекта (ошибка Forbidden).
Подключения
- Вход: один вход (слева)
- Выход: один выход
output(справа)
Ошибка не останавливает процесс: следующая нода получает объект ошибки. Проверить результат можно нодой If/Else с условием вида node_5.__error или node_5.errorType == "WindowClosed", где node_5 -- ID ноды ответа.
Входные данные
Нода использует результат предыдущей ноды через переменные в полях -- по умолчанию через {{lastOutput}} в поле «Текст». Канал и номер клиента нода берет из input.whatsapp, если получатель не указан вручную.
Выходные данные
{
"success": true,
"__success": true,
"__error": false,
"wamids": ["wamid.HBgLNzk5..."],
"wamid": "wamid.HBgLNzk5...",
"messageType": "text",
"to": "79990001122",
"channelId": "wac_...",
"images": [],
"deduplicated": false
}
| Поле | Описание |
|---|---|
wamids | ID всех отправленных сообщений |
wamid | ID последнего отправленного сообщения |
messageType | Что отправлено последним: text, image, audio или template |
to | Номер получателя |
channelId | ID канала |
images | По одному элементу на изображение: url, wamid и error (причина, если изображение не отправлено; window_closed -- окно закрыто) |
deduplicated | true, если это повтор той же отправки и сообщение второй раз не отправлялось |
При ошибке:
{
"success": false,
"__success": false,
"__error": true,
"error": "WhatsApp 24h window is closed and no re-engagement was sent",
"errorType": "WindowClosed",
"code": null,
"status": 409,
"to": "79990001122",
"channelId": "wac_...",
"wamid": null,
"wamids": [],
"images": []
}
Если часть ответа успела уйти (например, изображения), их ID остаются в wamids и images.
Типичные ошибки
Проверки до отправки:
errorType | Текст error | Что сделать |
|---|---|---|
NoConversationContext | No WhatsApp conversation to reply to: run from a WhatsApp channel or set channelId and to | Процесс запущен не из WhatsApp -- укажите получателя вручную |
ConfigurationError | WhatsApp channel id is not valid | Проверьте канал получателя |
TooManyImages | Too many images: N (maximum 10) | Оставьте не больше 10 изображений |
TooLong | Reply text is too long: N characters (maximum 4096) | Сократите текст |
EmptyText | Reply text is empty and no images are set | Заполните текст или добавьте изображение; проверьте, что переменная в тексте не пустая |
Отказы при отправке:
errorType | Текст error | Что означает и что сделать |
|---|---|---|
WindowClosed | WhatsApp 24h window is closed and no re-engagement was sent | Окно закрыто, шаблон не отправлен: выберите шаблон в «Отвечать шаблоном после 24 часов». Для получателя, указанного вручную, шаблон не используется |
TemplateUnusable | WhatsApp re-engagement template is not approved or does not match | Шаблон не одобрен или не синхронизирован в канале диалога либо число параметров не совпадает. Поле code уточняет причину: not_approved, param_count, too_many_parameters, non_body_parameters, mixed_parameters, unreadable |
NoConversation | No WhatsApp conversation with this recipient yet | Этот номер еще не писал в выбранный канал -- используйте ноду WhatsApp-шаблон |
CredentialsInvalid | WhatsApp channel credentials are not valid | Токен доступа канала перестал работать -- обновите его в настройках канала |
GraphApiError | WhatsApp rejected the message | Meta отклонила сообщение; код Meta -- в поле code |
Forbidden | WhatsApp channel does not belong to this project | Выберите канал текущего проекта |
SendInProgress | WhatsApp reply is still being sent; it will probably be delivered | Ответ еще отправляется; повторно отправлять не нужно |
UpstreamUnavailable | WhatsApp service is unavailable | Сервис WhatsApp или Meta недоступны -- повторите позже |
Защита от повторной отправки
Каждая отправка регистрируется до обращения к Meta. Если та же нода в том же запуске повторяет отправку (например, после обрыва связи), сообщение второй раз не уходит: нода возвращает результат первой отправки с deduplicated: true или ошибку SendInProgress, если первая еще не завершилась. Новый запуск процесса -- это новая отправка. Настраивать эту защиту не нужно.
Проверки на холсте
Если включен показ предупреждений (настройка холста Предупреждения), на ноде появляется значок «!»: красный при ошибке, оранжевый при предупреждении. При наведении показывается список:
| Тип | Сообщение |
|---|---|
| Ошибка | «Нет ни текста, ни изображений — ответ не отправится» |
| Ошибка | «Слишком много изображений: не больше 10» |
| Предупреждение | «Шаблон после 24 часов не выбран — при закрытом окне ответ не отправится» |
| Предупреждение | «Получатель указан не полностью (нужны и канал, и номер) — он будет проигнорирован» |
Проверки не мешают сохранить процесс.
Примеры использования
Ответ агента в WhatsApp
Канал WhatsApp запускает процесс, агент готовит ответ, нода отправляет его клиенту. Если ответ может уйти позже, чем через 24 часа после сообщения клиента, выберите шаблон в «Отвечать шаблоном после 24 часов» -- иначе такой ответ не будет отправлен.
Изображение с подписью
Текст: Ваш заказ {{input.order_id}} собран. Фото упаковки выше.
Изображения: {{node_3.photo_url}}
Сначала уходит изображение, затем текст.
В заголовке панели есть переключатель тихого режима.