Zabezpiecz automatyzacje WhatsApp: klucze, webhooki i podpisy
Zabezpiecz automatyzację WhatsApp w czterech miejscach: klucz AI, przechowywany zaszyfrowany i używany wyłącznie do odpowiedzi AI; webhook wywoływany przez automatyzację, który przed zaufaniem żądaniu powinien sprawdzić podpis HMAC; przekazywanie przychodzących wiadomości, podpisywane sekretem, który można zmienić; oraz osoby i asystentów z dostępem, ograniczonych do tego, czego potrzebują.
easyCoexistence przechowuje Twoje klucze AI zaszyfrowane i nigdy ich nie pokazuje, podpisuje każde żądanie Wywołaj mój webhook i każdą przekazaną wiadomość nagłówkiem X-EC-Signature, używając sekretu znanego tylko Tobie, i odrzuca adresy webhooków, które nie są publicznym HTTPS.
Szyfrowanie w spoczynku zapisanych kluczy AI, sekretów podpisu i tokenu dostępu Meta numeru.
Po zapisaniu Twój klucz AI pokazuje tylko: „kończy się na” jego ostatnie cztery znaki.
Losowość każdego sekretu podpisu: whsec_ i 24 losowe bajty, jeden dla każdej automatyzacji i jeden dla każdego numeru przekazującego.
Adresy URL webhooków i przekazywania muszą być publiczne HTTPS; prywatne i wewnętrzne adresy są odrzucane przy zapisie i przed każdym wysłaniem.
Sugerowany limit wieku wartości t w podpisie, aby odrzucać ponowione żądania.
Co wymaga ochrony w konfiguracji automatyzacji WhatsApp?
Pięć poświadczeń, każde z własnym miejscem i własną naprawą, jeśli wycieknie. Dwa należą do samych automatyzacji: klucz AI i sekret podpisu wywołania Wywołaj mój webhook. Sekret przekazywania należy do numeru, a token dostępu i logowanie Twojego asystenta należą do konta. Wiedza, które jest które, mówi Ci, co rotować, gdy coś pójdzie nie tak.
Jak przechowywane i używane są klucze AI?
Wyłącznie z panelu: przycisk Klucze AI na stronie Automatyzacje, potem Przetestuj i zapisz. Klucz jest najpierw sprawdzany na bezpłatnym endpoincie dostawcy, który nie zużywa tokenów, a klucz odrzucony przez dostawcę jest usuwany bez zapisu. Działający klucz jest szyfrowany w spoczynku algorytmem AES-256-GCM, odszyfrowywany tylko po to, by wywołać tego dostawcę w Twoich krokach AI i agentach oraz by spisywać wiadomości głosowe przy kluczu OpenAI lub OpenRouter, i później pokazywany wyłącznie jako „kończy się na 1234”. Żadne narzędzie MCP nie przyjmuje ani nie zwraca klucza, więc nigdy nie przechodzi przez czat z asystentem.
Konto ma jeden klucz na dostawcę, a zapisanie nowego zastępuje stary. Utwórz osobny klucz do automatyzacji u dostawcy, z limitem wydatków, jeśli dostawca go oferuje, aby można go było unieważnić bez psucia Twoich innych aplikacji. Jeśli dostawca kiedykolwiek go odrzuci, automatyzacje z nim pokazują Wstrzymane i dostajesz jeden e-mail; zapisanie działającego klucza uruchamia je ponownie samodzielnie.
Jak sprawdzić, że żądanie Wywołaj mój webhook jest prawdziwe?
Sprawdź podpis, zanim przeczytasz cokolwiek innego. Każde żądanie niesie nagłówek X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 z „<t>.<surowe ciało>”>, kluczowany sekretem podpisu tej automatyzacji, który kopiujesz z kroku w edytorze po zapisaniu. Przelicz HMAC z surowych bajtów, porównaj w stałym czasie i odrzuć t różniące się od Twojego zegara o więcej niż 5 minut. Treść mówi też o dwóch rzeczach wartych uwagi. dry_run ma wartość true, gdy żądanie pochodzi z Wypróbuj, więc pomiń wszystko, co nieodwracalne, na przykład tworzenie zamówienia. A run_id jest unikalny dla każdego uruchomienia, więc zapamiętuj obsłużone i odrzucaj ponowione żądania. Odpowiedz w ciągu 20 sekund; {"reply": "..."} trafia do klienta dokładnie tak, jak napisano, więc nigdy nie przekazuj tekstu klienta bez sprawdzenia.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"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": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }Jak działają sekrety przekazywania i jak je rotować?
Numer ustawiony na Through easyCoexistence może przekazywać przychodzące wiadomości do Twojego własnego systemu. Przy pierwszym zapisie adresu Forward URL generowany jest sekret, pokazywany raz, pod napisem „Twój sekret podpisu, pokazany raz. Skopiuj go teraz:”. Podpisuje on każde przekazane żądanie POST tym samym schematem X-EC-Signature. Nowy sekret na stronie numeru lub set_inbound_mode z rotate_secret ustawionym na true tworzy zamiennik, znów pokazywany raz, i od tej chwili podpisuje wszystko, także ponowienia starszych dostarczeń. Możesz też wpisać własny sekret, co najmniej 24 znaki, który zostaje zapisany i nigdy więcej nie jest pokazywany. Zatrzymanie przekazywania usuwa sekret, więc zapisanie adresu później zaczyna od nowego.
Rotuj po odejściu członka zespołu z dostępem, po tym jak sekret trafi do repozytorium, zgłoszenia lub logu, i przy zmianie hostingu. Sekret Wywołaj mój webhook należy do automatyzacji i widzi go tylko właściciel konta. Tam, gdzie edytor pokazuje Nowy sekret, przy wyzwalaczu „Your system calls a URL”, ten przycisk go zastępuje, a stary przestaje działać natychmiast; w automatyzacji bez tego przycisku utwórz automatyzację od nowa, ustaw odbiornik na nowy sekret, a potem usuń starą automatyzację.
Które adresy mogą wywoływać automatyzacje?
Tylko publiczne adresy HTTPS. Adres URL Wywołaj mój webhook lub Forward URL, który zaczyna się od http://, wskazuje na localhost, prywatny zakres sieci, nazwę .internal lub .local albo adres metadanych chmury, jest odrzucany przy zapisie i ponownie sprawdzany po DNS przed każdym żądaniem, więc publiczna nazwa nie może później zostać skierowana do prywatnej sieci. Przekierowania nie są śledzone: odpowiedź 301 lub 302 kończy krok niepowodzeniem, więc zapisz ostateczny adres.
Nie umieszczaj sekretów w samym adresie URL. list_automations zwraca kroki każdej automatyzacji, łącznie z adresem URL webhooka, każdemu asystentowi połączonemu z Twoim kontem, więc token w ciągu zapytania jest tam czytelny. Pozwól, by dowód przenosił podpis.
Jak ograniczyć dostęp do minimum?
Daj każdej osobie i każdemu narzędziu tylko dostęp potrzebny do ich zadania i usuwaj to, czego już nie używasz. Strona łącznika, z logowaniem, potwierdzeniami i zablokowanymi narzędziami, jest opisana na stronie o bezpiecznym łączeniu WhatsApp z AI. Po stronie automatyzacji najważniejsze są te nawyki:
- Pytaj o
get_api_credentialstylko w prywatnym czacie: token dostępu numeru zostaje wtedy w tej transkrypcji. - Wybieraj Wywołaj mój webhook albo Forward URL zamiast przekazywania tokenu narzędziu zewnętrznemu.
- Usuwaj wycofane automatyzacje; to także wycofuje ich sekrety podpisu.
- Pamiętaj, że logi uruchomień przechowują wiadomości klientów i odpowiedzi przez 30 dni, a Conversations przechowują czaty przez Twój okres retencji (30, 90 lub 365 dni), i jedne, i drugie są czytelne w panelu i przez połączonego asystenta.
- Przy numerze ustawionym na Bezpośrednio do Twojego systemu umieść długi, losowy sekret w ścieżce adresu URL wywołania zwrotnego, ponieważ podpisu Meta nie da się tam sprawdzić.
Typowe błędy
- Weryfikowanie podpisu na JSON, który Twój framework ponownie zserializował. Wiele parserów zmienia odstępy, kodowanie znaków lub kolejność kluczy; licz HMAC na surowych bajtach żądania tam, gdzie Twój stos je udostępnia.
- Wykonywanie skutków ubocznych przy wywołaniach testowych. Wypróbuj wywołuje Twój webhook z dry_run ustawionym na true; zamówienie, zwrot lub zapis do CRM wykonany wtedy jest prawdziwy.
- Wklejanie klucza AI do czatu z asystentem, żeby zaoszczędzić czas. Żadne narzędzie go nie przyjmuje, a zostaje w transkrypcji; używaj kluczy AI w panelu.
- Sprawdzanie przekazywania sekretem Wywołaj mój webhook albo odwrotnie. To osobne sekrety: jeden na numer dla przekazywania, jeden na automatyzację dla wywołań webhooków.
Twój numer pozostaje w oficjalnym Cloud API Meta przez Coexistence, monitorowany 24/7. Od US$ 9 do US$ 0,75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z bezpłatnym okresem próbnym: pierwsze 3 dni.
Najczęściej zadawane pytania
Czy pracownicy lub wsparcie easyCoexistence mogą zobaczyć mój klucz AI?
Klucz nigdy nie jest wyświetlany po zapisaniu: ani w panelu, ani w wynikach MCP, ani w faktach, które czyta asystent wsparcia. Odszyfrowuje go tylko system, w chwili wywołania Twojego dostawcy przy odpowiedzi AI.
Kto może czytać logi uruchomień automatyzacji?
Każdy zalogowany na Twoim koncie easyCoexistence, w tym osoby, które na nie zaprosiłeś, w zakładce Uruchomienia, oraz każdy asystent połączony z kontem, przez list_automation_runs i get_automation_run. Logi zawierają wiadomość klienta i odpowiedź i są usuwane po 30 dniach.
Jak bezpiecznie usunąć klucz AI?
Najpierw wyłącz automatyzacje, które go używają, i każdego agenta, który na nim działa, potem wybierz Usuń w sekcji Klucze AI i unieważnij klucz u dostawcy. Usunięcie go, gdy automatyzacje nadal go używają, wstrzymuje je przy następnej odpowiedzi AI i wysyła Ci e-mail.
Czy Wypróbuj wysyła dane klienta do mojego webhooka?
Wysyła tylko przykładowy tekst, który wpisałeś, z dry_run ustawionym na true i pustą historią. Prawdziwe uruchomienia wysyłają przychodzącą wiadomość i ostatnie wiadomości czatu, do 10, więc traktuj swój endpoint jak obsługujący dane klientów.
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