Conectați-văÎncepeți perioada de probă gratuită
Meta Tech Provider

Protejați automatizările WhatsApp: chei, webhook-uri și semnături

Securizați o automatizare WhatsApp în patru puncte: cheia AI, stocată criptat și folosită doar pentru răspunsurile AI; webhook-ul apelat de automatizare, care ar trebui să verifice o semnătură HMAC înainte de a avea încredere într-o cerere; redirecționarea mesajelor primite, semnată cu un secret pe care îl puteți roti; și persoanele și asistenții cu acces, limitați la ce au nevoie.

easyCoexistence păstrează cheile AI criptate și nu le mai afișează niciodată, semnează fiecare cerere Call my webhook și fiecare mesaj redirecționat cu X-EC-Signature, folosind un secret pe care doar dumneavoastră îl dețineți, și refuză adresele webhook care nu sunt HTTPS publice.

AES-256-GCM

Criptare în stocare pentru cheile AI salvate, secretele de semnare și token-ul de acces Meta al numărului.

Last 4

Tot ce mai vedeți dintr-o cheie AI salvată este „se termină în” urmat de ultimele patru caractere.

192 bits

Aleatoriu în fiecare secret de semnare: whsec_ urmat de 24 de octeți aleatorii, unul pentru fiecare automatizare și unul pentru fiecare număr de redirecționare.

HTTPS only

Adresele webhook și de redirecționare trebuie să fie HTTPS publice; adresele private și interne sunt refuzate la salvare și înainte de fiecare trimitere.

5 minutes

Limită recomandată pentru vechimea valorii t din semnătură, pentru a refuza cererile reluate.

Ce trebuie protejat într-o configurare de automatizare WhatsApp?

Cinci credențiale, fiecare cu locul ei și cu propria remediere dacă ajunge în mâini greșite. Două dintre ele aparțin direct automatizărilor: cheia AI și secretul de semnare al pasului „Call my webhook”; secretul de redirecționare aparține numărului; token-ul de acces și autentificarea asistentului aparțin contului. Să știți care este care vă spune ce trebuie rotit atunci când apare o problemă.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

Cum sunt stocate și folosite cheile AI?

Doar din panoul de control: butonul „AI keys” de pe pagina Automations, apoi „Test and save”. Cheia este mai întâi verificată printr-un endpoint gratuit al furnizorului, care nu consumă tokeni, iar o cheie respinsă de furnizor este eliminată fără a fi salvată. O cheie funcțională este criptată în stocare cu AES-256-GCM, decriptată doar pentru a apela acel furnizor pentru pașii AI și agenții dumneavoastră, precum și pentru a transcrie mesajele vocale pe o cheie OpenAI sau OpenRouter, și afișată ulterior doar ca „se termină în 1234”. Niciun instrument MCP nu acceptă sau nu returnează o cheie, astfel încât aceasta nu trece niciodată printr-o conversație cu asistentul dumneavoastră.

Un cont are o singură cheie pentru fiecare furnizor, iar salvarea uneia noi o înlocuiește pe cea veche. Creați o cheie dedicată automatizărilor la furnizor, cu o limită de cheltuieli acolo unde furnizorul o oferă, astfel încât să poată fi revocată fără a întrerupe celelalte aplicații ale dumneavoastră. Dacă furnizorul o respinge vreodată, automatizările care o folosesc apar ca „Paused” și primiți un singur e-mail; salvarea unei chei funcționale le repornește singure.

Cum verificați că o cerere Call my webhook este autentică?

Verificați semnătura înainte de a citi orice altceva. Fiecare cerere poartă X-EC-Signature: t=<unix seconds>,v1=<HMAC-SHA256 hexadecimal al lui „<t>.<corpul brut>”>, cheia fiind „Signing secret”-ul automatizării respective, pe care îl copiați din pasul din editor după salvare. Recalculați HMAC-ul peste octeții bruți, comparați în timp constant și refuzați o valoare t care diferă cu mai mult de 5 minute de ceasul dumneavoastră. Corpul cererii vă mai spune două lucruri care merită luate în seamă. dry_run este true când cererea provine de la „Try it”, deci săriți peste orice acțiune ireversibilă, cum ar fi crearea unei comenzi. Iar run_id este unic pentru fiecare rulare, așa că păstrați-le pe cele deja procesate și refuzați o cerere reluată. Răspundeți în maximum 20 de secunde; {"reply": "..."} este trimis clientului exact cum este scris, așa că nu transmiteți niciodată textul clientului fără verificare.

A Call my webhook request: headers and body
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." }

Cum funcționează secretele de redirecționare și cum le rotiți?

Un număr setat la Through easyCoexistence poate redirecționa mesajele primite către propriul sistem. Prima dată când salvați un Forward URL, este generat un secret, afișat o singură dată, sub „Your signing secret, shown once. Copy it now:”; acesta semnează fiecare POST redirecționat cu aceeași schemă X-EC-Signature. Un secret nou din pagina numărului sau set_inbound_mode cu rotate_secret setat la true generează un înlocuitor, tot afișat o singură dată, iar de atunci semnează totul, inclusiv reîncercările livrărilor mai vechi. Puteți introduce și un secret propriu, de cel puțin 24 de caractere, care este stocat și nu mai este afișat niciodată. Oprirea redirecționării șterge secretul, astfel încât salvarea unui URL mai târziu începe cu unul nou.

