Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

I-secure ang inyong WhatsApp automations: keys, webhooks at signatures

I-secure ang WhatsApp automation sa apat na punto: ang AI key, naka-store nang naka-encrypt at ginagamit lang para sa AI replies; ang webhook na tinatawagan ng automation, na dapat i-verify ang HMAC signature bago pagkatiwalaan ang request; ang forward ng mga papasok na mensahe, na naka-sign gamit ang secret na puwedeng i-rotate; at ang mga tao at assistant na may access, na limitado lang sa kailangan nila.

Itinatabi ng easyCoexistence ang inyong AI keys nang naka-encrypt at hindi na ipinapakita pa, pinipirmahan ang bawat Call my webhook request at bawat na-forward na mensahe ng X-EC-Signature gamit ang secret na kayo lang ang may hawak, at tinatanggihan ang webhook address na hindi public HTTPS.

AES-256-GCM

Naka-encrypt sa storage ang mga naka-save na AI keys, signing secrets, at ang Meta access token ng numero.

Last 4

Ang makikita na lang sa naka-save na AI key ay "ending in" at ang huling apat na character nito.

192 bits

Random ang bawat signing secret: whsec_ kasunod ng 24 random bytes, isa kada automation at isa kada forwarding numero.

HTTPS only

Dapat public HTTPS ang Webhook at Forward URL; tinatanggihan ang private at internal na address kapag sine-save at bago ang bawat pagpapadala.

5 minutes

Iminumungkahing limitasyon sa edad ng t value ng signature, para tanggihan ang mga na-replay na request.

Ano ang kailangang protektahan sa WhatsApp automation setup?

Limang credential, bawat isa ay may sariling lugar at sariling ayos kung sakaling ma-leak. Dalawa rito ay sa mismong automations: ang AI key at ang signing secret ng Call my webhook; ang forward secret ay sa numero; ang access token at ang sign-in ng inyong assistant ay sa account. Ang pag-alam kung alin ang alin ang magsasabi sa inyo kung ano ang dapat i-rotate kapag may nangyaring mali.

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.

Paano iniimbak at ginagamit ang AI keys?

Sa dashboard lang: ang AI keys button sa Automations page, pagkatapos ang Test and save. Sinusuri muna ang key sa isang libreng endpoint ng provider, na hindi gumagastos ng tokens, at kapag tinanggihan ng provider ang key, itinatapon ito nang hindi naka-save. Ang gumaganang key ay naka-encrypt sa storage gamit ang AES-256-GCM, dine-decrypt lang para tawagan ang provider para sa inyong AI steps at agents, at para isulat bilang teksto ang mga voice message sa OpenAI o OpenRouter key, at pagkatapos ay ipinapakita lang bilang "ending in 1234". Walang MCP tool na tumatanggap o nagbabalik ng key, kaya hindi ito dumadaan sa chat ninyo sa assistant.

Isang key lang kada provider ang puwede sa isang account, at ang pag-save ng bago ay nagpapalit sa luma. Gumawa ng hiwalay na key para sa automations sa provider, na may spending limit kung meron, para ma-revoke ito nang hindi nasisira ang iba ninyong app. Kapag tinanggihan ito ng provider, mapupunta sa Paused ang mga automation na gumagamit nito at makakatanggap kayo ng isang email; ang pag-save ng key na gumagana ay awtomatikong magpapatakbong muli sa kanila.

Paano i-verify na tunay ang request ng Call my webhook?

I-check muna ang signature bago basahin ang iba. Bawat request ay may dalang X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 ng "<t>.<raw body>">, na naka-key sa Signing secret ng automation na iyon, na kinokopya ninyo sa hakbang sa editor pagkatapos mag-save. I-recompute ang HMAC sa raw bytes, ikumpara sa constant time, at tanggihan ang t na lalampas ng 5 minuto sa orasan ninyo. May dalawa pang bagay sa body na dapat aksyunan. Ang dry_run ay true kapag galing ang request sa Try it, kaya laktawan ang anumang hindi na mababawi, gaya ng paggawa ng order. Ang run_id naman ay natatangi sa bawat run, kaya itago ang mga nahawakan na ninyo at tanggihan ang na-replay na request. Sumagot sa loob ng 20 segundo; ang {"reply": "..."} ay ipinapadala sa customer nang eksakto kung paano ito isinulat, kaya huwag kailanman ipasa ang text ng customer nang hindi sinusuri.

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

Paano gumagana ang forward secrets at paano ang pag-rotate nito?

Ang numerong nakatakda sa Through easyCoexistence ay puwedeng i-forward ang mga papasok na mensahe sa sarili ninyong system. Ang unang beses na mag-save kayo ng Forward URL, may gagawing secret na ipinapakita nang isang beses lang, sa ilalim ng "Your signing secret, shown once. Copy it now:"; pinipirmahan nito ang bawat forwarded POST gamit ang parehong X-EC-Signature scheme. Ang bagong secret sa page ng numero, o ang set_inbound_mode na may rotate_secret na true, ay gagawa ng kapalit, na muling ipinapakita nang isang beses, at mula noon, lahat ng ipinapadala nito ay pinipirmahan, kasama ang mga retry ng mas lumang delivery. Maaari rin kayong mag-type ng sarili ninyong secret, hindi bababa sa 24 na character, na ise-save at hindi na muling ipapakita. Ang pag-stop ng forwarding ay nagbubura ng secret, kaya ang pag-save ng URL pagkatapos ay magsisimula sa bagong secret.

