Agent AI WhatsApp w n8n, z odpowiedzią napisaną przez Twój workflow
Krok automatyzacji wysyła wiadomość klienta, podpisaną i z maksymalnie 10 ostatnimi wiadomościami czatu, do węzła n8n Webhook. Węzeł AI Agent pisze odpowiedź, węzeł Respond to Webhook zwraca {"reply": "..."} w ciągu 20 sekund, a ten tekst zostaje wysłany z numeru WhatsApp Business, który nadal działa w aplikacji. Wolniejsze agenty otrzymują webhook Meta bezpośrednio i odpowiadają przez Graph API.
easyCoexistence łączy numer WhatsApp Business, którego już używasz w aplikacji, z Cloud API Meta przez Coexistence i uruchamia na nim automatyzacje.
Jak długo krok „Call my webhook” czeka na odpowiedź Twojego workflow, zanim krok zakończy się błędem.
Ostatnie wiadomości czatu wysyłane w history, od najstarszej, kończące się wiadomością, która uruchomiła przebieg.
Liczba znaków odpowiedzi wysyłanej jako jeden tekst WhatsApp; dłuższa część zostaje obcięta.
Najkrótszy odstęp między dwoma e-mailami o awarii tej samej automatyzacji, gdy krok webhook zakończy się błędem.
Co n8n Cloud dopuszcza w węźle Code: crypto i moment; n8n self-hosted włącza crypto przez NODE_FUNCTION_ALLOW_BUILTIN.
Okno obsługi klienta po jego ostatniej wiadomości; po nim Meta przyjmuje tylko wiadomości szablonowe.
Jak wiadomość WhatsApp trafia do agenta AI w n8n?
Przez automatyzację na numerze. Numer musi przyjmować swoje wiadomości przez easyCoexistence (tryb „Through easyCoexistence”), żeby Meta dostarczała je tutaj. Automatyzacja, której wyzwalaczem jest A message arrives, a krokiem Call my webhook, wysyła POST z wiadomością na Twój adres Production URL n8n. Workflow odpowiada w tej samej odpowiedzi HTTP, a zwrócony tekst trafia do klienta jako wiadomość WhatsApp z Twojego numeru.
Zanim n8n zostanie wywołany, przebieg przechodzi już kontrole. Dostawa powtórzona przez Meta nie uruchamia drugiego przebiegu, odpowiedź wpisana w aplikacji wstrzymuje automatyzację w danym czacie (domyślnie na 4 godziny), a odpowiedź wychodzi tylko w ciągu 24 godzin od ostatniej wiadomości klienta. Twój workflow decyduje wyłącznie, co powiedzieć.
Co easyCoexistence wysyła do węzła n8n Webhook?
Żądanie JSON POST z nagłówkiem User-Agent easyCoexistence-automations/1, nagłówkiem X-EC-Event o wartości automation.step i nagłówkiem X-EC-Signature. Pole message zawiera tekst klienta albo symbol zastępczy, np. [image] z podpisem dla mediów; notatka głosowa przychodzi jako [voice message], po którym następuje jej treść, gdy zapisany jest klucz OpenAI lub OpenRouter. Pole history zawiera maksymalnie 10 ostatnich wiadomości czatu, od najstarszej, każda z polem direction: in dla klienta, out dla odpowiedzi automatyzacji i echo dla osoby piszącej z telefonu. Obejmuje wiadomości przechowywane przez okres retencji konta (30, 90 lub 365 dni, domyślnie 90) i wyłącznie te, które przyszły, gdy wiadomości numeru trafiały przez easyCoexistence.
Test z panelu Try it w edytorze wysyła to samo POST z dry_run ustawionym na true, pustym history, przykładowym kontaktem 15550000000 o nazwie Test customer i identyfikatorem wiadomości zaczynającym się od test_. Nikt nie dostaje wtedy wiadomości, ale Twój workflow naprawdę się uruchamia, więc pomiń efekty uboczne, np. tworzenie zamówień, gdy dry_run ma wartość 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" }
]
}Jak sprawdzić podpis w n8n?
Dodaj węzeł Code zaraz po węźle Webhook. X-EC-Signature ma postać t=<unix seconds>,v1=<hex>, gdzie v1 to HMAC-SHA256 z t, kropki i treści, kluczowany Signing secret automatyzacji. Żeby go skopiować, otwórz zapisaną automatyzację i wybierz jej krok Call my webhook. Każda automatyzacja ma własny sekret, a narzędzia MCP nigdy go nie zwracają, więc automatyzacja utworzona przez Twojego asystenta AI nadal wymaga jednego skopiowania z panelu. Przycisk New secret zastępuje go, a stary przestaje działać natychmiast; widzi go tylko właściciel konta, a nie zaproszony członek zespołu.
Odrzuć t starsze niż 5 minut według Twojego zegara, porównuj w stałym czasie i rzuć wyjątek przy błędzie: workflow wtedy kończy się błędem przed Respond to Webhook, n8n odpowiada 500 i nic nie zostaje wysłane. n8n Cloud pozwala na moduł crypto w węźle Code; n8n self-hosted wymaga NODE_FUNCTION_ALLOW_BUILTIN=crypto. Działa też akcja Hmac węzła Crypto z węzłem IF, choć porównanie w IF nie jest wykonywane w stałym czasie.
// 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...Jak skonfigurować węzeł AI Agent i odpowiedź?
Podaj węzłowi AI Agent tekst klienta jako wiadomość użytkownika, a wszystko inne w wiadomości systemowej: kim jest firma, jakie fakty może cytować, jaki ton stosować oraz ostatni czat z history, dzięki czemu pytanie uzupełniające ma sens. Podłącz wybrany model czatu oraz narzędzia, np. narzędzie HTTP Request, które sprawdza zamówienie.
Zakończ węzłem Respond to Webhook, który odpowiada w formacie JSON i umieszcza tekst agenta w polu o nazwie reply. easyCoexistence przycina go, ignoruje pustą lub niebędącą tekstem odpowiedź i wysyła resztę jako jeden tekst WhatsApp do 4 096 znaków, więc proś model o zwykłe zdania zamiast markdownu.
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() }} }Co się dzieje, gdy workflow jest wolny, zawodzi lub nic nie zwraca?
Każdy wynik jest zapisany w zakładce Runs automatyzacji wraz z wyjściem lub błędem kroku, więc zobaczysz, co się stało:
- Brak odpowiedzi w ciągu 20 sekund: krok kończy się błędem Webhook did not answer, nic nie zostaje wysłane, a przebieg pokazuje Failed.
- Status poza zakresem 2xx, także przekierowania: krok kończy się błędem Webhook answered HTTP i kodem.
- Odpowiedź 2xx bez tekstu reply: przebieg ma status Done, krok pokazuje HTTP 200, no reply, a klient nie dostaje nic automatycznie.
- Nieudany przebieg wysyła do Ciebie e-mail, żebyś sam mógł odpowiedzieć temu klientowi, nie częściej niż raz na 6 godzin dla jednej automatyzacji.
- Czat, na który odpowiedziałeś z telefonu w czasie wstrzymania (domyślnie 4 godziny, ustawiane w Advanced), jest pomijany jako
human_activezanim n8n zostanie wywołany. - Kilka szybkich wiadomości uruchamia kilka przebiegów. Wait na 1 minutę przed Call my webhook odpowiada raz, bo nowsza wiadomość, która wybiera tę samą automatyzację, zastępuje czekający przebieg.
Kiedy n8n ma zamiast tego otrzymywać webhook Meta bezpośrednio?
Gdy agent potrzebuje więcej niż 20 sekund, gdy workflow musi widzieć każde zdarzenie (statusy, odpowiedzi z telefonu, identyfikatory mediów), gdy wysyła coś, czego nie obejmuje żaden krok, np. Flow lub wiadomość z katalogiem, albo gdy firma chce 6-miesięcznego importu historii, który trafia tylko do bezpośredniego celu zapisanego w ciągu 24 godzin od połączenia. Tryb bezpośredni wyłącza automatyzacje dla numeru: Meta wysyła własny payload prosto do n8n, a easyCoexistence nie widzi wiadomości.
W n8n użyj zwykłego węzła Webhook, a nie węzła WhatsApp Trigger, który wymaga własnej aplikacji Meta i jej sekretu. Włącz Allow Multiple HTTP Methods, żeby jedna długa, losowa ścieżka obsługiwała handshake GET od Meta oraz POST-y. Odpowiadaj na GET surowym hub.challenge jako tekstem i zapisz ten Production URL z tokenem weryfikacyjnym przez set_webhook_destination. Odpowiedzi idą wtedy z węzła HTTP Request do endpointu wysyłki, a deduplikacja, wstrzymanie z telefonu i sprawdzenie 24 godzin spadają na Ciebie.
| 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 |
Jak to skonfigurować
- 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.
Typowe błędy
- Pozostawienie opcji Respond w węźle Webhook na Immediately. n8n odpowiada od razu Workflow got started, przebieg zapisuje HTTP 200, bez odpowiedzi, a klient nie dostaje nic. Wybierz Using 'Respond to Webhook' Node.
- Wklejenie adresu Test URL, tego z /webhook-test/. Nasłuchuje on tylko wtedy, gdy edytor czeka na zdarzenie testowe; automatyzacje potrzebują adresu Production URL opublikowanego workflow.
- Weryfikacja sekretem przekazywania numeru (forward secret). Call my webhook jest podpisywany Signing secret automatyzacji; forward secret podpisuje tylko przekazane zdarzenia, więc prawdziwe kroki nie przechodzą sprawdzenia.
- Zwracanie tekstu w innym kształcie. Wysyłane jest tylko ciało JSON z polem najwyższego poziomu reply zawierającym ciąg znaków; {"output": "..."} albo ciało text/plain jest zapisywane jako no reply.
Jego krok Call my webhook przekazuje wiadomość klienta do n8n i odsyła odpowiedź, z wbudowaną deduplikacją, wstrzymaniem, gdy odpowiadasz z telefonu, i sprawdzeniem 24 godzin, bez dodatkowej opłaty za przebieg. Od US$ 9 do US$ 0.75 za numer miesięcznie, spadając wraz z dodawaniem kolejnych numerów, z pierwszymi 3 dniami bezpłatnego okresu próbnego.
Najczęściej zadawane pytania
Czy ChatGPT lub Claude mogą utworzyć dla mnie tę automatyzację?
Tak. Po dodaniu konektora easyCoexistence poproś o automatyzację na Twoim numerze, która wysyła przychodzące wiadomości na Twój adres URL n8n. AI wywoła create_automation z krokiem call_webhook, a potem test_automation. Poproś, żeby utworzyła automatyzację wyłączoną, dopóki test nie przejdzie. Signing secret nie jest zwracany przez MCP, więc skopiuj go ze strony automatyzacji.
Czy workflow może wysyłać obrazy, przyciski lub szablony?
Nie przez pole reply, które przenosi wyłącznie tekst. Zamiast tego zrób to w automatyzacji: kroki takie jak Send a picture or file, Ask a question with buttons i Send a template mogą stać przed Call my webhook lub po nim. Inne typy wiadomości wyślij z węzła HTTP Request do Cloud API, używając endpointu wysyłki i tokena, które zwraca get_api_credentials, i nie zwracaj reply, żeby klient nie dostał dwóch odpowiedzi.
Czy jeden workflow może obsłużyć kilka numerów?
Tak. Ustaw po jednej automatyzacji na numer, wskazującej ten sam Production URL, i rozgałęź według channel.phone_number_id lub automation.id. Każda automatyzacja ma własny Signing secret, więc wybierz sekret po automation.id przed sprawdzeniem podpisu.
Czy działa self-hosted n8n?
Tak, jeśli jego Production URL jest publiczny i używa HTTPS. easyCoexistence odrzuca adresy http, localhost, prywatne i wewnętrzne przy zapisie URL oraz ponownie przed każdym wywołaniem, a nie podąża za przekierowaniami.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w