Rotiți după ce un coleg cu acces pleacă, după ce un secret ajunge într-un depozit de cod, într-un tichet sau într-un jurnal și când schimbați găzduirea. Secretul Call my webhook aparține automatizării și doar proprietarul contului îl vede. Acolo unde editorul afișează New secret, sub un declanșator „Your system calls a URL”, acel buton îl înlocuiește, iar cel vechi nu mai funcționează imediat; la o automatizare fără acest buton, creați din nou automatizarea, indicați receptorul către noul secret și apoi ștergeți automatizarea veche.

Ce adrese pot apela automatizările?

Doar adrese HTTPS publice. Un URL Call my webhook sau un Forward URL care începe cu http://, indică localhost, o plajă de adrese private, un nume .internal sau .local ori o adresă de metadate a cloud-ului este refuzat la salvare și verificat din nou după DNS înainte de fiecare cerere, astfel încât un nume public să nu poată fi îndreptat ulterior spre o rețea privată. Redirecționările nu sunt urmate: un 301 sau 302 eșuează pasul, așa că salvați adresa finală.

Nu puneți secrete în URL în sine. list_automations returnează pașii fiecărei automatizări, inclusiv URL-ul webhook, oricărui asistent conectat la contul dumneavoastră, deci un token din șirul de interogare poate fi citit acolo. Lăsați semnătura să aducă dovada.

Cum mențineți accesul la minimum?

Acordați fiecărei persoane și fiecărui instrument doar accesul de care are nevoie pentru sarcina sa și eliminați ce nu mai este folosit. Partea de conector, cu autentificare, confirmări și instrumente blocate, este acoperită pe pagina despre conectarea WhatsApp la un AI în siguranță; pe partea de automatizări, aceste obiceiuri contează cel mai mult:

  • Cereți get_api_credentials doar într-o conversație privată: token-ul de acces al numărului rămâne atunci în acea transcriere.
  • Preferați Call my webhook sau un Forward URL în locul predării token-ului unui instrument terț.
  • Ștergeți automatizările retrase; astfel se retrag și secretele lor de semnare.
  • Rețineți că jurnalele de rulare păstrează mesajele și răspunsurile clienților timp de 30 de zile, iar Conversations păstrează conversațiile pe perioada dumneavoastră de retenție (30, 90 sau 365 de zile), ambele citibile în panoul de control și prin asistentul conectat.
  • Pentru un număr setat la Straight to your system, puneți un secret lung și aleatoriu în calea URL-ului de callback, deoarece semnătura Meta nu poate fi verificată acolo.

Greșeli frecvente

  • Verificarea semnăturii peste un JSON re-serializat de framework-ul dumneavoastră. Multe parsere schimbă spațierea, escaparea sau ordinea cheilor; calculați HMAC-ul peste octeții bruți ai cererii oriunde stiva dumneavoastră îi expune.
  • Rularea efectelor secundare la apelurile de test. Try it apelează webhook-ul dumneavoastră cu dry_run setat la true; o comandă, o rambursare sau o scriere în CRM făcută atunci este reală.
  • Lipirea unei chei AI într-o conversație cu asistentul ca să economisiți timp. Niciun instrument nu o primește și rămâne în transcriere; folosiți cheile AI din panoul de control.
  • Verificarea unei redirecționări cu secretul Call my webhook sau invers. Sunt secrete separate: unul pentru fiecare număr, pentru redirecționări, și unul pentru fiecare automatizare, pentru apelurile webhook.
Faceți acest lucru cu EasyCoexistence

Numărul dumneavoastră rămâne pe Cloud API oficial al Meta prin Coexistence, monitorizat 24/7. De la US$ 9 pe număr conectat pe lună, scăzând la US$ 0,75 pe măsură ce adăugați numere, cu primele 3 zile gratuite.

Întrebări frecvente

Poate personalul sau suportul easyCoexistence să vadă cheia mea AI?

Cheia nu este afișată niciodată după ce o salvați: nici în panoul de control, nici în rezultatele MCP și nici în informațiile pe care le citește asistentul de suport. Este decriptată doar de sistem, în momentul în care apelează furnizorul dumneavoastră pentru un răspuns AI.

Cine poate citi jurnalele de rulare ale automatizărilor mele?

Oricine este autentificat în contul dumneavoastră easyCoexistence, inclusiv persoanele invitate în el, în fila Runs, și orice asistent conectat la cont, prin list_automation_runs și get_automation_run. Jurnalele includ mesajul clientului și răspunsul și sunt șterse după 30 de zile.

Cum scot în siguranță o cheie AI?

Dezactivați mai întâi automatizările care o folosesc și orice agent care rulează pe ea, apoi selectați Remove sub AI keys și revocați cheia la furnizor. Eliminarea ei cât timp automatizările o mai folosesc le pune pe pauză la următorul răspuns AI și vă trimite un e-mail.

Trimite Try it date ale clienților către webhook-ul meu?

Trimite doar textul de probă pe care l-ați scris, cu dry_run setat la true și un istoric gol. Rulările reale trimit mesajul primit și ultimele mesaje ale conversației, până la 10, așa că tratați endpoint-ul dumneavoastră ca pe un sistem care gestionează date ale clienților.

Continuați să citiți

Gata să începeți?

Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.

Începeți perioada de probă gratuită

Verificat la