W Developers > Credentials utwórz token dla integracji messages:write. Skopiuj go podczas tworzenia, przechowaj w backendzie i skonfiguruj połączenie WhatsApp w panelu przed wysłaniem.
Twórca API
API do podłączenia WhatsApp z Twoimi systemami i aplikacjami.
Zintegruj CRM, ERP, aplikacje i systemy wewnętrzne z WhatsApp za pomocą REST API WPP Marketing. Wysyłaj tekst i multimedia, pobieraj wiadomości i śledź dostawy za pomocą webhooków. Użyj także MCP, aby zintegrować swoje flow z Official API. Poznaj MCP.
Kiedy używać
Użyj Messaging API, gdy twój system musi wysyłać wiadomości WhatsApp.
Użyj swojego CRM, aby rozpocząć kontakt, ERP, aby wysłać aktualizację, lub aplikacji, aby powiadomić klienta. Logika określająca, kiedy wysyłać, pozostaje w Twoim systemie; API wykonuje wysyłkę przez połączenie skonfigurowane na koncie. Do gotowych automatyzacji komercyjnych użyj Events API.
Użyj POST /send-text dla tekstu lub POST /send-media dla mediów. Przy oficjalnym połączeniu tekst i obraz korzystają z skonfigurowanych szablonów; audio, wideo i dokumenty wymagają wiadomości otrzymanej od klienta w ciągu ostatnich 24 godzin.
HTTP 200 oznacza przyjęcie, nie dostarczenie. Z messages:read użyj GET /messages i sprawdź dostępne statusy dla kanału.
Zarejestruj URL HTTPS i włącz zdarzenia w panelu. Użyj webhooks:read, aby zapytać o próby pod GET /webhooks; ten endpoint wymienia dostarczenia, nie rejestruje subskrypcji.
Od tokena do pierwszej wliczonej wysyłki.
Na swoim serwerze zamień SEU_TOKEN na poświadczenie, a numer na uprawnionego odbiorcę do testu. Używaj unikalnego klucza dla każdego wysłania i ponownie używaj tego samego klucza tylko przy powtarzaniu tego samego żądania.
Sprawdź status HTTP i treść odpowiedzi. Dla 401 sprawdź token i jego ważność; dla 403 zweryfikuj zakresy (scopes) i warunki konta. Dla 409 sprawdź, czy klucz nie został już użyty z inną treścią. Dla 429 respektuj Retry-After przed ponowną próbą.
Następnie sprawdź GET /messages z messages:read lub monitoruj skonfigurowane webhooks. Potwierdzenie dostarczenia zależy od odpowiedzi kanału.
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, multimedia, historia i śledzenie wysyłek.
Użyj endpointów REST, aby zintegrować WhatsApp z Twoją aplikacją. API WPP Marketing używa połączenia skonfigurowanego w koncie; aby korzystać z Official WhatsApp API, skonfiguruj to połączenie w panelu. Zobacz OpenAPI, aby poznać formaty, zakresy (scopes), limity i odpowiedzi każdej operacji.
POST
/send-text
Wysyła wiadomość tekstową na numer WhatsApp.
Texto
POST
/send-media
Wyślij obraz, audio, wideo lub dokument przez publiczny adres URL HTTPS, zgodnie z formatem i warunkami połączenia. Audio korzysta z tego samego endpointu.
Mídia
GET
/messages
Sprawdź historię wysłanych wiadomości ze statusem i paginacją.
Histórico
GET
/webhooks
Sprawdź dostarczenia webhooków według zdarzenia, wyniku HTTP, prób i paginacji.
Webhooks
DOC
Swagger / OpenAPI
Interaktywna dokumentacja z kontraktami, przykładami, polami obowiązkowymi i oczekiwanymi odpowiedziami.
Docs
Separacja techniczna
Wybierz właściwą funkcję dla każdego etapu integracji.
Wysyłaj wiadomości za pomocą Messaging API, uruchamiaj automatyzacje biznesowe przez Events API i odbieraj powiadomienia zwrotne przez webhooks. Twoja aplikacja może łączyć te funkcje zgodnie z wymaganym przepływem.
Oficjalne połączenie to kanał komunikacji; WPP Marketing API to interfejs używany przez Twój system. Zobacz wymagania na Oficjalne API WhatsApp i współistnienie.
Twój system wywołuje WPP Marketing, aby wysyłać wiadomości tekstowe lub multimedialne oraz aby zapytywać historię wiadomości i dostawy webhooków.
Twój system wysyła zdarzenia handlowe, takie jak utworzenie zamówienia, zatwierdzenie płatności, wysyłka lub porzucony koszyk.
Zrozum dostępne zdarzenia i automatyzacjeWPP Marketing wysyła znormalizowane zdarzenia tworzenia, dostarczenia, odczytu i błędu do podanego przez Ciebie URL.
Zobacz zdarzenia zwrotu i śledzenie dostawUżyj interaktywnej dokumentacji, aby zweryfikować payloady, uwierzytelnianie i odpowiedzi przed wdrożeniem do produkcji.
Tokeny powinny pozostawać na backendzie. Nie ujawniaj poświadczeń na stronach publicznych, w aplikacjach front-end ani w repozytoriach.
W /send-text i /send-media Idempotency-Key umożliwia powtórzenie tego samego żądania z powodzeniem przez okres do 48 godzin. Ponowne użycie klucza z inną treścią zwraca 409. Bez klucza ponowne wywołanie może spowodować zdublowanie wysyłki. Przestrzegaj nagłówków RateLimit i Retry-After; limity żądań różnią się od przydziału planu.
Jedne poświadczenie na integrację, z niezbędnymi uprawnieniami.
W panelu nadaj nazwę tokenowi, wybierz zakresy (scopes) i ustaw opcjonalny termin wygaśnięcia. Pełny token jest wyświetlany tylko raz podczas tworzenia. Na liście możesz sprawdzić ostatnie użycie, datę wygaśnięcia i w razie potrzeby odwołać dostęp.
Podczas rotacji poświadczenia zaktualizuj sekret na swoim serwerze i unieważnij poprzednie. Nigdy nie używaj tokena dostawcy WhatsApp zamiast poświadczenia API.
Pozwala wysyłać tekst i media. Przyznawaj tylko integracjom, które muszą inicjować wysyłki.
Umożliwiają kolejno przeglądanie historii wiadomości i dostaw webhooków. Poświadczenie wysyłkowe nie otrzymuje tych uprawnień automatycznie.
Umożliwia przekazywanie klientów, koszyków i zamówień przez Events API do automatyzacji skonfigurowanych w koncie.
Sprawdza zapisane ustawienia, automatyzacje, zliczenia i ostatnie logi w celach diagnostycznych. Może zawierać dane osobowe i treść wiadomości: udzielaj dostępu tylko autoryzowanym integracjom i wsparciu. To zapytanie nie sprawdza na żywo połączenia z dostawcą.
MCP i oficjalne API WhatsApp.
Podłącz narzędzia AI do swojej operacji WhatsApp za pomocą MCP od WPP Marketing. Zintegruj WhatsApp z przepływami pracy swoich asystentów i agentów, używając Official API jako połączenia do wiadomości.
MCP łączy workflowy Twoich agentów z integracją; messaging API wykonuje wysyłki, a oficjalne połączenie przestrzega zasad WhatsApp. To nie przekształca MCP w natywny chatbot ani nie zastępuje konfiguracji konta. Zespół prowadzi w kwestii działań i wymagań integracji dla Twojego przypadku użycia.
Użyj MCP jako ścieżki integracji między narzędziami AI a WhatsApp, uzupełniając przepływy w Twoich systemach i zespole.
Porozmawiaj z naszym zespołem o narzędziu AI, którego używasz, oraz o działaniach, które chcesz połączyć z WhatsApp. Sprawdź wymagania i odpowiedni zakres dla Twojej operacji.
Opowiedz o integracji MCPGotowy, aby zintegrować swój system z WPP Marketing?
Otwórz Swagger, aby sprawdzić endpoints Messaging API, przykłady payload, uwierzytelnianie bearer token i oczekiwane odpowiedzi. W przypadku zdarzeń sklepu i informacji zwrotnej o dostawie zobacz także Events API i Webhooks de status.