MasukMulai uji coba gratis
Meta Tech Provider

Amankan otomasi WhatsApp Anda: kunci, webhook, dan tanda tangan

Amankan otomasi WhatsApp di empat titik: kunci AI, yang disimpan terenkripsi dan hanya dipakai untuk balasan AI; webhook yang dipanggil otomasi, yang sebaiknya memeriksa tanda tangan HMAC sebelum mempercayai permintaan; penerusan pesan masuk, yang ditandatangani dengan rahasia yang bisa dirotasi; serta orang dan asisten yang punya akses, dibatasi hanya pada yang mereka perlukan.

easyCoexistence menyimpan kunci AI Anda terenkripsi dan tidak pernah menampilkannya lagi, menandatangani setiap permintaan Call my webhook dan setiap pesan yang diteruskan dengan X-EC-Signature menggunakan rahasia yang hanya Anda pegang, dan menolak alamat webhook yang bukan HTTPS publik.

AES-256-GCM

Enkripsi saat disimpan berlaku untuk kunci AI tersimpan, rahasia penandatanganan, dan token akses Meta milik nomor.

Last 4

Yang terlihat dari kunci AI tersimpan: "ending in" dengan empat karakter terakhirnya.

192 bits

Keacakan pada setiap rahasia penandatanganan: whsec_ diikuti 24 byte acak, satu untuk setiap otomasi dan satu untuk setiap nomor yang meneruskan pesan.

HTTPS only

URL Webhook dan URL Forward harus HTTPS publik; alamat privat dan internal ditolak saat disimpan dan sebelum setiap pengiriman.

5 minutes

Batas usia yang disarankan untuk nilai t pada tanda tangan, untuk menolak permintaan yang diputar ulang.

Apa saja yang perlu dilindungi dalam pengaturan otomasi WhatsApp?

Lima kredensial, masing-masing punya tempatnya sendiri dan cara memperbaikinya sendiri jika bocor. Dua di antaranya milik otomasi itu sendiri, yaitu kunci AI dan rahasia penandatanganan Call my webhook; rahasia penerusan milik nomor; token akses dan login asisten Anda milik akun. Dengan mengetahui mana yang mana, Anda tahu apa yang harus dirotasi saat ada 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 dipakai?

Hanya dari dashboard: tombol AI keys di halaman Automations, lalu Test and save. Kunci pertama-tama diperiksa ke endpoint gratis milik penyedia, yang tidak memakai token, dan kunci yang ditolak penyedia dibuang tanpa disimpan. Kunci yang berfungsi dienkripsi saat disimpan dengan AES-256-GCM, didekripsi hanya untuk memanggil penyedia tersebut bagi langkah AI dan agen Anda, serta untuk menuliskan pesan suara pada kunci OpenAI atau OpenRouter, dan setelahnya hanya ditampilkan sebagai "ending in 1234". Tidak ada tool MCP yang menerima atau mengembalikan kunci, sehingga kunci tidak pernah melewati obrolan dengan asisten Anda.

Satu akun memiliki satu kunci per penyedia, dan menyimpan kunci baru akan menggantikan yang lama. Buat kunci khusus untuk otomasi di penyedia, dengan batas pengeluaran jika penyedia menyediakannya, agar bisa dicabut tanpa merusak aplikasi Anda yang lain. Jika penyedia menolaknya, otomasi yang memakainya berstatus Paused dan Anda menerima satu email; menyimpan kunci yang berfungsi akan menjalankan kembali otomasi tersebut dengan sendirinya.

Bagaimana memastikan permintaan Call my webhook itu asli?

Periksa tanda tangan sebelum membaca hal lain. Setiap permintaan membawa X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 dari "<t>.<raw body>">, dengan kunci Signing secret milik otomasi tersebut, yang Anda salin dari langkah di editor setelah menyimpan. Hitung ulang HMAC atas byte mentah, bandingkan dengan waktu konstan, dan tolak t yang selisihnya lebih dari 5 menit dari jam Anda. Isi body juga memberi dua hal yang layak ditindaklanjuti. dry_run bernilai true saat permintaan berasal dari Try it, jadi lewati apa pun yang tidak bisa dibatalkan, seperti membuat pesanan. Dan run_id unik untuk setiap run, jadi simpan yang sudah Anda proses dan tolak permintaan yang diputar ulang. Jawab dalam 20 detik; {"reply": "..."} dikirim ke pelanggan persis seperti tertulis, jadi jangan pernah meneruskan teks pelanggan tanpa diperiksa.

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 rahasia penerusan bekerja, dan bagaimana cara merotasinya?

Nomor yang diatur ke Through easyCoexistence dapat meneruskan pesan masuknya ke sistem Anda sendiri. Saat pertama kali Anda menyimpan URL Forward, sebuah rahasia dibuat dan ditampilkan sekali, di bawah "Your signing secret, shown once. Copy it now:"; rahasia itu menandatangani setiap POST yang diteruskan dengan skema X-EC-Signature yang sama. Tombol New secret di halaman nomor, atau set_inbound_mode dengan rotate_secret bernilai true, membuat rahasia pengganti, yang juga ditampilkan sekali, dan sejak itu menandatangani semuanya, termasuk pengiriman ulang untuk kiriman lama. Anda juga dapat mengetik rahasia sendiri, minimal 24 karakter, yang disimpan dan tidak pernah ditampilkan lagi. Stop forwarding menghapus rahasia, sehingga menyimpan URL di lain waktu dimulai dengan rahasia baru.

