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 и запускает на нём автоматизации.
Сколько времени шаг Call my webhook ждёт ответа вашего сценария, прежде чем завершиться ошибкой.
Последние сообщения чата, передаваемые в history: от старых к новым, последним стоит сообщение, которое запустило выполнение.
Количество символов ответа, отправляемого одним текстовым сообщением WhatsApp; всё, что длиннее, обрезается.
Минимальный интервал между письмами об ошибке для одной автоматизации, когда шаг вебхука завершается ошибкой.
Что n8n Cloud разрешает в узле Code: crypto и moment; self-hosted n8n включает crypto через NODE_FUNCTION_ALLOW_BUILTIN.
Окно обслуживания клиентов после последнего сообщения клиента; после него Meta принимает только шаблонные сообщения.
Как сообщение WhatsApp попадает в AI-агент n8n?
Через автоматизацию на номере. Номер должен получать свои сообщения через easyCoexistence (режим «Through easyCoexistence»), чтобы Meta доставляла их сюда: автоматизация с триггером «A message arrives» и шагом «Call my webhook» отправляет сообщение методом POST на ваш Production URL в n8n. Сценарий отвечает в том же HTTP-ответе, и возвращённый текст уходит клиенту сообщением WhatsApp с вашего номера.
До вызова n8n запуск уже прошёл проверки. Повторная доставка от Meta не запускает второй сценарий, ответ, написанный вами в приложении, приостанавливает автоматизацию в этом чате (по умолчанию на 4 часа), а ответ уходит только в течение 24 часов после последнего сообщения клиента. Ваш сценарий решает только, что сказать.
Что 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.
{
"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, 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 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 n8n | easyCoexistence, when the automation matches | Meta, for every event on the number |
| Time to answer | 20 seconds, reply in the response | No limit: send later through the Graph API |
| Authentication | X-EC-Signature with the automation's secret | A long random secret in the URL path |
| Guards | Dedupe, phone pause and 24-hour check built in | Yours to write |
| What n8n can send | Text in the reply; the other steps of the automation can send buttons, files and templates | Any Cloud API message type, templates included |
| History import | Not available | If saved within 24 hours of connecting |
| Kept by easyCoexistence | Message text for your retention period (90 days by default), run logs 30 days | Nothing |
Как настроить
- 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.
- 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.
- 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.
- 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.
- 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.
Его шаг 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 Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на