Prijavite seZapočnite besplatno probno razdoblje
Meta Tech Provider

Osigurajte WhatsApp automatizacije: ključevi, webhookovi i potpisi

Osigurajte WhatsApp automatizaciju na četiri točke: AI ključ, pohranjen šifrirano i korišten samo za AI odgovore; webhook koji automatizacija poziva, a koji treba provjeriti HMAC potpis prije nego što vjeruje zahtjevu; proslijeđivanje dolaznih poruka, potpisano tajnom koju možete rotirati; i osobe i asistenti s pristupom, ograničeni na ono što trebaju.

easyCoexistence pohranjuje vaše AI ključeve šifrirane i nikad ih ne prikazuje ponovno, potpisuje svaki Call my webhook zahtjev i svaku proslijeđenu poruku potpisom X-EC-Signature tajnom koju držite samo vi te odbija adrese webhooka koje nisu javni HTTPS.

AES-256-GCM

Šifriranje u mirovanju za spremljene AI ključeve, tajne za potpisivanje i pristupni token broja za Meta.

Last 4

Sve što se ponovno vidi od spremljenog AI ključa: "završava na" zadnja četiri znaka.

192 bits

Nasumičnost u svakoj tajni za potpisivanje: whsec_ nakon kojega slijedi 24 nasumična bajta, po jedna za svaku automatizaciju i po jedna za svaki broj za proslijeđivanje.

HTTPS only

URL-ovi za webhook i proslijeđivanje moraju biti javni HTTPS; privatne i interne adrese odbijaju se pri spremanju i prije svakog slanja.

5 minutes

Preporučeno ograničenje starosti vrijednosti t u potpisu, radi odbijanja ponovljenih zahtjeva.

Što treba zaštititi u postavi WhatsApp automatizacije?

Pet vjerodajnica, svaka sa svojim mjestom i svojim popravkom ako procuri. Dvije pripadaju samim automatizacijama: AI ključ i tajna za potpisivanje Call my webhook; tajna za proslijeđivanje pripada broju; pristupni token i prijava vašeg asistenta pripadaju računu. Znati tko je što govori vam što 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 pohranjuju i koriste?

Samo iz nadzorne ploče: gumb AI keys na stranici Automations, zatim Test and save. Ključ se prvo provjerava na besplatnom endpointu pružatelja, koji ne troši tokene, a ključ koji pružatelj odbije odbacuje se bez spremanja. Radni ključ šifrira se u mirovanju algoritmom AES-256-GCM, dešifrira se samo radi poziva tom pružatelju za vaše AI korake i agente te za ispisivanje glasovnih poruka na ključu za OpenAI ili OpenRouter, a poslije se prikazuje samo kao "završava na 1234". Nijedan MCP alat ne prihvaća niti vraća ključ, pa on nikad ne prolazi kroz razgovor s vašim asistentom.

Račun ima jedan ključ po pružatelju, a spremanje novog zamjenjuje stari. Za automatizacije napravite zaseban ključ kod pružatelja, s ograničenjem potrošnje gdje ga pružatelj nudi, kako bi se mogao opozvati bez prekidanja drugih aplikacija. Ako ga pružatelj ikad odbije, automatizacije koje ga koriste prikazuju Paused i dobijete jedan e-mail; spremanje ključa koji radi ih samo ponovno pokreće.

Kako provjeriti da je zahtjev Call my webhook autentičan?

Provjerite potpis prije nego što išta drugo pročitate. Svaki zahtjev nosi X-EC-Signature: t=<unix sekunde>,v1=<hex HMAC-SHA256 od "<t>.<sirovo tijelo>">, ključen tajnom za potpisivanje te automatizacije, koju kopirate iz koraka u uređivaču nakon spremanja. Ponovno izračunajte HMAC nad sirovim bajtovima, usporedite u konstantnom vremenu i odbijte t koji je udaljen više od 5 minuta od vašeg sata. Tijelo vam također govori dvije stvari koje vrijedi uzeti u obzir. dry_run je true kad zahtjev dolazi iz Try it, pa preskočite sve što se ne može poništiti, kao što je stvaranje narudžbe. A run_id je jedinstven za svako izvršavanje, pa zadržite one koje ste obradili i odbijte ponovljeni zahtjev. Odgovorite unutar 20 sekundi; {"reply": "..."} šalje se kupcu točno kako stoji, pa nikad ne prosljeđujte tekst kupca bez provjere.

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 funkcioniraju tajne za proslijeđivanje i kako ih rotirati?

Broj postavljen na Through easyCoexistence može proslijediti svoje dolazne poruke vašem sustavu. Pri prvom spremanju Forward URL-a stvara se tajna i prikazuje se jednom, pod "Your signing secret, shown once. Copy it now:"; njome se potpisuje svaki proslijeđeni POST istom shemom X-EC-Signature. Nova tajna na stranici broja ili set_inbound_mode s postavljenim rotate_secret na true stvara zamjenu, opet prikazanu jednom, i od tada potpisuje sve, uključujući ponovne pokušaje starijih isporuka. Možete upisati i vlastitu tajnu, od najmanje 24 znaka, koja se pohranjuje i više se nikad ne prikazuje. Prestanak proslijeđivanja briše tajnu, pa spremanje URL-a kasnije počinje s novom.

