API WhatsApp untuk ejen AI: akses rasmi dalam beberapa minit, tanpa menjadi Tech Provider
Ejen AI mendapat akses rasmi WhatsApp melalui Cloud API Meta, dan nombor yang kekal dalam aplikasi WhatsApp Business disambungkan melalui Tech Provider atau Solution Partner. Anda boleh menjadi salah satu daripadanya, dengan pengesahan perniagaan, video App Review dan binaan Embedded Signup, atau menyambung melalui penyedia yang sudah menjadi salah satu daripadanya: nombor itu disambungkan dalam beberapa minit dan ejen mendapat alat MCP atau kelayakan API.
easyCoexistence ialah Meta Tech Provider bebas: ia menyambungkan nombor WhatsApp Business ke Cloud API melalui Coexistence dalam beberapa minit, supaya ejen anda mendapat akses rasmi sementara perniagaan terus menggunakan aplikasinya.
Apa yang Meta perlukan daripada sesiapa yang mendaftarkan nombor yang kekal dalam aplikasi WhatsApp Business: status Tech Provider atau Solution Partner.
App Review meminta satu video mesej yang dihantar daripada aplikasi anda, dan satu video aplikasi anda mencipta templat.
Apa yang App Review berikan untuk whatsapp_business_messaging dan whatsapp_business_management, kedua-duanya diperlukan untuk menjadi Tech Provider.
Apabila Meta menamatkan sokongan Embedded Signup v2 dan v3, memberitahu integrasi supaya beralih ke v4.
Throughput tetap bagi nombor yang digunakan dengan kedua-dua aplikasi WhatsApp Business dan Cloud API.
Berapa lama pautan sambungan yang dihoskan kekal sah apabila platform mendaftarkan nombor pelanggan melalui Partner API.
Apakah yang diperlukan oleh ejen AI untuk menggunakan WhatsApp secara rasmi?
Empat perkara daripada Cloud API Meta. ID nombor telefon dan token akses dengan kebenaran whatsapp_business_messaging, supaya ejen boleh memanggil endpoint messages. Endpoint webhook tempat Meta menghantar mesej masuk, dan, pada nombor yang dikongsi dengan aplikasi, smb_message_echoes bagi balasan yang ditaip oleh seseorang di telefon. Templat yang diluluskan, kerana mesej yang ditaip hanya sampai kepada orang yang menghubungi dalam masa 24 jam terakhir. Dan cara untuk tahu bila sambungan terputus, kerana aplikasi di telefon terus berfungsi walaupun bahagian API berhenti.
Pintasan yang paling cepat dijumpai orang ialah automasi WhatsApp Web, yang log masuk sebagai peranti terpaut. Ini melanggar terma WhatsApp dan meletakkan nombor itu dalam risiko disekat, tanpa mengira apa pun yang ejen di atasnya lakukan.
Apa yang terlibat dalam laluan Tech Provider?
Urutan Meta sendiri, mengikut susunan ini. Setiap langkah adalah percuma, dan tiada satu pun boleh dibeli lebih cepat: semakan berjalan mengikut jadual Meta dan Meta tidak menerbitkan garis masa, jadi rancang untuk minggu, bukan hari, sebelum nombor pelanggan pertama disambungkan. Selepas itu bahagian backend mesti terus berjalan: pertukaran token selepas setiap pendaftaran, penerima webhook, penghalaan mengikut nombor, dan pemantauan untuk pemutusan seperti peraturan tidak aktif 14 hari Meta.
Apakah laluan yang lebih pendek?
Sambungkan nombor melalui penyedia yang sudah melalui proses itu. Dengan easyCoexistence, perniagaan menjalankan Embedded Signup Meta dan mengimbas kod dengan aplikasi WhatsApp Business, yang mengambil masa kira-kira dua minit, dan nombor itu menyertai Cloud API dalam portfolio perniagaan itu sendiri sementara aplikasi terus berfungsi. Ejen kemudian mendapat akses dalam bentuk yang difahaminya: alat MCP untuk pembantu seperti ChatGPT, Claude, Claude Code atau Codex, atau kelayakan dan webhook nombor untuk kod yang anda jalankan sendiri.
| 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 ejen mendapat kelayakan nombor?
Melalui get_api_credentials, atau dari halaman nombor dalam dashboard. Alat ini memulangkan URL asas Graph API, ID WhatsApp Business Account, ID nombor telefon, endpoint hantar dan, apabila wujud, token akses milik perniagaan itu sendiri, dengan skop kepada aset WhatsApp-nya. Apabila tiada token klien dikeluarkan, token dipulangkan sebagai null dengan nota bahawa menyambung semula nombor dari dashboard akan mengeluarkan satu, tanpa menggantikan token yang masih berfungsi. Tiada app secret untuk diambil, kerana Meta menandatangani webhook dengan app secret easyCoexistence, yang tidak pernah dikongsi. Alat ini memerlukan pelan aktif, kerana token itu boleh menghantar mesej.
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 mesej masuk sampai kepada ejen?
Setiap nombor mempunyai dua mod, ditukar dengan set_inbound_mode atau pada halaman nombor. Terus ke pelayan anda: set_webhook_destination menghalakan Meta terus ke endpoint HTTPS anda, yang mesti menjawab jabat tangan GET Meta, dan easyCoexistence tidak pernah melihat mesej, jadi automasi dimatikan. Oleh kerana Meta menandatangani penghantaran itu dengan app secret kami, letakkan rahsia rawak yang panjang dalam laluan URL dan tolak permintaan yang tidak menyertainya.
Automasi dihidupkan: Meta menghantar ke easyCoexistence, automasi boleh menjawab, dan Forward URL pilihan menerima payload asal Meta di bawah "value", ditandatangani dengan X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 bagi "<t>.<body>">, menggunakan rahsia yang dipaparkan sekali sahaja. Langkah Call my webhook dalam automasi juga menyerahkan mesej dan 10 mesej terakhir sembang kepada ejen anda, dan menghantar balasannya apabila jawapan anda {"reply": "..."} diterima dalam masa 20 saat.
Had mana yang perlu dipatuhi oleh ejen?
Had Meta, dan ia sama melalui mana-mana penyedia. Ejen yang mengetahuinya lebih awal dapat mengelakkan kegagalan yang kelihatan seperti pepijat:
- 20 mesej sesaat bagi setiap nombor, ditetapkan oleh Meta untuk nombor yang dikongsi dengan aplikasi WhatsApp Business.
- Mesej yang ditaip hanya dalam tempoh 24 jam selepas mesej terakhir pelanggan; selepas itu, templat yang diluluskan.
- Templat dihantar melalui API sahaja, kerana aplikasi pada nombor Coexistence tidak boleh menghantarnya.
- Balasan yang ditaip seseorang dalam aplikasi tiba sebagai
smb_message_echoes; hentikan ejen pada sembang itu, atau pelanggan menerima dua jawapan. - Sembang kumpulan tidak disegerakkan ke API, jadi ejen bekerja dalam sembang satu-dengan-satu.
- Kenalan dan sehingga 6 bulan sembang satu-dengan-satu diimport sekali sahaja, hanya jika destinasi webhook terus disimpan dalam masa 24 jam selepas menyambung; nombor dengan automasi dihidupkan tidak mendapat import itu.
- Panggilan suara dan video kekal berfungsi dalam aplikasi, tetapi Cloud API tidak membawa panggilan pada nombor Coexistence, jadi ejen bekerja dalam teks.
Bolehkah platform menyambungkan nombor pelanggannya sendiri dengan cara ini?
Boleh, melalui Partner API, cara SaaS atau agensi mendaftarkan pelanggannya tanpa status Tech Provider sendiri. Cipta kunci dengan create_api_key (ia bermula dengan ec_live_ dan dipaparkan sekali sahaja), kemudian panggil POST /api/v1/connect-sessions dari backend anda, atau create_connect_link dari pembantu, untuk pautan yang dihoskan dan sah selama 1 jam. Pelanggan menjalankan tetingkap timbul Meta dan imbasan QR di sana dan kembali ke redirect_url anda dengan connection_id. GET /api/v1/connections/:id?credentials=1 kemudian memulangkan token milik pelanggan, dan peristiwa status seperti connection.disconnected tiba ditandatangani dengan X-EC-Signature. Setiap nombor dibilkan kepada akaun anda pada julat setiap nombor yang sama.
Kesilapan biasa
- Mengesahkan X-Hub-Signature-256 pada destinasi terus. Meta menandatangani dengan app secret easyCoexistence, yang tidak pernah dikongsi, jadi penghantaran tulen gagal pemeriksaan; percayai rahsia rawak yang panjang dalam URL, atau gunakan penghantaran semula dengan X-EC-Signature.
- Menerima dengan nod WhatsApp Trigger n8n. Ia menjangka aplikasi Meta anda sendiri; gunakan nod Webhook generik dengan rahsia dalam URL-nya sebagai gantinya.
- Mengabaikan smb_message_echoes. Ejen kemudian menjawab di atas seseorang yang sudah membalas dari telefon, dan pelanggan membaca dua jawapan.
- Menyimpan destinasi webhook terus beberapa hari selepas menyambung, atau membiarkan nombor dalam automasi. Import sekali Meta bagi kenalan dan sehingga 6 bulan sembang memerlukan destinasi terus yang disimpan dalam masa 24 jam selepas sambungan.
Ejen bekerja melalui lebih 30 alat MCP atau melalui kelayakan dan webhook bagi setiap nombor, dan setiap nombor dipantau 24/7 dengan amaran. Daripada US$ 9 sebulan bagi setiap nombor yang disambungkan, menurun kepada US$ 0.75 apabila nombor ditambah, dengan 3 hari pertama percuma.
Soalan lazim
Adakah saya memerlukan app Meta sendiri?
Tidak. Nombor didaftarkan melalui app Meta easyCoexistence dan kekal dalam portfolio perniagaan sendiri serta akaun WhatsApp Business Account. Kod anda menghantar dengan token milik perniagaan dari get_api_credentials, jadi tiada app anda terlibat melainkan anda membinanya kemudian.
Bolehkah ejen dan pasukan menggunakan nombor itu pada masa yang sama?
Boleh. Meta mencerminkan mesej antara Cloud API dan aplikasi WhatsApp Business, jadi apa yang dihantar ejen muncul dalam urutan sembang aplikasi di telefon, dan apa yang pasukan taip dalam aplikasi sampai kepada sistem anda sebagai smb_message_echoes.
Rangka kerja ejen manakah berfungsi dengannya?
Mana-mana klien yang bercakap MCP melalui HTTP dengan OAuth, seperti ChatGPT, Claude, Claude Code, Codex dan Cursor, serta mana-mana kod yang memanggil Graph API Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK atau Vercel AI SDK. API di bawahnya ialah milik Meta sendiri, jadi tiada apa yang proprietari terletak di dalam ejen.
Adakah pembantu AI tujuan umum dibenarkan di WhatsApp?
Seksyen 4.7 Business Solution Terms Meta menghalang penyedia pembantu AI tujuan umum daripada menawarkannya pada WhatsApp Business Platform apabila AI itu fungsi utama, seperti yang ditentukan Meta, berkuat kuasa sejak 15 Januari 2026. Perniagaan yang menggunakan AI untuk pelanggannya sendiri, untuk sokongan, jualan atau tempahan, bukan sasarannya, dan pengawal selia di EU dan Brazil telah mengarahkan Meta untuk menggantung atau menarik balik peraturan itu bagi pembantu pesaing.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada