În Developers > Credentials, creează un token pentru integrarea messages:write. Copiază-l la crearea sa, păstrează‑l în backend și configurează conexiunea WhatsApp în dashboard înainte de a trimite.
Dezvoltator API
API pentru conectarea WhatsApp la sistemele și aplicațiile tale.
Integrează CRM, ERP, aplicații și sisteme interne cu WhatsApp folosind REST API-ul WPP Marketing. Trimite text și media, interoghează mesaje și urmărește livrările prin webhooks. Folosește și MCP pentru a integra fluxurile tale cu Official API. Află despre MCP.
Când să folosești
Folosiți Messaging API atunci când sistemul dvs. trebuie să trimită mesaje WhatsApp.
Folosește CRM-ul pentru a iniția un contact, ERP-ul pentru a trimite o actualizare sau aplicația ta pentru a notifica un client. Logica privind momentul trimiterii rămâne în sistemul tău; API execută trimiterea prin conexiunea configurată în cont. Pentru automatizări comerciale gata făcute, folosește Events API.
Folosește POST /send-text pentru text sau POST /send-media pentru media. În conexiunea oficială, textul și imaginea folosesc template-urile configurate; audio, video și documentele necesită un mesaj primit de la client în ultimele 24 de ore.
HTTP 200 indică acceptare, nu livrare. Cu messages:read, folosește GET /messages și verifică stările disponibile pentru canal.
Înregistrează URL-ul HTTPS și activează evenimentele în panou. Folosește webhooks:read pentru a interoga încercările la GET /webhooks; acest endpoint listează livrările, nu înregistrează abonamente.
De la token până la prima expediere inclusă.
Pe serverul dvs., înlocuiți SEU_TOKEN cu credențialul și numărul cu destinatarul autorizat pentru test. Folosiți o cheie unică pentru fiecare trimitere și reutilizați aceeași cheie doar când repetați aceeași solicitare.
Verifică statusul HTTP și corpul răspunsului. Pentru 401, revizuiește tokenul și valabilitatea acestuia; pentru 403, verifică scope‑urile și condițiile contului. Pentru 409, verifică dacă cheia a fost deja folosită cu un alt conținut. Pentru 429, respectă Retry-After înainte de a reîncerca.
Apoi consultați GET /messages cu messages:read sau monitorizați webhooks configurate. Confirmarea livrării depinde de răspunsul canalului.
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."}'Text, media, istoric și urmărire a trimiterelor.
Folosește endpoint-urile REST pentru a integra WhatsApp în aplicația ta. API‑ul WPP Marketing folosește conexiunea configurată în cont; pentru a lucra cu Official WhatsApp API, configurează acea conexiune în panoul de control. Consultă OpenAPI pentru formatele, scope‑urile, limitele și răspunsurile fiecărei operațiuni.
POST
/send-text
Trimite un mesaj text către un număr WhatsApp.
Texto
POST
/send-media
Trimite imagine, audio, video sau document printr-un URL public HTTPS, conform formatului și condițiilor de conexiune. Audio folosește același endpoint.
Mídia
GET
/messages
Consulta istoricul mesajelor trimise cu stare și paginare.
Histórico
GET
/webhooks
Vizualizați livrările webhook cu eveniment, rezultat HTTP, încercări și paginare.
Webhooks
DOC
Swagger / OpenAPI
Documentație interactivă cu contracte, exemple, câmpuri obligatorii și răspunsuri așteptate.
Docs
Separare tehnică
Alege funcția potrivită pentru fiecare etapă a integrării.
Trimite mesaje cu Messaging API, declanșează automatizări comerciale cu Events API și primește callback‑uri prin webhooks. Aplicația ta poate combina aceste funcții în funcție de fluxul necesar.
Conexiunea oficială este canalul de comunicare; API-ul WPP Marketing este interfața utilizată de sistemul dvs. Consultați cerințele la API oficial WhatsApp și coexistență.
Sistemul tău apelează WPP Marketing pentru a trimite mesaje text sau media și pentru a interoga istoricul mesajelor și livrările webhook.
Sistemul dvs. trimite evenimente comerciale precum comandă creată, plată aprobată, expediere sau coș abandonat.
Înțelegeți evenimentele și automatizările disponibileWPP Marketing trimite evenimente standardizate de creare, livrare, citire și eroare către un URL pe care îl furnizați.
Vizualizați evenimentele de retur și urmărirea livrărilorFolosiți documentația interactivă pentru a valida payload-urile, autentificarea și răspunsurile înainte de a pune în producție.
Tokenurile trebuie să rămână în backend. Nu expuneți credențiale pe pagini publice, în aplicații front-end sau în repoziții.
În /send-text și /send-media, Idempotency-Key îți permite să repeți aceeași solicitare cu răspuns reușit timp de până la 48 de ore. Reutilizarea cheii cu conținut diferit returnează 409. Fără cheie, reluarea apelului poate duplica trimiterea. Respectați headerele RateLimit și Retry-After; limitele de cereri diferă de cota planului.
O singură acreditare per integrare, cu permisiunile necesare.
În panou, atribuiți un nume token-ului, selectați scope-urile și setați o expirare opțională. Token-ul complet este afișat doar o dată la creare. Lista vă permite să verificați ultima utilizare, expirarea și să revocați accesul când este necesar.
La rotirea unei acreditări, actualizați secretul pe serverul dvs. și revocați-o pe cea precedentă. Nu folosiți niciodată tokenul furnizorului WhatsApp în locul acreditării API.
Permite trimiterea de text și media. Acordați doar integrărilor care trebuie să inițieze trimiterea.
Permit consultarea, respectiv, a istoricului mesajelor și a livrărilor webhook. O credentială de trimitere nu primește aceste permisiuni automat.
Permite transmiterea clienților, coșurilor și comenzilor prin Events API către automatizările configurate în cont.
Verifică setările stocate, automatizările, numărările și jurnalele recente pentru diagnostic. Poate include date personale și conținutul mesajelor: acordați acces doar integrărilor și suportului autorizat. Această interogare nu verifică în timp real conexiunea cu furnizorul.
MCP și API-ul oficial WhatsApp.
Conectează unelte AI la operațiunea ta WhatsApp cu MCP-ul WPP Marketing. Integrează WhatsApp în fluxurile asistenților și agenților tăi, folosind Official API ca legătură de mesagerie.
MCP conectează fluxurile agenților tăi la integrare; API‑ul de mesagerie execută trimiterea mesajelor, iar conexiunea oficială respectă regulile WhatsApp. Acest lucru nu transformă MCP într-un chatbot nativ și nu înlocuiește configurarea contului. Echipa ghidează acțiunile și cerințele de integrare pentru cazul tău de utilizare.
Folosește MCP ca drum de integrare între instrumentele AI și WhatsApp, completând fluxurile sistemelor și ale echipei tale.
Discută cu echipa noastră despre instrumentul AI pe care îl folosești și acțiunile pe care dorești să le conectezi la WhatsApp. Verifică cerințele și domeniul adecvat pentru operațiunea ta.
Vorbește despre integrarea MCPGata să integrați sistemul dvs. cu WPP Marketing?
Deschide Swagger pentru a consulta endpoint-urile Messaging API, exemple de payload, autentificarea bearer token și răspunsurile așteptate. Pentru evenimentele magazinului și feedback-ul de livrare, vezi și Events API și Webhooks de status.