ВойтиНачать бесплатный пробный период
Meta Tech Provider

WhatsApp AI-агент в n8n: ответ пишет ваш сценарий

Шаг автоматизации отправляет сообщение клиента в узел n8n Webhook методом POST: запрос подписан и содержит до 10 последних сообщений чата. Узел AI Agent пишет ответ, узел Respond to Webhook возвращает {"reply": "..."} в течение 20 секунд, и этот текст отправляется с номера WhatsApp Business, который продолжает работать в приложении. Более медленные агенты получают вебхук Meta напрямую и отвечают через Graph API.

easyCoexistence подключает номер WhatsApp Business, который вы уже используете в приложении, к Cloud API Meta через Coexistence и запускает на нём автоматизации.

20 s

Сколько времени шаг Call my webhook ждёт ответа вашего сценария, прежде чем завершиться ошибкой.

10

Последние сообщения чата, передаваемые в history: от старых к новым, последним стоит сообщение, которое запустило выполнение.

4,096

Количество символов ответа, отправляемого одним текстовым сообщением WhatsApp; всё, что длиннее, обрезается.

6 hours

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

2 modules

Что n8n Cloud разрешает в узле Code: crypto и moment; self-hosted n8n включает crypto через NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Окно обслуживания клиентов после последнего сообщения клиента; после него Meta принимает только шаблонные сообщения.

Как сообщение WhatsApp попадает в AI-агент n8n?

Через автоматизацию на номере. Номер должен получать свои сообщения через easyCoexistence (режим «Through easyCoexistence»), чтобы Meta доставляла их сюда: автоматизация с триггером «A message arrives» и шагом «Call my webhook» отправляет сообщение методом POST на ваш Production URL в n8n. Сценарий отвечает в том же HTTP-ответе, и возвращённый текст уходит клиенту сообщением WhatsApp с вашего номера.

До вызова n8n запуск уже прошёл проверки. Повторная доставка от Meta не запускает второй сценарий, ответ, написанный вами в приложении, приостанавливает автоматизацию в этом чате (по умолчанию на 4 часа), а ответ уходит только в течение 24 часов после последнего сообщения клиента. Ваш сценарий решает только, что сказать.

1Customer writesTo the number you keep in the WhatsApp Business app
2Call my webhookSigned POST with the message and recent chat
3n8n AI AgentWebhook node, signature check, AI Agent node
4Respond to Webhook{"reply": "..."} within 20 seconds
5Reply sentAlso shown in the app's chat thread

Что easyCoexistence отправляет в узел n8n Webhook?

JSON-запрос POST с User-Agent easyCoexistence-automations/1, заголовком X-EC-Event со значением automation.step и заголовком X-EC-Signature. В поле message лежит текст клиента или заглушка, например [image] с подписью для медиа; голосовое сообщение приходит как [voice message], а за ним его текст, если сохранён ключ OpenAI или OpenRouter. В поле history лежат до 10 последних сообщений чата, от старых к новым; у каждого есть direction: in для клиента, out для ответа автоматизации и echo для сообщения, написанного человеком с телефона. Охватываются сообщения, хранящиеся в течение срока хранения аккаунта (30, 90 или 365 дней, по умолчанию 90), и только те, что пришли, пока сообщения номера шли через easyCoexistence.

Тест из панели Try it в редакторе отправляет тот же POST с dry_run, равным true, пустым history, тестовым контактом 15550000000 с именем Test customer и id сообщения, начинающимся с test_. Никому ничего не отправляется, но ваш сценарий реально выполняется, поэтому пропускайте побочные действия, например создание заказов, когда dry_run равен true.