Rotasi dilakukan setelah anggota tim yang punya akses keluar, setelah rahasia masuk ke repositori, tiket, atau log, dan saat Anda mengganti hosting. Rahasia Call my webhook milik otomasi dan hanya pemilik akun yang melihatnya. Di tempat editor menampilkan New secret, di bawah pemicu "Your system calls a URL", tombol itu menggantinya dan yang lama langsung berhenti berfungsi; pada otomasi tanpa tombol itu, buat ulang otomasi, arahkan penerima Anda ke rahasia baru, lalu hapus otomasi lama.

Alamat mana saja yang boleh dipanggil otomasi?

Hanya alamat HTTPS publik. URL Call my webhook atau URL Forward yang diawali http://, mengarah ke localhost, rentang jaringan privat, nama .internal atau .local, atau alamat metadata cloud akan ditolak saat disimpan, dan diperiksa lagi setelah DNS sebelum setiap permintaan, sehingga nama publik tidak bisa diarahkan belakangan ke dalam jaringan privat. Redirect tidak diikuti: 301 atau 302 membuat langkah gagal, jadi simpan alamat akhirnya.

Jangan letakkan rahasia di dalam URL itu sendiri. list_automations mengembalikan langkah tiap otomasi, termasuk URL webhook, kepada asisten mana pun yang terhubung ke akun Anda, sehingga token di query string bisa terbaca di sana. Biarkan tanda tangan yang menjadi buktinya.

Bagaimana menjaga akses seminimal mungkin?

Berikan setiap orang dan setiap tool hanya akses yang dibutuhkan pekerjaannya, dan cabut akses yang sudah tidak dipakai. Sisi konektor, dengan login, konfirmasi, dan tool yang diblokir, dibahas di halaman tentang menghubungkan WhatsApp ke AI dengan aman; di sisi otomasi, kebiasaan berikut paling penting:

  • Minta get_api_credentials hanya di obrolan pribadi, karena token akses nomor tersebut kemudian tersimpan di transkrip itu.
  • Utamakan Call my webhook atau URL Forward daripada menyerahkan token ke tool pihak ketiga.
  • Hapus otomasi yang sudah tidak dipakai; itu juga mencabut rahasia penandatanganannya.
  • Ingat bahwa log run menyimpan pesan dan balasan pelanggan selama 30 hari, dan Conversations menyimpan chat selama periode retensi Anda (30, 90, atau 365 hari), keduanya bisa dibaca di dashboard dan melalui asisten yang terhubung.
  • Pada nomor yang diatur ke Straight to your system, letakkan rahasia acak yang panjang di path URL callback, karena tanda tangan Meta tidak bisa diperiksa di sana.

Kesalahan umum

  • Memverifikasi tanda tangan atas JSON yang sudah diserialisasi ulang oleh framework Anda. Banyak parser mengubah spasi, escaping, atau urutan kunci; hitung HMAC atas byte mentah permintaan di mana pun stack Anda menyediakannya.
  • Menjalankan efek samping pada panggilan uji. Try it memanggil webhook Anda dengan dry_run bernilai true; pesanan, refund, atau penulisan ke CRM yang dibuat saat itu tetap nyata.
  • Menempelkan kunci AI ke obrolan dengan asisten demi menghemat waktu. Tidak ada tool yang menerimanya, dan kunci itu tetap tersimpan di transkrip; gunakan AI keys di dashboard.
  • Memeriksa pesan yang diteruskan dengan rahasia Call my webhook, atau sebaliknya. Keduanya rahasia terpisah: satu per nomor untuk penerusan, satu per otomasi untuk panggilan webhook.
Melakukan ini dengan EasyCoexistence

Nomor Anda tetap berada di Cloud API resmi Meta melalui Coexistence, dipantau 24/7. US$ 9 turun hingga US$ 0.75 per nomor per bulan, makin turun saat Anda menambah nomor, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah staf atau dukungan easyCoexistence bisa melihat kunci AI saya?

Kunci tidak pernah ditampilkan setelah Anda menyimpannya, tidak di dashboard, tidak di hasil MCP, dan tidak di fakta yang dibaca asisten dukungan. Kunci hanya didekripsi oleh sistem, pada saat sistem memanggil penyedia Anda untuk balasan AI.

Siapa yang bisa membaca log run otomasi saya?

Siapa pun yang sudah masuk ke akun easyCoexistence Anda, termasuk orang yang Anda undang, di tab Runs, dan asisten mana pun yang terhubung ke akun, melalui list_automation_runs dan get_automation_run. Log memuat pesan pelanggan dan balasannya, dan dihapus setelah 30 hari.

Bagaimana cara menghapus kunci AI dengan aman?

Matikan dulu otomasi yang memakainya (Switch Off), dan agen apa pun yang berjalan dengannya, lalu pilih Remove di bawah AI keys dan cabut kunci di penyedia. Jika dihapus saat otomasi masih memakainya, otomasi itu dijeda pada balasan AI berikutnya dan Anda menerima email.

Apakah Try it mengirim data pelanggan ke webhook saya?

Hanya teks contoh yang Anda ketik, dengan dry_run bernilai true dan riwayat kosong. Run sungguhan mengirim pesan masuk dan pesan terbaru dalam obrolan itu, hingga 10, jadi perlakukan endpoint Anda sebagai penangan data pelanggan.

Lanjut membaca

Siap memulai?

Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.

Mulai uji coba gratis

Diverifikasi pada