Перейти к основному содержимому

Ответ в WhatsApp

Нода Ответ в WhatsApp отправляет ответ клиенту, который написал в канал WhatsApp и этим запустил процесс: текст, изображения или голосовое сообщение. Если с последнего сообщения клиента прошло больше 24 часов, нода может отправить вместо ответа одобренный шаблон. В палитре нода находится в разделе Интеграции.

Без этой ноды клиент ответа не получит

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

Назначение​

  • Ответ агента клиенту в WhatsApp: текст ответа обычно берется из {{lastOutput}}.
  • Отправка изображений (каталог, схема проезда, чек) вместе с текстом или без него.
  • Голосовой ответ на голосовое сообщение клиента.
  • Несколько сообщений за один запуск: например, «Принято, проверяю заказ» в начале процесса и итоговый ответ в конце -- каждая нода отправляет свое сообщение.

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

  1. Подключите номер WhatsApp. Раздел Интеграции → вкладка WhatsApp → Подключить номер.
  2. Привяжите процесс к каналу. В настройках канала выберите процесс в поле Сценарий: все входящие сообщения на этот номер запускают выбранный процесс. Канал запускает процесс из активной публикации, поэтому изменения в процессе начнут действовать для клиентов WhatsApp после публикации.
  3. Для голосовых ответов включите в настройках канала Отвечать голосом.
  4. Для ответа после 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
}
ПолеОписание
wamidsID всех отправленных сообщений
wamidID последнего отправленного сообщения
messageTypeЧто отправлено последним: text, image, audio или template
toНомер получателя
channelIdID канала
imagesПо одному элементу на изображение: url, wamid и error (причина, если изображение не отправлено; window_closed -- окно закрыто)
deduplicatedtrue, если это повтор той же отправки и сообщение второй раз не отправлялось

При ошибке:

{
"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Что сделать
NoConversationContextNo WhatsApp conversation to reply to: run from a WhatsApp channel or set channelId and toПроцесс запущен не из WhatsApp -- укажите получателя вручную
ConfigurationErrorWhatsApp channel id is not validПроверьте канал получателя
TooManyImagesToo many images: N (maximum 10)Оставьте не больше 10 изображений
TooLongReply text is too long: N characters (maximum 4096)Сократите текст
EmptyTextReply text is empty and no images are setЗаполните текст или добавьте изображение; проверьте, что переменная в тексте не пустая

Отказы при отправке:

errorTypeТекст errorЧто означает и что сделать
WindowClosedWhatsApp 24h window is closed and no re-engagement was sentОкно закрыто, шаблон не отправлен: выберите шаблон в «Отвечать шаблоном после 24 часов». Для получателя, указанного вручную, шаблон не используется
TemplateUnusableWhatsApp re-engagement template is not approved or does not matchШаблон не одобрен или не синхронизирован в канале диалога либо число параметров не совпадает. Поле code уточняет причину: not_approved, param_count, too_many_parameters, non_body_parameters, mixed_parameters, unreadable
NoConversationNo WhatsApp conversation with this recipient yetЭтот номер еще не писал в выбранный канал -- используйте ноду WhatsApp-шаблон
CredentialsInvalidWhatsApp channel credentials are not validТокен доступа канала перестал работать -- обновите его в настройках канала
GraphApiErrorWhatsApp rejected the messageMeta отклонила сообщение; код Meta -- в поле code
ForbiddenWhatsApp channel does not belong to this projectВыберите канал текущего проекта
SendInProgressWhatsApp reply is still being sent; it will probably be deliveredОтвет еще отправляется; повторно отправлять не нужно
UpstreamUnavailableWhatsApp service is unavailableСервис WhatsApp или Meta недоступны -- повторите позже

Защита от повторной отправки​

Каждая отправка регистрируется до обращения к Meta. Если та же нода в том же запуске повторяет отправку (например, после обрыва связи), сообщение второй раз не уходит: нода возвращает результат первой отправки с deduplicated: true или ошибку SendInProgress, если первая еще не завершилась. Новый запуск процесса -- это новая отправка. Настраивать эту защиту не нужно.

Проверки на холсте​

Если включен показ предупреждений (настройка холста Предупреждения), на ноде появляется значок «!»: красный при ошибке, оранжевый при предупреждении. При наведении показывается список:

ТипСообщение
Ошибка«Нет ни текста, ни изображений — ответ не отправится»
Ошибка«Слишком много изображений: не больше 10»
Предупреждение«Шаблон после 24 часов не выбран — при закрытом окне ответ не отправится»
Предупреждение«Получатель указан не полностью (нужны и канал, и номер) — он будет проигнорирован»

Проверки не мешают сохранить процесс.

Примеры использования​

Ответ агента в WhatsApp​

Канал WhatsApp запускает процесс, агент готовит ответ, нода отправляет его клиенту. Если ответ может уйти позже, чем через 24 часа после сообщения клиента, выберите шаблон в «Отвечать шаблоном после 24 часов» -- иначе такой ответ не будет отправлен.

Изображение с подписью​

Текст:        Ваш заказ {{input.order_id}} собран. Фото упаковки выше.
Изображения: {{node_3.photo_url}}

Сначала уходит изображение, затем текст.

Тихий режим

В заголовке панели есть переключатель тихого режима.