API WhatsApp untuk agen AI: akses resmi dalam hitungan menit, tanpa menjadi Tech Provider
Agen AI mendapat akses WhatsApp resmi melalui Cloud API Meta, dan nomor yang tetap berada di aplikasi WhatsApp Business bergabung melalui Tech Provider atau Solution Partner. Anda bisa menjadi salah satunya, dengan verifikasi bisnis, video App Review, dan implementasi Embedded Signup, atau terhubung lewat penyedia yang sudah berstatus demikian: nomor bergabung dalam hitungan menit dan agen mendapatkan tool MCP atau kredensial API.
easyCoexistence adalah Meta Tech Provider independen: ia menghubungkan nomor WhatsApp Business ke Cloud API melalui Coexistence dalam hitungan menit, sehingga agen Anda mendapat akses resmi sementara bisnis tetap memakai aplikasi.
Yang disyaratkan Meta dari pihak yang melakukan onboarding nomor yang tetap di aplikasi WhatsApp Business: status Tech Provider atau Solution Partner.
App Review meminta satu video pesan yang dikirim dari aplikasi Anda, dan satu video aplikasi Anda membuat template.
Yang diberikan App Review untuk whatsapp_business_messaging dan whatsapp_business_management, keduanya wajib untuk menjadi Tech Provider.
Ketika Meta menghentikan Embedded Signup v2 dan v3, integrasi diminta pindah ke v4.
Throughput tetap sebuah nomor yang digunakan bersama aplikasi WhatsApp Business dan Cloud API.
Berapa lama tautan koneksi hosted tetap berlaku ketika platform melakukan onboarding nomor pelanggan melalui Partner API.
Apa yang dibutuhkan agen AI untuk menggunakan WhatsApp secara resmi?
Empat hal dari Cloud API Meta. Pertama, phone number ID dan access token dengan izin whatsapp_business_messaging, agar agen dapat memanggil endpoint messages. Kedua, endpoint webhook tempat Meta mengirimkan pesan masuk, ditambah, pada nomor yang dipakai bersama aplikasi, smb_message_echoes untuk balasan yang diketik seseorang di telepon. Ketiga, template yang sudah disetujui, karena pesan yang diketik hanya sampai kepada orang yang menulis dalam 24 jam terakhir. Keempat, cara untuk tahu kapan koneksi terputus, sebab aplikasi di telepon tetap berfungsi ketika sisi API berhenti.
Jalan pintas yang paling dulu ditemukan orang adalah otomatisasi WhatsApp Web, yang masuk sebagai perangkat tertaut. Cara itu melanggar ketentuan WhatsApp dan membuat nomor berisiko diblokir, apa pun yang dilakukan agen di atasnya.
Apa saja yang tercakup dalam rute Tech Provider?
Urutan resmi dari Meta, dalam urutan ini. Setiap langkah gratis, dan tidak ada yang bisa dipercepat dengan membayar: peninjauan berjalan sesuai jadwal Meta dan Meta tidak mempublikasikan lini masa, jadi rencanakan beberapa minggu, bukan beberapa hari, sebelum nomor pelanggan pertama terhubung. Setelah itu backend harus terus berjalan: pertukaran token setelah setiap pendaftaran, penerima webhook, perutean per nomor, dan pemantauan pemutusan koneksi seperti aturan ketidakaktifan 14 hari dari Meta.
Apa jalur yang lebih singkat?
Hubungkan nomor melalui penyedia yang sudah melewati proses itu. Dengan easyCoexistence, bisnis menjalankan Embedded Signup milik Meta dan memindai kode dengan aplikasi WhatsApp Business, yang memakan waktu sekitar dua menit, dan nomor bergabung dengan Cloud API di Business Portfolio milik bisnis itu sendiri sementara aplikasi tetap berfungsi. Agen kemudian mendapatkan akses dalam bentuk yang dipahaminya: tool MCP untuk asisten seperti ChatGPT, Claude, Claude Code, atau Codex, atau kredensial dan webhook nomor untuk kode yang Anda jalankan.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Bagaimana agen mendapatkan kredensial nomor?
Melalui get_api_credentials, atau dari halaman nomor di dashboard. Tool ini mengembalikan base URL Graph API, WhatsApp Business Account ID, phone number ID, endpoint pengiriman, dan, jika ada, access token milik bisnis itu sendiri, yang terbatas pada aset WhatsApp-nya. Ketika tidak ada client token yang diterbitkan, token dikembalikan sebagai null dengan catatan bahwa menghubungkan ulang nomor dari dashboard akan menerbitkannya, tanpa menggantikan token yang masih berfungsi. Tidak ada app secret untuk diambil, karena Meta menandatangani webhook dengan app secret easyCoexistence, yang tidak pernah dibagikan. Tool ini memerlukan paket aktif, karena token tersebut dapat mengirim pesan.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'Bagaimana pesan masuk sampai ke agen?
Setiap nomor memiliki dua mode, yang diganti dengan set_inbound_mode atau di halaman nomor. Langsung ke server Anda: set_webhook_destination mengarahkan Meta langsung ke endpoint HTTPS Anda, yang harus menjawab handshake GET dari Meta, dan easyCoexistence tidak pernah melihat pesannya, sehingga otomatisasi nonaktif. Karena Meta menandatangani pengiriman itu dengan app secret kami, letakkan secret acak yang panjang di path URL dan tolak permintaan yang tidak menyertakannya.
Otomatisasi aktif: Meta mengirim ke easyCoexistence, otomatisasi dapat membalas, dan Forward URL opsional menerima payload asli Meta di bawah "value", ditandatangani dengan X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 dari "<t>.<body>"> menggunakan secret yang ditampilkan sekali. Langkah Call my webhook dari otomatisasi juga memberikan pesan dan 10 pesan terakhir dari chat itu kepada agen Anda, dan mengirim balasannya ketika jawaban Anda berupa {"reply": "..."} dalam 20 detik.
Batasan apa yang harus dipatuhi agen?
Batasan dari Meta, dan batasan itu sama melalui penyedia mana pun. Agen yang mengetahuinya sejak awal terhindar dari kegagalan yang tampak seperti bug:
- 20 pesan per detik per nomor, ditetapkan oleh Meta untuk nomor yang dipakai bersama aplikasi WhatsApp Business.
- Pesan yang diketik hanya boleh dikirim dalam 24 jam sejak pesan terakhir pelanggan; setelah itu, gunakan template yang disetujui.
- Template hanya dikirim melalui API, karena aplikasi pada nomor Coexistence tidak dapat mengirimkannya.
- Balasan yang diketik seseorang di aplikasi tiba sebagai
smb_message_echoes; hentikan agen pada chat itu, atau pelanggan menerima dua jawaban. - Grup chat tidak disinkronkan ke API, sehingga agen bekerja di chat satu-ke-satu.
- Kontak dan hingga 6 bulan chat satu-ke-satu diimpor sekali, hanya jika tujuan webhook langsung disimpan dalam 24 jam setelah terhubung; nomor dengan otomatisasi aktif tidak mendapatkan impor.
- Panggilan suara dan video tetap berfungsi di aplikasi, tetapi Cloud API tidak mendukung panggilan pada nomor Coexistence, sehingga agen bekerja melalui teks.
Bisakah platform menghubungkan nomor pelanggannya sendiri dengan cara ini?
Bisa, melalui Partner API, yang menjadi cara SaaS atau agensi melakukan onboarding pelanggannya tanpa status Tech Provider sendiri. Buat kunci dengan create_api_key (diawali ec_live_ dan ditampilkan sekali), lalu panggil POST /api/v1/connect-sessions dari backend Anda, atau create_connect_link dari asisten, untuk tautan hosted yang berlaku 1 jam. Pelanggan menjalankan popup Meta dan pemindaian QR di sana, lalu kembali ke redirect_url Anda dengan connection_id. GET /api/v1/connections/:id?credentials=1 kemudian mengembalikan token milik pelanggan, dan event status seperti connection.disconnected dikirim dengan tanda tangan X-EC-Signature. Setiap nomor ditagihkan ke akun Anda dengan tingkat per nomor yang sama.
Kesalahan umum
- Memvalidasi X-Hub-Signature-256 pada tujuan langsung. Meta menandatangani dengan app secret easyCoexistence, yang tidak pernah dibagikan, sehingga pengiriman asli gagal pemeriksaan; percayai secret acak yang panjang di URL, atau gunakan forwarding dengan X-EC-Signature.
- Menerima pesan dengan node WhatsApp Trigger milik n8n. Node itu mengharapkan aplikasi Meta Anda sendiri; gunakan node Webhook generik dengan secret di URL-nya.
- Mengabaikan smb_message_echoes. Agen kemudian menjawab di atas seseorang yang sudah membalas dari telepon, dan pelanggan membaca dua jawaban.
- Menyimpan tujuan webhook langsung beberapa hari setelah menghubungkan, atau membiarkan nomor di otomatisasi. Impor sekali dari Meta atas kontak dan hingga 6 bulan chat membutuhkan tujuan langsung yang disimpan dalam 24 jam setelah koneksi.
Agen bekerja melalui lebih dari 30 tool MCP atau melalui kredensial dan webhook setiap nomor, dan setiap nomor dipantau 24/7 dengan peringatan. US$ 9 turun hingga US$ 0.75 per nomor per bulan, makin murah seiring Anda menambah nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya memerlukan aplikasi Meta sendiri?
Tidak. Nomor di-onboard melalui aplikasi Meta milik easyCoexistence dan tetap berada di Business Portfolio dan WhatsApp Business Account milik bisnis. Kode Anda mengirim pesan dengan token milik bisnis dari get_api_credentials, jadi tidak ada aplikasi milik Anda yang terlibat kecuali nanti Anda membangunnya.
Bisakah agen dan tim menggunakan nomor secara bersamaan?
Bisa. Meta mencerminkan pesan antara Cloud API dan aplikasi WhatsApp Business, sehingga yang dikirim agen muncul di utas chat aplikasi di telepon, dan yang diketik tim di aplikasi sampai ke sistem Anda sebagai smb_message_echoes.
Framework agen AI apa saja yang bisa dipakai?
Klien apa pun yang mendukung MCP melalui HTTP dengan OAuth, seperti ChatGPT, Claude, Claude Code, Codex, dan Cursor, serta kode apa pun yang memanggil Graph API Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK, atau Vercel AI SDK. API di bawahnya adalah milik Meta sendiri, jadi tidak ada komponen eksklusif di dalam agen.
Apakah asisten AI serbaguna diizinkan di WhatsApp?
Business Solution Terms Meta, bagian 4.7, melarang penyedia asisten AI serbaguna menawarkannya di WhatsApp Business Platform ketika AI menjadi fungsi utama, sebagaimana ditentukan Meta, berlaku sejak 15 Januari 2026. Bisnis yang memakai AI untuk pelanggannya sendiri, untuk dukungan, penjualan, atau pemesanan, bukan sasaran aturan itu, dan regulator di Uni Eropa dan Brasil telah memerintahkan Meta untuk menangguhkan atau membatalkan aturan itu bagi asisten pesaing.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada