Prijavite seZapočnite besplatni probni period
Meta Tech Provider

Obezbedite WhatsApp automatizacije: ključevi, webhookovi i potpisi

Obezbedite WhatsApp automatizaciju na četiri tačke: AI ključ, šifrovan u mirovanju i korišćen samo za AI odgovore; webhook koji automatizacija poziva, a koji treba da proveri HMAC potpis pre nego što veruje zahtevu; prosleđivanje dolaznih poruka, potpisano tajnom koju možete rotirati; i ljudi i asistenti sa pristupom, ograničeni na ono što im je potrebno.

easyCoexistence čuva vaše AI ključeve šifrovane i nikad ih ne prikazuje ponovo, potpisuje svaki Call my webhook zahtev i svaku prosleđenu poruku sa X-EC-Signature, koristeći tajnu koju samo vi držite, i odbija webhook adrese koje nisu javni HTTPS.

AES-256-GCM

Šifrovanje u mirovanju za sačuvane AI ključeve, tajne za potpisivanje i pristupni token Meta broja.

Last 4

Sve što se od sačuvanog AI ključa ponovo vidi je „ending in“ i poslednja četiri znaka.

192 bits

Slučajnost u svakoj tajni za potpisivanje: whsec_ i 24 slučajna bajta, po jedna za svaku automatizaciju i po jedna za svaki broj za prosleđivanje.

HTTPS only

Webhook i Forward URL moraju biti javni HTTPS; privatne i interne adrese se odbijaju pri čuvanju i pre svakog slanja.

5 minutes

Preporučeno ograničenje starosti vrednosti t u potpisu, radi odbijanja ponovljenih zahteva.

Šta treba zaštititi u postavci WhatsApp automatizacije?

Pet kredencijala, svaki sa svojim mestom i sopstvenom merom ako procuri. Dva pripadaju samim automatizacijama: AI ključ i tajna za potpisivanje Call my webhook. Tajna za prosleđivanje pripada broju, a pristupni token i prijava vašeg asistenta pripadaju nalogu. Kad znate šta je šta, znate šta rotirati kad nešto pođe po zlu.

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.

Kako se AI ključevi čuvaju i koriste?

Samo iz kontrolne table: dugme AI keys na stranici Automations, pa Test and save. Ključ se prvo proverava kod besplatnog endpointa provajdera, koji ne troši tokene, a ključ koji provajder odbije odbacuje se bez čuvanja. Ispravan ključ se šifruje u mirovanju pomoću AES-256-GCM, dešifruje se samo kad se poziva taj provajder za vaše AI korake i agente, kao i za ispisivanje glasovnih poruka na OpenAI ili OpenRouter ključu, a kasnije se prikazuje samo kao „ending in 1234“. Nijedan MCP alat ne prihvata niti vraća ključ, pa on nikad ne prolazi kroz razgovor sa vašim asistentom.

Nalog ima jedan ključ po provajderu, a čuvanje novog zamenjuje stari. Napravite poseban ključ za automatizacije kod provajdera, sa limitom potrošnje ako ga provajder nudi, da bi mogao da se opozove bez prekidanja ostalih aplikacija. Ako ga provajder ikad odbije, automatizacije koje ga koriste prelaze u status „Paused“ i dobijate jedan e-mail. Čuvanje ključa koji radi ponovo ih pokreće samo od sebe.

Kako proveriti da je Call my webhook zahtev autentičan?

Proverite potpis pre nego što pročitate bilo šta drugo. Svaki zahtev nosi X-EC-Signature: t=<unix sekunde>,v1=<hex HMAC-SHA256 od „<t>.<sirovo telo>“>, potpisan tajnom za potpisivanje te automatizacije, koju kopirate iz koraka u uređivaču nakon čuvanja („Signing secret“). Ponovo izračunajte HMAC nad sirovim bajtovima, uporedite ga u konstantnom vremenu i odbijte t koje je dalje od 5 minuta od vašeg sata. Telo vam takođe govori dve stvari vredne reagovanja. dry_run je true kad zahtev dolazi iz Try it, pa preskočite sve što se ne može poništiti, na primer kreiranje porudžbine. A run_id je jedinstven za svako izvršavanje, pa zapamtite one koje ste već obradili i odbijte ponovljen zahtev. Odgovorite u roku od 20 sekundi. {"reply": "..."} se šalje kupcu onako kako je napisano, zato nikad ne prosleđujte tekst kupca bez provere.

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." }

Kako rade tajne za prosleđivanje i kako ih rotirati?

Broj podešen na Through easyCoexistence može da prosledi dolazne poruke vašem sistemu. Prvi put kad sačuvate Forward URL nastaje tajna, koja se prikazuje jednom, pod natpisom „Your signing secret, shown once. Copy it now:“. Njome se potpisuje svaki prosleđeni POST istom šemom X-EC-Signature. Nova tajna na stranici broja, ili set_inbound_mode sa rotate_secret postavljenim na true, pravi zamenu, opet prikazanu jednom, a od tog trenutka se potpisuje sve, uključujući ponovne pokušaje starijih isporuka. Možete i sami da unesete tajnu, od najmanje 24 znaka, koja se čuva i nikad se više ne prikazuje. Dugme Stop forwarding briše tajnu, pa kasnije čuvanje URL-a počinje sa novom.