POST body of a Call my webhook step
{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
  "run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
  "channel": {
    "type": "whatsapp",
    "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
    "phone": "+1 631-555-0142",
    "phone_number_id": "106540352242922"
  },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": {
    "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
    "type": "text",
    "text": "Do you have gluten-free bread today?",
    "at": "2026-11-11T14:02:11.000Z"
  },
  "history": [
    { "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
    { "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
    { "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
  ]
}

Как проверить подпись в n8n?

Добавьте узел Code сразу после узла Webhook. X-EC-Signature имеет вид t=<unix seconds>,v1=<hex>, где v1 представляет собой HMAC-SHA256 от t, точки и тела запроса, с ключом, которым служит Signing secret автоматизации. Чтобы его скопировать, откройте сохранённую автоматизацию и выберите её шаг Call my webhook. У каждой автоматизации свой секрет, а инструменты MCP его никогда не возвращают, поэтому автоматизации, созданной вашим ИИ, всё равно нужно одно копирование из панели. Кнопка New secret заменяет его, и старый сразу перестаёт работать; видеть его может только владелец аккаунта, а не приглашённый участник команды.

Отклоняйте t, если он отличается от часов вашего сервера больше чем на 5 минут, сравнивайте в постоянное время и выбрасывайте ошибку при сбое: тогда сценарий падает до Respond to Webhook, n8n отвечает 500, и ничего не отправляется. n8n Cloud разрешает модуль crypto в узлах Code; self-hosted n8n требует NODE_FUNCTION_ALLOW_BUILTIN=crypto. Действие Hmac узла Crypto вместе с узлом IF тоже работает, однако сравнение в IF не выполняется за постоянное время.

n8n Code node: verify X-EC-Signature
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page

const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');

// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');

return { json: $json.body }; // event, dry_run, contact, message, history...

Как настроить узел AI Agent и ответ?

Передайте узлу AI Agent текст клиента как user message, а всё остальное поместите в system message: кто ваш бизнес, какие факты он может цитировать, тон и недавний чат из history, чтобы уточняющий вопрос был понятен. Подключите нужную модель чата и инструменты, например HTTP Request tool, который ищет заказ.

Завершите узлом Respond to Webhook, который отвечает в формате JSON и кладёт текст агента в поле reply. easyCoexistence обрезает пробелы, игнорирует пустой ответ или ответ не строкой и отправляет остальное одним текстовым сообщением WhatsApp длиной до 4 096 символов, поэтому просите у модели простые предложения, а не markdown.

AI Agent and Respond to Webhook settings
AI Agent node
  Prompt: Define below
  Prompt (User Message): {{ $json.message.text }}
  Options > System Message:
    You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
    Reply in 1 to 3 short sentences, in the customer's language, as plain text.
    Never invent prices or stock. If unsure, say a person will reply here soon.
    Recent chat, oldest first:
    {{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
  Chat Model: your OpenAI, Anthropic or OpenRouter model
  Tools (optional): an HTTP Request tool that looks up orders

Respond to Webhook node
  Respond With: JSON
  Response Body: { "reply": {{ $json.output.toJsonString() }} }

Что происходит, если сценарий медленный, падает или ничего не возвращает?

Каждый исход записывается во вкладку Runs автоматизации с выводом или ошибкой шага, так что вы видите, что произошло:

  • Нет ответа за 20 секунд: шаг завершается ошибкой Webhook did not answer, ничего не отправляется, а запуск показывает Failed.
  • Статус вне диапазона 2xx, включая редиректы: шаг завершается ошибкой Webhook answered HTTP и кодом.
  • Ответ 2xx без строки reply: запуск имеет статус Done, шаг показывает HTTP 200 без reply, и клиент не получает автоматического ответа.
  • Упавший запуск присылает вам письмо, чтобы вы сами ответили этому клиенту, не чаще одного раза в 6 часов для одной автоматизации.
  • Чат, на который вы ответили с телефона в пределах паузы (по умолчанию 4 часа, настраивается в Advanced), пропускается с причиной human_active до вызова n8n.
  • Несколько быстрых сообщений запускают несколько выполнений. 1-минутный Wait перед Call my webhook отвечает один раз, потому что более новое сообщение, попавшее в ту же автоматизацию, заменяет ожидающий запуск.

Когда вместо этого n8n должен получать вебхук Meta напрямую?

Когда агенту нужно больше 20 секунд, когда сценарий должен видеть каждое событие (статусы, ответы с телефона, id медиа), когда он отправляет то, что не покрывает ни один шаг, например Flow или сообщение каталога, либо когда бизнесу нужен импорт истории за 6 месяцев, который идёт только на прямой адрес, сохранённый в течение 24 часов после подключения. Прямой режим выключает автоматизации для номера: Meta отправляет своё тело запроса прямо в n8n, и easyCoexistence сообщения не видит.

В n8n используйте обычный узел Webhook, а не WhatsApp Trigger, который ожидает ваше собственное приложение Meta и его секрет. Включите Allow Multiple HTTP Methods, чтобы один длинный случайный путь принимал GET-рукопожатие Meta и POST-запросы; на GET отвечайте сырым hub.challenge как текстом и сохраните этот Production URL с токеном верификации через set_webhook_destination. Ответы тогда уходят из узла HTTP Request на эндпоинт отправки, а дедупликация, пауза при ответе с телефона и проверка 24 часов становятся вашими.

Call my webhook (Automations on)Direct webhook (automations off)
Who calls n8neasyCoexistence, when the automation matchesMeta, for every event on the number
Time to answer20 seconds, reply in the responseNo limit: send later through the Graph API
AuthenticationX-EC-Signature with the automation's secretA long random secret in the URL path
GuardsDedupe, phone pause and 24-hour check built inYours to write
What n8n can sendText in the reply; the other steps of the automation can send buttons, files and templatesAny Cloud API message type, templates included
History importNot availableIf saved within 24 hours of connecting
Kept by easyCoexistenceMessage text for your retention period (90 days by default), run logs 30 daysNothing

Как настроить

  1. Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
  2. Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
  3. Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
  4. Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
  5. Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.

Распространённые ошибки

  • Опция Respond в узле Webhook оставлена на Immediately. n8n сразу отвечает Workflow got started, в логе запуска HTTP 200, без reply, и клиент ничего не получает. Выберите Using 'Respond to Webhook' Node.
  • Вставка Test URL, того с /webhook-test/. Он слушает только пока редактор ждёт тестовое событие; автоматизациям нужен Production URL опубликованного сценария.
  • Проверка по forward secret номера. Call my webhook подписан Signing secret автоматизации; forward secret подписывает только пересланные события, поэтому настоящие шаги не проходят проверку.
  • Ответ в другом формате. Отправляется только JSON-тело с верхнеуровневой строкой reply; {"output": "..."} или тело text/plain записываются в лог как no reply.
Настройка с EasyCoexistence

Его шаг Call my webhook передаёт сообщение клиента в n8n и возвращает ответ, а дедупликация, пауза при ответе с телефона и проверка 24 часов встроены, без дополнительной платы за запуск. От US$ 9 за подключённый номер в месяц до US$ 0,75 по мере добавления номеров, первые 3 дня бесплатно.

Часто задаваемые вопросы

Может ли ChatGPT или Claude создать эту автоматизацию за меня?

Да. Добавив коннектор easyCoexistence, попросите автоматизацию на вашем номере, которая отправляет входящие сообщения на ваш URL n8n. ИИ вызывает create_automation с шагом call_webhook, затем test_automation. Попросите создать автоматизацию выключенной, пока тест не пройдёт. Signing secret через MCP не возвращается, поэтому скопируйте его со страницы автоматизации.

Могут ли сценарии отправлять изображения, кнопки или шаблоны?

Не через поле reply, которое несёт только текст. Пусть это сделает автоматизация: шаги вроде «Send a picture or file», «Ask a question with buttons» и «Send a template» могут стоять до или после «Call my webhook». Остальные типы сообщений отправляйте из узла HTTP Request в Cloud API, с эндпоинтом отправки и токеном, которые возвращает get_api_credentials, и не возвращайте reply, чтобы клиент не получил два ответа.

Может ли один сценарий отвечать на несколько номеров?

Да. Направьте по одной автоматизации на каждый номер на один и тот же Production URL и ветвите по channel.phone_number_id или automation.id. У каждой автоматизации свой Signing secret, поэтому выбирайте секрет по automation.id до проверки подписи.

Работает ли self-hosted n8n?

Да, если его Production URL доступен по публичному HTTPS. easyCoexistence отклоняет http, localhost, частные и внутренние адреса при сохранении URL и снова перед каждым вызовом, и не следует редиректам.

Читайте дальше

Как сообщения WhatsApp доходят до вашего сервера: напрямую или через управляемый режим, и проверка подписиНапрямую: Meta шлёт вебхуки на ваш сервер. Через сервис: автоматизации отвечают, подписанная копия уходит на Forward URL.ИИ-агент для WhatsApp на Node.js и Python на номере CoexistenceКод на Node.js и Python для ИИ-агента на номере Coexistence: проверка подписанных событий, пауза при ответе человека, пропуск дублей и проверка окна.WhatsApp AI по типу бизнеса: готовые сценарии для ресторанов, клиник, салонов и магазиновАвтоматизации WhatsApp для ресторанов, клиник, салонов, интернет-магазинов, недвижимости и авторов курсов: триггеры, шаги, промпт AI и передача человеку.Справочник автоматизаций WhatsApp: триггеры, шаги, переменные и лимитыВсе триггеры, шаги, поля, лимиты, значения по умолчанию, переменные и приоритеты автоматизаций WhatsApp easyCoexistence, со схемой create_automation.Подключите WhatsApp к n8n через официальный Cloud APIНаправляйте сообщения WhatsApp в сценарий n8n через официальный Cloud API, сохранив ответы с телефона. Без подключённого устройства.MCP или вебхук: что вам действительно нужноMCP действует по запросу. Вебхук реагирует на событие. Почему ассистент не может сам отвечать клиентам и зачем большинству систем нужны оба.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на