In Sviluppatori > Credenziali, crea un token per l'integrazione messages:write. Copialo durante la creazione, salvalo nel backend e configura la connessione WhatsApp nel pannello prima di inviare.
Sviluppatore API
API per collegare WhatsApp ai tuoi sistemi e alle tue applicazioni.
Integra CRM, ERP, app e sistemi interni con WhatsApp tramite la REST API di WPP Marketing. Invia testo e media, consulta i messaggi e monitora le consegne tramite webhook. Usa anche MCP per integrare i tuoi flussi con l’API Ufficiale. Scopri MCP.
Quando usare
Usa l'API di messaggistica quando il tuo sistema deve inviare messaggi WhatsApp.
Usa il tuo CRM per avviare un contatto, il tuo ERP per inviare un aggiornamento o la tua app per avvisare un cliente. La logica su quando inviare rimane nel tuo sistema; l'API esegue l'invio tramite la connessione configurata nell'account. Per automazioni commerciali pronte all'uso, usa la Events API.
Usa POST /send-text per testo o POST /send-media per media. Nella connessione ufficiale, testo e immagine usano i template configurati; audio, video e documenti richiedono un messaggio ricevuto dal cliente nelle ultime 24 ore.
HTTP 200 indica accettazione, non consegna. Con messages:read, usa GET /messages e controlla gli stati disponibili per il canale.
Registra l'URL HTTPS e abilita gli eventi nel pannello. Usa webhooks:read per consultare i tentativi con GET /webhooks; questo endpoint elenca le consegne, non registra le sottoscrizioni.
Dal token alla prima spedizione inclusa.
Sul tuo server, sostituisci SEU_TOKEN con la credenziale e il numero con il destinatario autorizzato per il test. Usa una chiave unica per ogni invio e riutilizza la stessa chiave solo quando ripeti la stessa richiesta.
Controlla lo stato HTTP e il corpo della risposta. Per 401, verifica il token e la sua validità; per 403, controlla gli scope e le condizioni dell'account. Per 409, verifica se la chiave è già stata usata con altro contenuto. Per 429, rispetta Retry-After prima di riprovare.
Quindi controlla GET /messages con messages:read o monitora i webhook configurati. La conferma di consegna dipende dalla risposta del canale.
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."}'Testo, media, cronologia e tracciamento degli invii.
Usa gli endpoint REST per integrare WhatsApp nella tua applicazione. L’API di WPP Marketing utilizza la connessione configurata nell’account; per operare con l’API ufficiale di WhatsApp, configura tale connessione nel pannello. Consulta l’OpenAPI per i formati, gli ambiti, i limiti e le risposte di ogni operazione.
POST
/send-text
Invia un messaggio di testo a un numero WhatsApp.
Texto
POST
/send-media
Invia immagine, audio, video o documento tramite un URL pubblico HTTPS, in base al formato e alle condizioni della connessione. L'audio usa lo stesso endpoint.
Mídia
GET
/messages
Consulta la cronologia dei messaggi inviati con stato e paginazione.
Histórico
GET
/webhooks
Consulta le consegne dei webhook con evento, risultato HTTP, tentativi e paginazione.
Webhooks
DOC
Swagger / OpenAPI
Documentazione interattiva con contratti, esempi, campi obbligatori e risposte previste.
Docs
Separazione tecnica
Scegli la funzionalità giusta per ogni fase dell'integrazione.
Invia messaggi con la Messaging API, avvia automazioni commerciali con la Events API e ricevi riscontri tramite webhook. La tua applicazione può combinare queste funzionalità in base al flusso necessario.
La connessione ufficiale è il canale di comunicazione; l'API di WPP Marketing è l'interfaccia utilizzata dal vostro sistema. Consulta i requisiti su API ufficiale di WhatsApp e coesistenza.
Il tuo sistema chiama WPP Marketing per inviare messaggi di testo o multimediali e per consultare gli storici dei messaggi e le consegne dei webhook.
Il tuo sistema invia eventi commerciali come ordine creato, pagamento approvato, spedizione o carrello abbandonato.
Comprendi gli eventi e le automazioni disponibiliWPP Marketing invia eventi standardizzati di creazione, consegna, lettura e errore a un URL che fornite.
Vedi gli eventi di reso e il tracciamento delle consegneUsa la documentazione interattiva per convalidare i payload, l'autenticazione e le risposte prima del rilascio in produzione.
I token devono rimanere nel backend. Non esporre le credenziali in pagine pubbliche, app front-end o repository.
In /send-text e /send-media, Idempotency-Key consente di ripetere la stessa richiesta con risposta avvenuta con successo per fino a 48 ore. Riutilizzare la chiave con contenuto diverso restituisce 409. Senza la chiave, ripetere la chiamata può duplicare l'invio. Rispetta gli header RateLimit e Retry-After; i limiti di richieste sono diversi dalla quota del piano.
Una credenziale per integrazione, con le autorizzazioni necessarie.
Nel pannello, assegna un nome al token, seleziona gli scope e imposta una scadenza opzionale. Il token completo viene mostrato una sola volta alla creazione. L'elenco consente di verificare l'ultimo utilizzo, la scadenza e revocare l'accesso se necessario.
Quando si ruota una credenziale, aggiorna il segreto sul tuo server e revoca la precedente. Non usare mai il token del provider di WhatsApp al posto della credenziale dell'API.
Consente l'invio di testo e media. Concedere solo alle integrazioni che devono avviare gli invii.
Consentono di consultare, rispettivamente, lo storico dei messaggi e le consegne dei webhook. Una credenziale di invio non riceve automaticamente queste autorizzazioni.
Consente a inviare clienti, carrelli e ordini tramite Events API alle automazioni configurate nell'account.
Consulta impostazioni memorizzate, automazioni, conteggi e registri recenti per la diagnostica. Può includere dati personali e contenuti dei messaggi: concedere solo a integrazioni e supporto autorizzati. Questa query non verifica la connessione al provider in tempo reale.
MCP e API ufficiale di WhatsApp.
Collega strumenti di IA alla tua operazione WhatsApp con l'MCP di WPP Marketing. Integra WhatsApp nei flussi dei tuoi assistenti e agenti, utilizzando l'API Ufficiale come connessione di messaggistica.
MCP collega i flussi dei tuoi agenti all'integrazione; l'API di messaggistica esegue gli invii e la connessione ufficiale segue le regole di WhatsApp. Questo non trasforma MCP in un chatbot nativo né sostituisce la configurazione dell'account. Il team guida le azioni e i requisiti di integrazione per il tuo caso d'uso.
Usa MCP come percorso di integrazione tra strumenti di IA e WhatsApp, integrando i flussi dei tuoi sistemi e del tuo team.
Parla con il nostro team dello strumento di IA che utilizzi e delle azioni che desideri collegare a WhatsApp. Verifica i requisiti e l'ambito adeguato per la tua operazione.
Parlare dell'integrazione MCPPronto per integrare il tuo sistema con WPP Marketing?
Apri lo Swagger per consultare gli endpoint della Messaging API, esempi di payload, l'autenticazione con bearer token e le risposte previste. Per gli eventi del negozio e il feedback di consegna, vedi anche Events API e Webhooks de status.