Rotirajte tajnu posle odlaska člana tima sa pristupom, kad tajna dospe u repozitorijum, tiket ili log, i kad menjate hosting. Tajna Call my webhook pripada automatizaciji i vidi je samo vlasnik naloga. Gde uređivač prikazuje New secret, pod okidačem „Your system calls a URL“, to dugme je zamenjuje i stara odmah prestaje da radi; na automatizaciji bez tog dugmeta ponovo kreirajte automatizaciju, usmerite prijemnik na novu tajnu, pa obrišite staru automatizaciju.

Koje adrese automatizacije mogu da pozivaju?

Samo javne HTTPS adrese. Call my webhook URL ili Forward URL koji počinje sa http://, pokazuje na localhost, privatni mrežni opseg, ime .internal ili .local, ili adresu metapodataka oblaka, odbija se pri čuvanju i ponovo proverava posle DNS-a pre svakog zahteva, pa javno ime ne može naknadno da se usmeri unutar privatne mreže. Preusmerenja se ne prate: 301 ili 302 znači da korak ne uspeva, zato sačuvajte konačnu adresu.

Držite tajne van samog URL-a. list_automations vraća korake svake automatizacije, uključujući webhook URL, svakom asistentu povezanom sa vašim nalogom, pa je token u parametrima upita čitljiv tamo. Neka potpis umesto toga nosi dokaz.

Kako držati pristup na minimumu?

Svakoj osobi i svakom alatu dajte samo pristup koji njihov posao zahteva, a ono što se više ne koristi uklonite. Deo na strani konektora, sa prijavom, potvrdama i blokiranim alatima, obrađen je na stranici o bezbednom povezivanju WhatsApp-a sa AI-jem. Na strani automatizacije, ove navike su najvažnije:

  • Zatražite get_api_credentials samo u privatnom razgovoru, jer pristupni token broja tada ostaje u tom zapisu.
  • Radije koristite Call my webhook ili Forward URL nego predavanje tokena alatu treće strane.
  • Obrišite automatizacije koje ste povukli; time se povlače i njihove tajne za potpisivanje.
  • Zapamtite da logovi izvršavanja čuvaju poruke kupaca i odgovore 30 dana, a Conversations čuvaju razgovore tokom vašeg perioda zadržavanja (30, 90 ili 365 dana), oboje vidljivo na kontrolnoj tabli i preko povezanog asistenta.
  • Na broju podešenom na Straight to your system stavite dugu nasumičnu tajnu u putanju callback URL-a, jer se Metin potpis tamo ne može proveriti.

Česte greške

  • Provera potpisa nad JSON-om koji je okvir ponovo serijalizovao. Mnogi parseri menjaju razmake, escapovanje ili redosled ključeva, pa HMAC izračunajte nad sirovim bajtovima zahteva gde god to vaš stack dozvoljava.
  • Izvršavanje efekata na test pozivima. Try it poziva vaš webhook sa dry_run postavljenim na true, a porudžbina, refundacija ili upis u CRM napravljen tada je stvaran.
  • Lepljenje AI ključa u razgovor sa asistentom da bi se uštedelo vreme. Nijedan alat ga ne prihvata, a ostaje u zapisu razgovora. Koristite AI ključeve na kontrolnoj tabli.
  • Provera prosleđivanja tajnom Call my webhook, ili obrnuto. To su odvojene tajne: jedna po broju za prosleđivanja, jedna po automatizaciji za pozive webhooka.
Ovo radite uz EasyCoexistence

Vaš broj ostaje na zvaničnom Meta Cloud API-ju preko Coexistence, pod nadzorom 24/7. US$ 9 do US$ 0,75 po broju mesečno, pada kako dodajete brojeve, uz prva 3 dana besplatno.

Često postavljana pitanja

Može li osoblje ili podrška easyCoexistence da vidi moj AI ključ?

Ključ se nikad ne prikazuje posle čuvanja: ni na kontrolnoj tabli, ni u MCP rezultatima, ni u činjenicama koje čita asistent za podršku. Dešifruje ga samo sistem, u trenutku kad poziva vašeg provajdera za AI odgovor.

Ko može da čita logove izvršavanja mojih automatizacija?

Svako ko je prijavljen na vaš easyCoexistence nalog, uključujući osobe koje ste pozvali, na kartici Runs, i svaki asistent povezan sa nalogom, preko list_automation_runs i get_automation_run. Logovi sadrže poruku kupca i odgovor i brišu se posle 30 dana.

Kako bezbedno ukloniti AI ključ?

Prvo isključite automatizacije koje ga koriste, i svakog agenta koji radi na njemu, zatim izaberite „Remove“ pod AI keys i opozovite ključ kod provajdera. Uklanjanje dok ga automatizacije i dalje koriste pauzira ih pri sledećem AI odgovoru i šalje vam e-mail.

Da li Try it šalje podatke kupca mom webhooku?

Šalje samo uzorak teksta koji ste ukucali, sa dry_run postavljenim na true i praznom istorijom. Stvarna izvršavanja šalju dolaznu poruku i poslednje poruke iz razgovora, do 10, pa vaš endpoint tretirajte kao da obrađuje podatke kupaca.

Nastavite sa čitanjem

Spremni da počnete?

Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.

Započnite besplatni probni period

Provereno na