I Developers > Credentials, skapa en token för integrationen messages:write. Kopiera den vid skapandet, spara den i din backend och konfigurera WhatsApp‑anslutningen i instrumentpanelen innan du skickar.
API-utvecklare
API för att koppla WhatsApp till dina system och applikationer.
Integrera CRM, ERP, appar och interna system med WhatsApp via WPP Marketing REST API. Skicka text och media, fråga meddelanden och följ leveranser via webhooks. Använd även MCP för att integrera dina flöden med Official API. Lär känna MCP.
När ska användas
Använd Messaging-API:et när ditt system behöver skicka WhatsApp-meddelanden.
Använd ditt CRM för att initiera en kontakt, ditt ERP för att skicka en uppdatering eller din app för att meddela en kund. Logiken för när det ska skickas ligger i ditt system; API:et utför utskicket via anslutningen konfigurerad på kontot. För färdiga kommersiella automationer, använd Events API.
Använd POST /send-text för text eller POST /send-media för media. Vid den officiella anslutningen använder text och bild de konfigurerade mallarna; ljud, video och dokument kräver ett meddelande mottaget från kunden inom de senaste 24 timmarna.
HTTP 200 indikerar mottagande, inte leverans. Med messages:read, använd GET /messages och kontrollera tillgängliga statusar för kanalen.
Registrera HTTPS-URL:en och aktivera händelser i panelen. Använd webhooks:read för att fråga försök på GET /webhooks; denna endpoint listar leveranser, den registrerar inte prenumerationer.
Från token till första inkluderade leveransen.
På din server, byt ut SEU_TOKEN mot referensen och numret mot den auktoriserade mottagaren för testet. Använd en unik nyckel per utskick och återanvänd samma nyckel endast när du upprepar samma begäran.
Kontrollera HTTP‑status och svarstext. För 401, granska token och dess giltighet; för 403, kontrollera scopes och kontovillkor. För 409, kontrollera om nyckeln redan använts med annat innehåll. För 429, respektera Retry-After innan du försöker igen.
Kontrollera sedan GET /messages med messages:read eller övervaka de konfigurerade webhooks. Leveransbekräftelse beror på kanalens svar.
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, historik och spårning av utskick.
Använd REST‑endpoints för att integrera WhatsApp med din applikation. WPP Marketing‑API:n använder den anslutning som är konfigurerad på kontot; för att arbeta med den officiella WhatsApp‑API:n, konfigurera den anslutningen i kontrollpanelen. Se OpenAPI för format, scopes, gränser och svar för varje operation.
POST
/send-text
Skickar ett textmeddelande till ett WhatsApp-nummer.
Texto
POST
/send-media
Skicka bild, ljud, video eller dokument via en offentlig HTTPS-URL, enligt formatet och anslutningsvillkoren. Ljud använder samma endpoint.
Mídia
GET
/messages
Visa historik över skickade meddelanden med status och paginering.
Histórico
GET
/webhooks
Kontrollera webhook-leveranser med händelse, HTTP-resultat, försök och paginering.
Webhooks
DOC
Swagger / OpenAPI
Interaktiv dokumentation med kontrakt, exempel, obligatoriska fält och förväntade svar.
Docs
Teknisk separation
Välj rätt funktion för varje steg i integrationen.
Skicka meddelanden med Messaging API, trigga affärsautomationer med Events API och ta emot svar via webhooks. Din applikation kan kombinera dessa funktioner beroende på det flöde som krävs.
Den officiella anslutningen är kommunikationskanalen; WPP Marketing API är gränssnittet som ditt system använder. Se kraven på Officiell WhatsApp-API och samexistens.
Ditt system anropar WPP Marketing för att skicka text- eller meddelandemedia och för att fråga meddelandehistorik och webhook‑leveranser.
Ditt system skickar kommersiella händelser som order skapad, betalning godkänd, leverans eller övergiven kundvagn.
Förstå de tillgängliga händelserna och automationernaWPP Marketing skickar standardiserade skapande-, leverans-, läs- och felfhändelser till en URL du anger.
Se returhändelser och leveransspårningAnvänd den interaktiva dokumentationen för att validera payloads, autentisering och svar innan du går i produktion.
Tokens måste stanna i backend. Exponera inte autentiseringsuppgifter på publika sidor, front-end-appar eller i repositories.
I /send-text och /send-media gör Idempotency-Key det möjligt att upprepa samma begäran med ett lyckat svar i upp till 48 timmar. Återanvändning av nyckeln med annat innehåll returnerar 409. Utan nyckeln kan upprepade anrop duplicera utskicket. Respektera headerarna RateLimit och Retry-After; begärandegränserna skiljer sig från planens kvot.
En referens per integration, med nödvändiga behörigheter.
I panelen, ge namnge token, välj scopes och ange ett valfritt utgångsdatum. Den fullständiga token visas endast en gång vid skapandet. Listan låter dig kontrollera senaste användning, utgångsdatum och återkalla åtkomst vid behov.
När du byter en credential, uppdatera hemligheten på din server och återkalla den tidigare. Använd aldrig WhatsApp-leverantörens token i stället för API-credential.
Möjliggör att skicka text och media. Bevilja endast till integrationer som behöver initiera utskick.
De tillåter att man, respektive, kan granska meddelandehistoriken och webhook‑leveranser. En sändningsuppgift får inte dessa behörigheter automatiskt.
Gör det möjligt att skicka kunder, kundvagnar och beställningar via Events API till de automationer som är konfigurerade i kontot.
Kontrollerar sparade inställningar, automationer, räkningar och senaste loggar för diagnostik. Kan innehålla personuppgifter och meddelandeinnehåll: ge endast åtkomst till auktoriserade integrationer och support. Denna förfrågan kontrollerar inte leverantörsanslutningen i realtid.
MCP och officiella WhatsApp-API:et.
Anslut AI‑verktyg till din WhatsApp‑drift med WPP Marketings MCP. Integrera WhatsApp i dina assistenters och agenters arbetsflöden, med Official API som meddelandekoppling.
MCP kopplar dina agenters flöden till integrationen; messaging‑API:en utför utskicken och den officiella anslutningen följer WhatsApps regler. Det förvandlar inte MCP till en inbyggd chatbot och ersätter inte kontoinställningen. Teamet vägleder åtgärderna och integrationskraven för ditt användningsfall.
Använd MCP som integrationsväg mellan AI‑verktyg och WhatsApp, för att komplettera dina system- och teamflöden.
Prata med vårt team om den AI‑lösning du använder och de åtgärder du vill koppla till WhatsApp. Kontrollera kraven och lämplig omfattning för din verksamhet.
Prata om MCP-integrationenRedo att integrera ditt system med WPP Marketing?
Öppna Swagger för att se Messaging API-endpoints, exempel på payload, bearer token-autentisering och förväntade svar. För butiks-händelser och leveransåterkoppling, se även Events API och Webhooks de status.