Suojaa WhatsApp-automaatiosi: avaimet, webhookit ja allekirjoitukset
Suojaa WhatsApp-automaatio neljästä kohdasta: AI-avain, joka on salattu ja jota käytetään vain AI-vastauksiin; webhook, jota automaatio kutsuu ja joka tarkistaa HMAC-allekirjoituksen ennen kuin luottaa pyyntöön; välitys, joka lähettää saapuvat viestit eteenpäin allekirjoitettuna kierrätettävällä salaisuudella; sekä ihmiset ja avustajat, joilla on pääsy, rajattuna siihen mitä he tarvitsevat.
easyCoexistence tallentaa AI-avaimesi salattuina eikä näytä niitä enää koskaan.
Tallennetut AI-avaimet, allekirjoitussalaisuudet ja numeron Meta-käyttötunniste salataan levossa.
Tallennetusta AI-avaimesta näkyy jälkikäteen vain ”ending in” ja sen viimeiset neljä merkkiä.
Jokaisessa allekirjoitussalaisuudessa on satunnaisuutta: whsec_ ja 24 satunnaista tavua, yksi automaatiota ja yksi välityksen numeroa kohden.
Webhook-osoitteen ja Forward URL:n on oltava julkisia HTTPS-osoitteita; yksityiset ja sisäiset osoitteet hylätään tallennettaessa ja ennen jokaista lähetystä.
Suositeltu raja allekirjoituksen t-arvon iälle, jotta toistetut pyynnöt voidaan hylätä.
Mitä WhatsApp-automaation asetuksissa pitää suojata?
Viisi tunnistetietoa, joilla kullakin on oma paikkansa ja oma korjauksensa, jos se vuotaa. Kaksi niistä kuuluu itse automaatioille: AI-avain ja Call my webhook -allekirjoitussalaisuus. Välityssalaisuus kuuluu numerolle, käyttötunniste ja avustajasi sisäänkirjautuminen tilille. Kun tiedät, mikä on mikä, tiedät myös mitä kierrättää, kun jotain menee pieleen.
Miten AI-avaimet tallennetaan ja käytetään?
Vain hallintapaneelista: Automations-sivun ”AI keys” -painike, sitten ”Test and save”. Avain tarkistetaan ensin palveluntarjoajan maksuttomalla päätepisteellä, joka ei kuluta tokeneita, ja avain, jonka palveluntarjoaja hylkää, hylätään tallentamatta. Toimiva avain salataan levossa AES-256-GCM-algoritmilla, puretaan vain kutsuakseen kyseistä palveluntarjoajaa tekoälyvaiheissasi ja agenteissasi sekä äänsiviestien kirjoittamiseksi tekstiksi OpenAI- tai OpenRouter-avaimella, ja jälkeenpäin näkyy vain ”ending in 1234”. Yksikään MCP-työkalu ei hyväksy eikä palauta avainta, joten se ei kulje keskustelun kautta avustajasi kanssa.
Tilillä on yksi avain per palveluntarjoaja, ja uuden tallentaminen korvaa vanhan. Luo automaatioille oma avain palveluntarjoajalta, käyttörajalla jos palveluntarjoaja tarjoaa sellaisen, jotta se voidaan peruuttaa rikkomatta muita sovelluksiasi. Jos palveluntarjoaja joskus hylkää avaimen, sitä käyttävät automaatiot siirtyvät Paused-tilaan ja saat yhden sähköpostin. Toimivan avaimen tallentaminen käynnistää ne itsestään uudelleen.
Miten varmistat, että Call my webhook -pyyntö on aito?
Tarkista allekirjoitus ennen kuin luet mitään muuta. Jokainen pyyntö kantaa X-EC-Signature-otsikkoa: t=<unix-sekunnit>,v1=<hex HMAC-SHA256 merkkijonosta ”<t>.<raw body>”>, avaimena automaation Signing secret, jonka kopioit editorin vaiheesta tallennuksen jälkeen. Laske HMAC uudelleen raakoihin tavuihin, vertaa vakioajassa ja hylkää t, joka poikkeaa kellostasi yli 5 minuuttia. Runko kertoo lisäksi kaksi asiaa, joihin kannattaa reagoida. dry_run on true, kun pyyntö tulee Try it -painikkeesta, joten ohita kaikki peruuttamattomat toimet, kuten tilauksen luominen. run_id on uniikki jokaiselle ajolle, joten säilytä jo käsitellyt ja hylkää toistettu pyyntö. Vastaa 20 sekunnin sisällä. {"reply": "..."} lähetetään asiakkaalle sellaisenaan, joten älä koskaan välitä asiakkaan tekstiä tarkistamatta.
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." }Miten välityssalaisuudet toimivat ja miten ne kierrätetään?
Numero, jonka asetus on ”Through easyCoexistence”, voi välittää saapuvat viestit omaan järjestelmääsi. Kun tallennat Forward URL -osoitteen ensimmäisen kerran, salaisuus luodaan ja näytetään kerran otsikolla ”Your signing secret, shown once. Copy it now:”. Se allekirjoittaa jokaisen välitetyn POST-pyynnön samalla X-EC-Signature-järjestelmällä. Uusi salaisuus numeron sivulta tai set_inbound_mode-kutsulla, kun rotate_secret on true, luo korvaajan, joka näytetään taas kerran. Siitä eteenpäin kaikki allekirjoitetaan sillä, myös vanhojen toimitusten uudelleenyritykset. Voit myös kirjoittaa oman salaisuuden, vähintään 24 merkkiä, joka tallennetaan eikä näytetä enää koskaan. Välityksen lopettaminen poistaa salaisuuden, joten seuraava URL-tallennus aloittaa uudella.
Kierrätä salaisuus, kun tiimiläinen, jolla oli pääsy, lähtee, kun salaisuus päätyy repositorioon, tikettiin tai lokiin, ja kun vaihdat hosting-palvelua. Call my webhook -salaisuus kuuluu automaatiolle, ja vain tilin omistaja näkee sen. Kun editori näyttää kohdan Uusi salaisuus ”Your system calls a URL” -laukaisimen alla, tuo painike korvaa salaisuuden ja vanha lakkaa toimimasta heti. Automaatiolla, jolla tätä painiketta ei ole, luo automaatio uudelleen, osoita vastaanottimesi uuteen salaisuuteen ja poista sitten vanha automaatio.
Mihin osoitteisiin automaatiot voivat kutsua?
Vain julkisiin HTTPS-osoitteisiin. Call my webhook -URL tai Forward URL, joka alkaa http://, viittaa localhostiin, yksityiseen verkkoalueeseen, .internal- tai .local-nimeen tai pilvipalvelun metadata-osoitteeseen, hylätään tallennettaessa. Osoite tarkistetaan uudelleen DNS-haun jälkeen ennen jokaista pyyntöä, joten julkinen nimi ei myöhemmin voi osoittaa yksityiseen verkkoon. Uudelleenohjauksia ei seurata: 301 tai 302 epäonnistaa vaiheen, joten tallenna lopullinen osoite.
Pidä salaisuudet pois itse URL:ista. list_automations palauttaa jokaisen automaation vaiheet, webhook-URL mukaan lukien, kaikille tiliisi yhdistetyille avustajille. Kyselymerkkijonossa oleva tunniste on siis siellä luettavissa. Anna allekirjoituksen kantaa todistus.
Miten pidät käyttöoikeudet mahdollisimman pieninä?
Anna jokaiselle henkilölle ja työkalulle vain tehtävänsä vaatima pääsy, ja poista käyttämättömät. Yhdistäjän puoli, eli sisäänkirjautuminen, vahvistukset ja estetyt työkalut, on käsitelty sivulla WhatsApp-yhteyden turvallisesta liittämisestä tekoälyyn. Automaatioiden puolella nämä tavat merkitsevät eniten:
- Pyydä
get_api_credentialsvain yksityisessä keskustelussa, sillä numeron käyttötunniste jää silloin keskusteluun. - Suosi Call my webhook -toimintoa tai Forward URL:ää, ennen kuin annat tunnisteen kolmannen osapuolen työkalulle.
- Poista lopetetut automaatiot. Samalla poistuvat niiden allekirjoitussalaisuudet.
- Muista, että ajolokit säilyttävät asiakasviestit ja vastaukset 30 päivää ja Conversations säilyttää keskustelut valitsemasi säilytysajan (30, 90 tai 365 päivää), ja molemmat ovat luettavissa hallintapaneelista ja yhdistetyn avustajan kautta.
- Numerolla, joka on asetettu ”Straight to your system” -tilaan, laita pitkä satunnainen salaisuus callback-URL:n polkuun, koska Metan allekirjoitusta ei voi tarkistaa siinä.
Yleiset virheet
- Allekirjoituksen tarkistaminen JSON:sta, jonka kehys on sarjoittanut uudelleen. Monet jäsentimet muuttavat välilyöntejä, escapointia tai avainten järjestystä, joten laske HMAC raakoihin pyynnön tavuihin aina, kun pinosi niitä tarjoaa.
- Sivuvaikutusten ajaminen testikutsuissa. Try it kutsuu webhookiasi dry_run-arvolla true, ja tilaus, hyvitys tai CRM-kirjoitus, joka siinä tehdään, on oikea.
- AI-avaimen liittäminen avustajan keskusteluun ajan säästämiseksi. Yksikään työkalu ei ota sitä vastaan, ja avain jää keskusteluun. Käytä AI-avaimia hallintapaneelissa.
- Välityksen tarkistaminen Call my webhook -salaisuudella tai päinvastoin. Ne ovat eri salaisuuksia: välityksille yksi per numero, webhook-kutsuille yksi per automaatio.
Se allekirjoittaa jokaisen Call my webhook -pyynnön ja jokaisen välitetyn viestin X-EC-Signature-otsikolla salaisuudella, jonka vain sinä hallitset, ja hylkää webhook-osoitteet, jotka eivät ole julkisia HTTPS-osoitteita. Numerosi pysyy Metan virallisella Cloud API:lla Coexistence-yhteyden kautta, valvottuna 24/7. Hinta on US$ 9 numeroa kohden kuukaudessa alkaen, laskien US$ 0.75:een numeroiden lisääntyessä. Ensimmäiset 3 päivää ovat ilmaiset.
Usein kysytyt kysymykset
Voiko easyCoexistencen henkilökunta tai tuki nähdä AI-avaimeni?
Avainta ei näytetä tallentamisen jälkeen: ei hallintapaneelissa, ei MCP-tuloksissa eikä tukiavustajan lukemissa tiedoissa. Järjestelmä purkaa sen vain itse sillä hetkellä, kun se kutsuu palveluntarjoajaasi AI-vastausta varten.
Kuka voi lukea automaatioiden ajolokit?
Kuka tahansa, joka on kirjautunut easyCoexistence-tilillesi, myös tilille kutsumasi henkilöt, Runs-välilehdellä, sekä tilille yhdistetty avustaja list_automation_runs- ja get_automation_run-työkalujen kautta. Lokit sisältävät asiakkaan viestin ja vastauksen, ja ne poistetaan 30 päivän kuluttua.
Miten poistan AI-avaimen turvallisesti?
Kytke ensin pois (Switch Off) sitä käyttävät automaatiot ja kaikki agentit, jotka toimivat sen varassa, valitse sitten AI keys -kohdasta Remove ja peruuta avain palveluntarjoajalta. Jos poistat avaimen, kun automaatiot vielä käyttävät sitä, ne siirtyvät Paused-tilaan seuraavalla AI-vastauksella ja saat sähköpostin.
Lähettääkö Try it asiakastietoja webhookiisi?
Lähettää vain kirjoittamasi näytetekstin, dry_run-arvolla true ja tyhjällä historialla. Oikeat ajot lähettävät saapuvan viestin ja chatin viimeisimmät viestit, enintään 10, joten käsittele päätepistettäsi asiakastietoja käsittelevänä.
Lue lisää
Valmis aloittamaan?
Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.
Aloita ilmainen kokeiluVahvistettu