Twój system wywołuje Whatsplaid w celu weryfikacji kont, zarządzania kontaktami, tagami, polami, rozmowami, koszykiem, wiadomościami i wsparciem ludzkim.
Publiczne API i dokumentacja
Połącz swoje systemy z Whatsplaid za pomocą API, konektorów i webhooków.
Użyj publicznego API, gdy inny system musi wywołać Whatsplaid. Użyj zewnętrznego konektora, gdy asystent musi w trakcie rozmowy pobierać informacje o produktach, zamówieniach lub danych z Twojego systemu. Użyj webhooków, aby otrzymywać zdarzenia rejestrowane w WhatsApp.
Trzy umowy
Wybierz poprawny kierunek integracji.
Dokumentacja Swagger rozdziela przepływy, aby uniknąć zamieszania między wywołaniami do Whatsplaid, zapytaniami wykonywanymi przez asystenta a zdarzeniami wysyłanymi do Twojego systemu.
Whatsplaid wywołuje Twój system, aby podczas rozmowy pobierać informacje o produktach, zamówieniach, klientach lub dostępności w czasie rzeczywistym.
Whatsplaid wysyła zdarzenia na wskazany przez Ciebie adres URL. Zdarzeniem dostępnym na pulpicie jest lead przechwycony podczas rozmowy.
Swagger pod adresem `api.whatsplaid.com/docs/` zawiera schematy, przykłady, oczekiwane odpowiedzi oraz pełne kontrakty techniczne.
Szybkie odniesienie do głównych endpointów.
Widok ten podsumowuje funkcje, które pojawiają się w oficjalnej dokumentacji. Końcowa implementacja musi być zgodna ze Swagger.
GET
/store
Zwraca dane konta, podłączony e-commerce i aktywne moduły.
Account
GET
/modules
Lista aktywnych modułów, takich jak leady, konsultant sprzedaży, obsługa posprzedażowa, baza wiedzy i koszyk.
Account
GET
/ecommerce/products/search
Wyszukaj produkty w podłączonych natywnych integracjach, takich jak Nuvemshop, Wix lub Shopify.
Ecommerce
GET
/ecommerce/orders/search
Wyszukaj zamówienia według numeru, e-maila lub telefonu w podłączonych natywnych integracjach.
Ecommerce
POST
/contacts
Tworzy lub aktualizuje kontakt, używając numeru telefonu jako klucza głównego.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Aktualizuje pola niestandardowe dla targetowania i kontekstu operacyjnego.
Fields
POST
/messages/send
Wysyła wiadomość tekstową w ramach 24‑godzinnego okna wiadomości WhatsApp.
Messaging
POST
/handoffs
Zgłoś prośbę o obsługę przez człowieka, korzystając z bieżącej konfiguracji firmy.
Handoff
Kontrakty techniczne
Dokumentacja obejmuje API, zewnętrzny konektor i webhooki.
Menu integracji w ADMIN używa tego samego podziału: Whatsplaid Public API, zewnętrzny konektor do zapytań w systemach własnych oraz wychodzący webhook dla przechwyconych leadów.
Weryfikuje konto, moduły, kontakty, tagi, pola niestandardowe, wiadomości, konwersacje, koszyk oraz obsługę przez człowieka.
Twój system udostępnia endpointy takie jak `/products/search` i `/orders/search`, które Whatsplaid może zapytywać podczas rozmowy.
Oczekiwany zwrot z `products`, zawierający ID, nazwę, opis, cenę, dostępność, stan magazynowy, URL i obraz.
Oczekiwana odpowiedź z `orders`, zawierająca numer, status, płatność, wysyłkę, sumę, klienta, śledzenie i pozycje.
Zdarzenie `LEAD_CAPTURE` wysyła dane leada na skonfigurowany adres URL. Punkt końcowy musi odpowiedzieć kodem HTTP 200 lub 204.
Używaj `Authorization: Bearer` w wywołaniach. Tokeny nie mogą być ujawniane w publicznym frontendzie.
Czy potrzebujesz wdrożyć lub zweryfikować integrację?
Otwórz interaktywną dokumentację, aby przełączać się między `Whatsplaid Public API`, `Custom Data Connector Contract` i `Outgoing Webhooks`.