Ga naar Developers > Credentials en maak een token voor de messages:write-integratie. Kopieer het tijdens het maken, sla het op in je backend en configureer de WhatsApp-verbinding in het dashboard voordat je verzendt.
API-ontwikkelaar
API om WhatsApp te verbinden met uw systemen en applicaties.
Integreer CRM, ERP, apps en interne systemen met WhatsApp via de WPP Marketing REST API. Verstuur tekst en media, vraag berichten op en volg leveringen via webhooks. Gebruik ook MCP om je flows met de Official API te integreren. Leer MCP kennen.
Wanneer te gebruiken
Gebruik de Messaging API wanneer uw systeem WhatsApp-berichten moet verzenden.
Gebruik uw CRM om een contact te starten, uw ERP om een update te sturen of uw app om een klant te informeren. De logica wanneer te verzenden blijft in uw systeem; de API voert het verzenden uit via de verbinding die op het account is ingesteld. Voor kant-en-klare commerciële automatiseringen gebruikt u de Events API.
Gebruik POST /send-text voor tekst of POST /send-media voor media. Bij de officiële verbinding gebruiken tekst en afbeelding de geconfigureerde templates; audio, video en documenten vereisen een bericht van de klant dat in de laatste 24 uur is ontvangen.
HTTP 200 geeft acceptatie aan, geen bezorging. Met messages:read, gebruik GET /messages en controleer de beschikbare statussen voor het kanaal.
Registreer de HTTPS-URL en schakel gebeurtenissen in op het dashboard. Gebruik webhooks:read om pogingen op te vragen via GET /webhooks; deze endpoint geeft leveringen weer, hij registreert geen abonnementen.
Van token tot de eerste inbegrepen verzending.
Vervang op uw server SEU_TOKEN door de referentie en het nummer door de gemachtigde ontvanger voor de test. Gebruik per verzending een unieke sleutel en hergebruik dezelfde sleutel alleen wanneer u exact hetzelfde verzoek herhaalt.
Controleer de HTTP-status en de responsebody. Bij 401 controleer je het token en de geldigheid ervan; bij 403 verifieer je de scopes en accountvoorwaarden. Bij 409 controleer je of de sleutel al met andere inhoud is gebruikt. Bij 429 respecteer je Retry-After voordat je het opnieuw probeert.
Controleer daarna GET /messages met messages:read of monitor de geconfigureerde webhooks. Leveringsbevestiging hangt af van de reactie van het kanaal.
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."}'Tekst, media, geschiedenis en tracking van verzendingen.
Gebruik de REST‑endpoints om WhatsApp in uw applicatie te integreren. De WPP Marketing API gebruikt de in het account geconfigureerde verbinding; om met de officiële WhatsApp API te werken, configureer die verbinding in het dashboard. Zie de OpenAPI voor de formaten, scopes, limieten en responses van elke operatie.
POST
/send-text
Verzendt een tekstbericht naar een WhatsApp-nummer.
Texto
POST
/send-media
Verstuur afbeelding, audio, video of document via een openbare HTTPS-URL, volgens het formaat en de verbindingsvoorwaarden. Audio gebruikt dezelfde endpoint.
Mídia
GET
/messages
Bekijk de geschiedenis van verzonden berichten met status en paginering.
Histórico
GET
/webhooks
Controleer webhook-leveringen met gebeurtenis, HTTP-resultaat, pogingen en paginering.
Webhooks
DOC
Swagger / OpenAPI
Interactieve documentatie met contracten, voorbeelden, verplichte velden en verwachte antwoorden.
Docs
Technische scheiding
Kies de juiste functie voor elke fase van de integratie.
Stuur berichten met de Messaging API, activeer zakelijke automatiseringen met de Events API en ontvang callbacks via webhooks. Uw toepassing kan deze functies combineren volgens de benodigde workflow.
De officiële verbinding is het communicatiekanaal; de WPP Marketing API is de interface die uw systeem gebruikt. Raadpleeg de vereisten op Officiële WhatsApp-API en co-existentie.
Uw systeem roept WPP Marketing aan om tekst- of mediamessages te verzenden en om berichtgeschiedenissen en webhook-leveringen op te vragen.
Uw systeem verzendt commerciële gebeurtenissen zoals bestelling aangemaakt, betaling goedgekeurd, verzending of verlaten winkelwagen.
Begrijp de beschikbare gebeurtenissen en automatiseringenWPP Marketing stuurt gestandaardiseerde aanmaak-, bezorg-, lees- en foutgebeurtenissen naar een door u opgegeven URL.
Bekijk retourgebeurtenissen en bezorgtrackingGebruik de interactieve documentatie om payloads, authenticatie en responses te valideren voordat u in productie gaat.
Tokens moeten op de backend blijven. Maak geen inloggegevens openbaar op publieke pagina's, front-end apps of in repositories.
In /send-text en /send-media stelt Idempotency-Key je in staat dezelfde aanvraag tot 48 uur met een succesvolle respons te herhalen. Het opnieuw gebruiken van de sleutel met andere inhoud geeft 409 terug. Zonder de sleutel kan het opnieuw aanroepen de verzending dupliceren. Houd rekening met de headers RateLimit en Retry-After; verzoeklimieten verschillen van de planquota.
Één referentie per integratie, met de benodigde machtigingen.
Geef in het dashboard de token een naam, selecteer de scopes en stel optioneel een vervaldatum in. De volledige token wordt bij aanmaken slechts één keer weergegeven. In de lijst kunt u het laatstgebruik, de vervaldatum controleren en indien nodig de toegang intrekken.
Bij het wisselen van een credential, werk het geheim op uw server bij en intrek de vorige. Gebruik nooit het WhatsApp-providertoken in plaats van de API-credential.
Maakt het verzenden van tekst en media mogelijk. Alleen toekennen aan integraties die verzendingen moeten starten.
Ze maken het respectievelijk mogelijk om de berichtgeschiedenis en webhook‑leveringen te raadplegen. Een verzendreferentie krijgt deze permissies niet automatisch.
Maakt het mogelijk om klanten, winkelwagens en bestellingen via de Events API te informeren aan automatiseringen die in het account zijn geconfigureerd.
Raadpleegt opgeslagen instellingen, automatiseringen, tellingen en recente logboeken voor diagnose. Kan persoonlijke gegevens en berichtinhoud bevatten: geef alleen toegang aan geautoriseerde integraties en support. Deze query controleert niet live de verbinding met de provider.
MCP en officiële WhatsApp API.
Verbind AI‑tools met je WhatsApp‑operatie via het MCP van WPP Marketing. Integreer WhatsApp in de workflows van je assistenten en agenten, met de Official API als berichtverbinding.
MCP koppelt de flows van je agents aan de integratie; de messaging-API verzorgt de verzendingen en de officiële verbinding volgt de regels van WhatsApp. Dit maakt MCP geen native chatbot en vervangt niet de accountconfiguratie. Het team begeleidt de acties en integratievereisten voor jouw use case.
Gebruik MCP als integratiepad tussen AI-tools en WhatsApp, ter vervanging van de stromen van uw systemen en team.
Overleg met ons team over de AI-tool die u gebruikt en de acties die u aan WhatsApp wilt koppelen. Controleer de vereisten en de juiste scope voor uw operatie.
Praten over MCP-integratieKlaar om uw systeem met WPP Marketing te integreren?
Open Swagger om Messaging API-endpoints, payloadvoorbeelden, bearer token-authenticatie en verwachte responses te raadplegen. Voor winkelevenementen en bezorgingsfeedback, zie ook Events API en Webhooks de status.