Rotirajte nakon što suradnik s pristupom ode, nakon što tajna završi u repozitoriju, tiketu ili zapisniku, te kad mijenjate hosting. Tajna Call my webhook pripada automatizaciji i vidi je samo vlasnik računa. Gdje uređivač prikazuje New secret, pod okidačem "Your system calls a URL", taj je gumb zamjenjuje i stara odmah prestaje raditi; na automatizaciji bez tog gumba ponovno stvorite automatizaciju, usmjerite svoj prijemnik na novu tajnu, pa obrišite staru automatizaciju.

Koje adrese automatizacije mogu pozivati?

Samo javne HTTPS adrese. URL za Call my webhook ili Forward URL koji počinje s http://, pokazuje na localhost, na privatni mrežni raspon, na ime .internal ili .local ili na adresu cloud metapodataka odbija se pri spremanju i ponovno provjerava nakon DNS-a prije svakog zahtjeva, pa javni naziv kasnije ne može biti preusmjeren u privatnu mrežu. Preusmjeravanja se ne slijede: 301 ili 302 ruši korak, pa spremite konačnu adresu.

Tajne držite izvan samog URL-a. list_automations vraća korake svake automatizacije, uključujući webhook URL, svakom asistentu povezanom s vašim računom, pa je token u query stringu tamo čitljiv. Prepustite dokaz potpisu.

Kako držati pristup na minimumu?

Dajte svakoj osobi i svakom alatu samo pristup koji njihov posao treba i uklonite ono što se više ne koristi. Strana konektora, s prijavom, potvrdama i blokiranim alatima, obrađena je na stranici o sigurnom povezivanju WhatsAppa s AI-jem; na strani automatizacija najvažnije su ove navike:

  • Zatražite get_api_credentials samo u privatnom razgovoru: pristupni token broja tada ostaje u tom zapisu.
  • Dajte prednost Call my webhook ili Forward URL-u umjesto predaje tokena alatu treće strane.
  • Obrišite automatizacije koje ste povukli; time se povlače i njihove tajne za potpisivanje.
  • Zapamtite da zapisnici izvršavanja čuvaju poruke kupaca i odgovore 30 dana, a Conversations čuvaju razgovore tijekom vašeg razdoblja zadržavanja (30, 90 ili 365 dana), oboje čitljivo na nadzornoj ploči i preko vašeg povezanog asistenta.
  • Na broju postavljenom na Straight to your system stavite dugu nasumičnu tajnu u putanju callback URL-a, jer se Metin potpis tamo ne može provjeriti.

Uobičajene pogreške

  • Provjera potpisa nad JSON-om koji je okvir ponovno serijalizirao. Mnogi parseri mijenjaju razmake, escapiranje ili redoslijed ključeva; računajte HMAC nad sirovim bajtovima zahtjeva kad god vaš stack to omogućuje.
  • Pokretanje nuspojava na test pozivima. Try it poziva vaš webhook s dry_run postavljenim na true; narudžba, povrat ili upis u CRM napravljen tada je stvaran.
  • Lijepljenje AI ključa u razgovor s vašim asistentom radi uštede vremena. Nijedan alat ga ne prihvaća, a ostaje u zapisu razgovora; koristite AI ključeve na nadzornoj ploči.
  • Provjera proslijeđivanja tajnom Call my webhook, ili obrnuto. To su zasebne tajne: jedna po broju za proslijeđivanja, jedna po automatizaciji za pozive webhooka.
Radite ovo uz EasyCoexistence

Vaš broj ostaje na Metinom službenom Cloud API-ju putem Coexistencea, nadziran 24/7. Od US$ 9 do US$ 0,75 po broju mjesečno, uz pad kako dodajete brojeve, s prvih 3 dana besplatno.

Često postavljana pitanja

Može li osoblje ili podrška easyCoexistencea vidjeti moj AI ključ?

Ključ se nikad ne prikazuje nakon spremanja, ni na nadzornoj ploči, ni u rezultatima MCP-a, ni u podacima koje čita asistent podrške. Dešifrira ga samo sustav, u trenutku kad poziva vašeg pružatelja za AI odgovor.

Tko može čitati zapisnike izvršavanja mojih automatizacija?

Svatko prijavljen u vaš račun easyCoexistence, uključujući osobe koje ste pozvali, na kartici Runs, i svaki asistent povezan s računom, preko list_automation_runs i get_automation_run. Zapisnici sadrže poruku kupca i odgovor te se brišu nakon 30 dana.

Kako sigurno ukloniti AI ključ?

Prvo ih isključite gumbom Switch Off, kao i svakog agenta koji radi na njemu, zatim odaberite Remove pod AI keys i opozovite ključ kod pružatelja. Uklanjanje dok ga automatizacije još koriste pauzira ih pri sljedećem AI odgovoru i šalje vam e-mail.

Šalje li Try it podatke kupca mojem webhooku?

Šalje samo uzorak teksta koji ste upisali, s dry_run postavljenim na true i praznom poviješću. Stvarna izvršavanja šalju dolaznu poruku i nedavne poruke razgovora, do 10, pa vaš endpoint tretirajte kao onaj koji obrađuje podatke kupaca.

Nastavite čitati

Spremni za početak?

Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.

Započnite besplatno probno razdoblje

Provjereno na