I-rotate kapag may teammate na may access ang umalis, kapag may secret na napunta sa repository, ticket o log, at kapag binago ninyo ang hosting. Ang secret ng Call my webhook ay pag-aari ng automation at ang may-ari lang ng account ang nakakakita nito. Kapag may New secret sa editor, sa ilalim ng trigger na "Your system calls a URL", pinapalitan ito ng button na iyon at agad humihinto sa paggana ang luma; sa automation na walang button na iyon, gumawa ulit ng automation, ituro ang receiver ninyo sa bagong secret, at saka burahin ang lumang automation.

Aling mga address ang puwedeng tawagan ng automations?

Mga public HTTPS address lang. Ang Call my webhook URL o Forward URL na nagsisimula sa http://, tumuturo sa localhost, sa private network range, sa .internal o .local na pangalan, o sa cloud metadata address ay tinatanggihan kapag sine-save, at chine-check ulit pagkatapos ng DNS bago ang bawat request, para hindi maituro ng public na pangalan sa loob ng private network. Hindi sinusundan ang redirects: ang 301 o 302 ay nagfa-fail sa hakbang, kaya i-save ang huling address.

Huwag ilagay ang secrets sa mismong URL. Ibinabalik ng list_automations ang mga hakbang ng bawat automation, kasama ang webhook URL, sa alinmang assistant na nakakonekta sa account ninyo, kaya nababasa roon ang token sa query string. Hayaan ang signature ang magdala ng patunay.

Paano panatilihing pinakamaliit ang access?

Bigyan ang bawat tao at bawat tool lang ng access na kailangan ng trabaho nila, at alisin ang hindi na ginagamit. Ang connector side, kasama ang sign-in, mga kumpirmasyon, at mga naka-block na tool, ay tinatalakay sa pahina tungkol sa ligtas na pagkonekta ng WhatsApp sa AI; sa panig ng automation, ang mga gawaing ito ang pinakamahalaga:

  • Humingi ng get_api_credentials lang sa pribadong chat: ang access token ng numero ay mananatili sa transcript na iyon.
  • Mas piliin ang Call my webhook o Forward URL kaysa ibigay ang token sa third-party tool.
  • Burahin ang mga automation na inalis na ninyo; mabubura rin nito ang kanilang signing secrets.
  • Tandaan na ang run logs ay naglalaman ng mga mensahe at sagot ng customer sa loob ng 30 araw, at pinapanatili ng Conversations ang mga chat sa retention period ninyo (30, 90 o 365 araw), na parehong nababasa sa dashboard at sa pamamagitan ng nakakonektang assistant ninyo.
  • Sa numerong nakatakda sa Straight to your system, maglagay ng mahaba at random na secret sa path ng callback URL, dahil hindi ito mache-check ng signature ng Meta doon.

Mga karaniwang pagkakamali

  • Pag-verify ng signature sa JSON na muling in-serialize ng framework ninyo. Maraming parser ang nagbabago ng spacing, escaping o key order; i-compute ang HMAC sa raw request bytes kung saan ito nakikita ng stack ninyo.
  • Pagpapatakbo ng side effects sa test calls. Ang Try it ay tumatawag sa webhook ninyo na may dry_run na true; ang order, refund o CRM write na magagawa roon ay totoo.
  • Pag-paste ng AI key sa chat ng assistant para makatipid ng oras. Walang tool na tumatanggap nito, at nananatili ito sa transcript; gamitin ang AI keys sa dashboard.
  • Pag-check ng forward gamit ang Call my webhook secret, o kabaligtaran. Magkakahiwalay silang secret: isa kada numero para sa forwards, isa kada automation para sa webhook calls.
Ginagawa ito gamit ang EasyCoexistence

Nananatili ang numero ninyo sa opisyal na Cloud API ng Meta sa pamamagitan ng Coexistence, na mino-monitor 24/7. Mula US$ 9 hanggang US$ 0.75 kada numero kada buwan, bumababa habang dumarami ang numero, na may free trial sa unang 3 araw.

Mga madalas itanong

Puwede bang makita ng staff o assistant ng suporta ng easyCoexistence ang AI key ko?

Hindi na ipinapakita ang key pagkatapos ninyo itong i-save, hindi sa dashboard, hindi sa resulta ng MCP, at hindi sa mga impormasyong binabasa ng assistant ng suporta. Dine-decrypt lang ito ng sistema, sa sandaling tinatawagan nito ang provider ninyo para sa AI reply.

Sino ang puwedeng magbasa ng run logs ng automation ko?

Sinumang naka-sign in sa easyCoexistence account ninyo, kasama ang mga taong inimbitahan ninyo rito, sa tab na Runs, at ang alinmang assistant na nakakonekta sa account, sa pamamagitan ng list_automation_runs at get_automation_run. Kasama sa logs ang mensahe ng customer at ang sagot, at nabubura ang mga ito pagkatapos ng 30 araw.

Paano ko aalisin nang ligtas ang AI key?

I-Switch Off muna ang mga automation na gumagamit nito, at ang anumang agent na tumatakbo rito, saka piliin ang Remove sa ilalim ng AI keys, at i-revoke ang key sa provider. Ang pag-alis dito habang gamit pa ng mga automation ay magpapa-pause sa kanila sa susunod nilang AI reply at magpapadala ng email sa inyo.

Nagpapadala ba ng customer data sa webhook ko ang Try it?

Ang sample text lang na inilagay ninyo ang ipinapadala, na may dry_run na true at walang laman na history. Ang totoong run ay nagpapadala ng papasok na mensahe at hanggang 10 pinakabagong mensahe ng chat, kaya ituring ang endpoint ninyo bilang humahawak ng customer data.

Magpatuloy sa pagbabasa

Handa na po ba kayong magsimula?

I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.

Magsimula ng Libreng Trial

Na-verify noong