Di Developers > Credentials, buat token untuk integrasi messages:write. Salin semasa penciptaan, simpan di backend anda dan konfigurasikan sambungan WhatsApp di papan pemuka sebelum menghantar.
Pembangun API
API untuk menyambungkan WhatsApp ke sistem dan aplikasi anda.
Integrasikan CRM, ERP, aplikasi dan sistem dalaman dengan WhatsApp menggunakan WPP Marketing REST API. Hantar teks dan media, dapatkan maklumat mesej dan jejak penghantaran melalui webhooks. Gunakan juga MCP untuk menyepadukan aliran anda dengan Official API. Ketahui MCP.
Bila untuk digunakan
Gunakan Messaging API apabila sistem anda perlu menghantar mesej WhatsApp.
Gunakan CRM anda untuk memulakan kontak, ERP anda untuk menghantar kemas kini atau aplikasi anda untuk memberitahu pelanggan. Logik bila untuk menghantar kekal dalam sistem anda; API melaksanakan penghantaran melalui sambungan yang dikonfigurasikan pada akaun. Untuk automasi komersial sedia ada, gunakan Events API.
Gunakan POST /send-text untuk teks atau POST /send-media untuk media. Pada sambungan rasmi, teks dan imej menggunakan templat yang telah dikonfigurasikan; audio, video dan dokumen memerlukan mesej yang diterima dari pelanggan dalam 24 jam terakhir.
HTTP 200 menunjukkan penerimaan, bukan penghantaran. Dengan messages:read, gunakan GET /messages dan semak status tersedia untuk saluran.
Daftarkan URL HTTPS dan aktifkan acara di papan pemuka. Gunakan webhooks:read untuk menyiasat percubaan di GET /webhooks; endpoint ini menyenaraikan penghantaran, ia tidak mendaftarkan langganan.
Daripada token kepada penghantaran pertama yang disertakan.
Pada pelayan anda, gantikan SEU_TOKEN dengan kelayakan dan nombor dengan penerima yang diberi kuasa untuk ujian. Gunakan kunci unik untuk setiap penghantaran dan gunakan semula kunci yang sama hanya apabila mengulangi permintaan yang sama.
Semak status HTTP dan badan respons. Untuk 401, semak token dan kesahihannya; untuk 403, sahkan skop (scopes) dan syarat akaun. Untuk 409, periksa sama ada kunci telah digunakan dengan kandungan lain. Untuk 429, patuhi Retry-After sebelum mencuba semula.
Kemudian periksa GET /messages dengan messages:read atau pantau webhooks yang dikonfigurasikan. Pengesahan penghantaran bergantung pada respons saluran.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'Teks, media, sejarah dan penjejakan penghantaran.
Gunakan endpoints REST untuk mengintegrasikan WhatsApp dengan aplikasi anda. WPP Marketing API menggunakan sambungan yang dikonfigurasikan dalam akaun; untuk beroperasi dengan Official WhatsApp API, konfigurasikan sambungan itu di papan pemuka. Lihat OpenAPI untuk format, skop, had dan respons setiap operasi.
POST
/send-text
Menghantar mesej teks kepada nombor WhatsApp.
Texto
POST
/send-media
Hantar imej, audio, video atau dokumen melalui URL HTTPS awam, mengikut format dan syarat sambungan. Audio menggunakan endpoint yang sama.
Mídia
GET
/messages
Semak sejarah mesej yang dihantar dengan status dan penomboran halaman.
Histórico
GET
/webhooks
Semak penghantaran webhook mengikut acara, keputusan HTTP, percubaan dan halaman.
Webhooks
DOC
Swagger / OpenAPI
Dokumentasi interaktif dengan kontrak, contoh, medan wajib dan respons yang dijangkakan.
Docs
Pemisahan teknikal
Pilih ciri yang betul untuk setiap peringkat integrasi.
Hantar mesej dengan Messaging API, picu automasi perniagaan dengan Events API dan terima maklum balas melalui webhooks. Aplikasi anda boleh menggabungkan ciri-ciri ini mengikut aliran yang diperlukan.
Sambungan rasmi ialah saluran komunikasi; WPP Marketing API ialah antara muka yang digunakan oleh sistem anda. Lihat keperluan di API Rasmi WhatsApp dan koeksistensi.
Sistem anda memanggil WPP Marketing untuk menghantar mesej teks atau media dan untuk mengutif (query) sejarah mesej serta penghantaran webhook.
Sistem anda menghantar acara komersial seperti pesanan dibuat, pembayaran diluluskan, penghantaran atau troli ditinggalkan.
Fahami acara dan automasi yang tersediaWPP Marketing menghantar acara piawai untuk penciptaan, penghantaran, pembacaan dan ralat ke URL yang anda sediakan.
Lihat acara pemulangan dan penjejakan penghantaranGunakan dokumentasi interaktif untuk mengesahkan payload, pengesahan dan respons sebelum diletakkan dalam pengeluaran.
Token mesti disimpan di backend. Jangan dedahkan kelayakan di halaman awam, aplikasi front-end atau repositori.
Dalam /send-text dan /send-media, Idempotency-Key membolehkan anda mengulangi permintaan yang sama dengan respons berjaya selama sehingga 48 jam. Menggunakan semula kekunci dengan kandungan lain mengembalikan 409. Tanpa kekunci, mengulangi panggilan mungkin menggandakan penghantaran. Patuhi header RateLimit dan Retry-After; had permintaan berbeza daripada kuota pelan.
Satu kelayakan untuk setiap integrasi, dengan kebenaran yang diperlukan.
Di papan pemuka, namakan token, pilih skop dan tetapkan tarikh luput pilihan. Token penuh dipaparkan hanya sekali semasa penciptaan. Senarai membolehkan anda menyemak penggunaan terakhir, tarikh luput dan mencabut akses apabila perlu.
Apabila menukar kelayakan, kemas kini rahsia pada pelayan anda dan batal yang sebelum ini. Jangan sekali-kali gunakan token penyedia WhatsApp sebagai ganti kelayakan API.
Membolehkan penghantaran teks dan media. Beri sahaja kepada integrasi yang perlu memulakan penghantaran.
Mereka membenarkan semakan, masing-masing, sejarah mesej dan penghantaran webhook. Kredit penghantaran tidak menerima kebenaran ini secara automatik.
Membolehkan penghantaran pelanggan, troli dan pesanan melalui Events API ke automasi yang dikonfigurasikan dalam akaun.
Memeriksa tetapan tersimpan, automasi, kiraan dan log terkini untuk diagnosis. Mungkin termasuk data peribadi dan kandungan mesej: beri akses hanya kepada integrasi dan sokongan yang diberi kuasa. Pertanyaan ini tidak memeriksa sambungan pembekal secara langsung.
MCP dan API Rasmi WhatsApp.
Sambungkan alat AI ke operasi WhatsApp anda dengan MCP WPP Marketing. Gabungkan WhatsApp ke dalam aliran kerja pembantu dan ejen anda, menggunakan Official API sebagai sambungan pemesejan.
MCP menghubungkan aliran ejen anda kepada integrasi; API pemesejan melaksanakan penghantaran dan sambungan rasmi mematuhi peraturan WhatsApp. Ini tidak menjadikan MCP sebagai chatbot asli dan tidak menggantikan tetapan akaun. Pasukan membimbing tindakan dan keperluan integrasi untuk kes penggunaan anda.
Gunakan MCP sebagai laluan integrasi antara alat AI dan WhatsApp, melengkapkan aliran sistem dan pasukan anda.
Bercakap dengan pasukan kami mengenai alat AI yang anda gunakan dan tindakan yang anda ingin sambungkan ke WhatsApp. Semak keperluan dan skop yang sesuai untuk operasi anda.
Bercakap tentang integrasi MCPBersedia untuk mengintegrasikan sistem anda dengan WPP Marketing?
Buka Swagger untuk melihat endpoints Messaging API, contoh payload, pengesahan bearer token dan respons yang dijangkakan. Untuk acara kedai dan maklum balas penghantaran, lihat juga Events API dan Webhooks de status.