Log masukMulakan percubaan percuma
Meta Tech Provider

Lindungi automasi WhatsApp anda: kunci, webhook dan tandatangan

Lindungi automasi WhatsApp pada empat titik: kunci AI, yang disimpan secara disulitkan dan hanya digunakan untuk balasan AI; webhook yang dipanggil oleh automasi, yang wajib menyemak tandatangan HMAC sebelum mempercayai sesuatu permintaan; penghantaran mesej masuk, yang ditandatangani dengan rahsia yang boleh ditukar; dan orang serta pembantu yang mempunyai akses, yang dihadkan kepada apa yang diperlukan sahaja.

easyCoexistence menyimpan kunci AI anda secara disulitkan dan tidak memaparkannya lagi, menandatangani setiap permintaan Call my webhook dan setiap mesej yang dihantar dengan X-EC-Signature menggunakan rahsia yang hanya anda pegang, dan menolak alamat webhook yang bukan HTTPS awam.

AES-256-GCM

Penyulitan digunakan semasa penyimpanan untuk kunci AI yang disimpan, rahsia tandatangan dan token akses Meta bagi nombor tersebut.

Last 4

Semua yang anda lihat semula bagi kunci AI yang disimpan ialah "berakhir dengan" empat aksara terakhirnya.

192 bits

Nilai rawak dalam setiap rahsia tandatangan: whsec_ diikuti 24 bait rawak, satu bagi setiap automasi dan satu bagi setiap nombor penghantaran.

HTTPS only

URL Webhook dan URL Penghantaran mesti HTTPS awam; alamat peribadi dan dalaman ditolak semasa disimpan dan sebelum setiap penghantaran.

5 minutes

Had umur yang dicadangkan bagi nilai t tandatangan, untuk menolak permintaan yang diulang semula.

Apakah yang perlu dilindungi dalam persediaan automasi WhatsApp?

Lima bukti kelayakan, setiap satu dengan tempatnya sendiri dan pembetulannya sendiri jika bocor. Dua daripadanya milik automasi itu sendiri, iaitu kunci AI dan rahsia tandatangan webhook Call my webhook; rahsia penghantaran milik nombor; token akses dan log masuk pembantu anda milik akaun. Mengetahui yang mana satu ialah akan memberitahu anda apa yang perlu ditukar apabila berlaku masalah.

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.

Bagaimana kunci AI disimpan dan digunakan?

Hanya dari papan pemuka: butang AI keys pada halaman Automations, kemudian Test and save. Kunci itu disemak dahulu melalui endpoint percuma pembekal, yang tidak menggunakan token, dan kunci yang ditolak pembekal dibuang tanpa disimpan. Kunci yang berfungsi disulitkan semasa disimpan dengan AES-256-GCM, dinyahsulitkan hanya untuk memanggil pembekal itu bagi langkah AI dan agen anda, serta untuk menyalin mesej suara menjadi teks pada kunci OpenAI atau OpenRouter, dan selepas itu hanya dipaparkan sebagai "ending in 1234". Tiada alat MCP menerima atau memulangkan kunci, jadi kunci tidak pernah melalui sembang dengan pembantu anda.

Setiap akaun mempunyai satu kunci bagi setiap pembekal, dan menyimpan kunci baharu akan menggantikan yang lama. Cipta kunci khusus untuk automasi di pembekal, dengan had perbelanjaan jika pembekal menawarkannya, supaya ia boleh dibatalkan tanpa memutuskan aplikasi lain anda. Jika pembekal menolaknya, automasi yang menggunakannya akan menunjukkan Paused dan anda menerima satu e-mel; menyimpan kunci yang berfungsi akan memulakannya semula secara automatik.

Bagaimana anda mengesahkan bahawa permintaan Call my webhook itu tulen?

Semak tandatangan sebelum membaca apa-apa lagi. Setiap permintaan membawa X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, dikunci dengan Signing secret automasi itu, yang anda salin daripada langkah dalam editor selepas menyimpan. Kira semula HMAC ke atas bait mentah, bandingkan dalam masa tetap, dan tolak t yang lebih daripada 5 minit dari jam anda. Badan permintaan juga memberitahu dua perkara yang wajar diambil tindakan. dry_run ialah true apabila permintaan datang daripada Try it, jadi langkau apa-apa yang tidak boleh dibatalkan, seperti mencipta pesanan. run_id pula unik bagi setiap larian, jadi simpan yang telah anda kendalikan dan tolak permintaan yang diulang semula. Jawab dalam masa 20 saat; {"reply": "..."} dihantar kepada pelanggan seperti yang tertulis, jadi jangan sekali-kali hantar teks pelanggan tanpa semakan.

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

Bagaimana rahsia penghantaran berfungsi, dan bagaimana anda menukarnya?

Nombor yang ditetapkan kepada Through easyCoexistence boleh menghantar mesej masuknya ke sistem anda sendiri. Kali pertama anda menyimpan URL Penghantaran, satu rahsia dijana dan dipaparkan sekali, di bawah "Your signing secret, shown once. Copy it now:"; ia menandatangani setiap POST yang dihantar dengan skema X-EC-Signature yang sama. Rahsia baharu pada halaman nombor, atau set_inbound_mode dengan rotate_secret ditetapkan kepada true, menjana gantian, sekali lagi dipaparkan sekali, dan sejak itu menandatangani semua penghantaran, termasuk percubaan semula penghantaran lama. Anda juga boleh menaip rahsia sendiri, sekurang-kurangnya 24 aksara, yang disimpan dan tidak dipaparkan lagi. Berhenti menghantar memadamkan rahsia, jadi menyimpan URL kemudian akan bermula dengan rahsia baharu.

Tukar rahsia selepas ahli pasukan yang mempunyai akses keluar, selepas rahsia terdedah dalam repositori, tiket atau log, dan apabila anda menukar pengehosan. Rahsia Call my webhook milik automasi dan hanya pemilik akaun yang dapat melihatnya. Jika editor menunjukkan Rahsia baharu, di bawah pencetus "Your system calls a URL", butang itu menggantikannya dan yang lama berhenti berfungsi serta-merta; pada automasi tanpa butang itu, cipta semula automasi, arahkan penerima anda ke rahsia baharu, kemudian padam automasi lama.

Alamat manakah yang boleh dipanggil oleh automasi?

Hanya alamat HTTPS awam. Call my webhook URL atau URL Penghantaran yang bermula dengan http://, menunjuk ke localhost, julat rangkaian peribadi, nama .internal atau .local, atau alamat metadata awan, ditolak semasa anda menyimpannya, dan diperiksa semula selepas DNS sebelum setiap permintaan, supaya nama awam tidak boleh kemudian diarahkan ke dalam rangkaian peribadi. Ubah hala tidak diikuti: 301 atau 302 menggagalkan langkah, jadi simpan alamat akhir.

Jangan letakkan rahsia dalam URL itu sendiri. list_automations memulangkan langkah setiap automasi, termasuk URL webhook, kepada mana-mana pembantu yang bersambung dengan akaun anda, jadi token dalam query string boleh dibaca di situ. Biarkan tandatangan membawa bukti.

Bagaimana anda mengekalkan akses pada tahap minimum?

Beri setiap orang dan setiap alat hanya akses yang diperlukan tugasnya, dan buang apa yang tidak lagi digunakan. Bahagian penyambung, dengan log masuk, pengesahan dan alat yang disekat, dilindungi dalam halaman tentang menyambungkan WhatsApp kepada AI dengan selamat; di bahagian automasi, tabiat ini paling penting:

  • Minta get_api_credentials hanya dalam sembang persendirian: token akses nombor itu kemudian tersimpan dalam transkrip tersebut.
  • Utamakan Call my webhook atau URL Penghantaran berbanding menyerahkan token kepada alat pihak ketiga.
  • Padam automasi yang telah dihentikan; itu turut membatalkan rahsia tandatangannya.
  • Ingat bahawa log larian menyimpan mesej dan balasan pelanggan selama 30 hari, dan Conversations menyimpan sembang selama tempoh pengekalan anda (30, 90 atau 365 hari), kedua-duanya boleh dibaca dalam papan pemuka serta melalui pembantu yang bersambung.
  • Pada nombor yang ditetapkan kepada Straight to your system, letakkan rahsia rawak yang panjang dalam laluan URL callback, kerana tandatangan Meta tidak boleh disemak di situ.

Kesilapan biasa

  • Mengesahkan tandatangan ke atas JSON yang telah disusun semula oleh rangka kerja anda. Banyak pengurai mengubah jarak, escape atau susunan kunci; kira HMAC ke atas bait permintaan mentah di mana sahaja tindanan anda mendedahkannya.
  • Menjalankan kesan sampingan pada panggilan ujian. Try it memanggil webhook anda dengan dry_run ditetapkan kepada true; pesanan, bayaran balik atau tulisan CRM yang dibuat ketika itu adalah benar.
  • Menampal kunci AI ke dalam sembang dengan pembantu anda untuk menjimatkan masa. Tiada alat menerimanya, dan ia kekal dalam transkrip; gunakan kunci AI dalam papan pemuka.
  • Menyemak penghantaran dengan rahsia Call my webhook, atau sebaliknya. Ia rahsia yang berasingan: satu bagi setiap nombor untuk penghantaran, dan satu bagi setiap automasi untuk panggilan webhook.
Menggunakan EasyCoexistence untuk ini

Nombor anda kekal pada Cloud API rasmi Meta melalui Coexistence, dipantau 24/7. US$ 9 turun ke US$ 0.75 setiap nombor sebulan, berkurang apabila anda menambah nombor, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah kakitangan atau sokongan easyCoexistence melihat kunci AI saya?

Kunci tidak pernah dipaparkan selepas anda menyimpannya, tidak dalam papan pemuka, tidak dalam hasil MCP dan tidak dalam fakta yang dibaca oleh pembantu sokongan. Ia hanya dinyahsulitkan oleh sistem, pada saat ia memanggil pembekal anda untuk balasan AI.

Siapa yang boleh membaca log larian automasi saya?

Sesiapa sahaja yang log masuk ke akaun easyCoexistence anda, termasuk orang yang anda jemput ke akaun itu, dalam tab Runs, dan mana-mana pembantu yang bersambung dengan akaun itu, melalui list_automation_runs dan get_automation_run. Log merangkumi mesej dan balasan pelanggan, dan dipadam selepas 30 hari.

Bagaimana saya mengeluarkan kunci AI dengan selamat?

Matikan dahulu automasi yang menggunakannya dengan Switch Off, dan mana-mana ejen yang berjalan padanya, kemudian pilih Remove di bawah AI keys dan batalkan kunci di pembekal. Mengeluarkannya ketika automasi masih menggunakannya akan menghentikan automasi itu pada balasan AI seterusnya dan menghantar e-mel kepada anda.

Adakah Try it menghantar data pelanggan ke webhook saya?

Ia hanya menghantar teks contoh yang anda taip, dengan dry_run ditetapkan kepada true dan sejarah kosong. Larian sebenar menghantar mesej masuk dan sehingga 10 mesej terkini sembang, jadi layan endpoint anda seperti mengendalikan data pelanggan.

Teruskan membaca

Sedia untuk bermula?

Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.

Mulakan Percubaan Percuma

Disahkan pada