Sistemul tău apelează Whatsplaid pentru a valida contul, gestiona contacte, etichete, câmpuri, conversații, coș de cumpărături, mesaje și asistență umană.
API publică și documentație
Conectează sisteme proprii la Whatsplaid cu API, conectori și webhooks.
Folosește API-ul public atunci când un alt sistem trebuie să acționeze asupra Whatsplaid. Folosește conectorul extern când asistentul trebuie să consulte produse, comenzi sau date din sistemul tău în timpul conversației. Folosește webhooks pentru a primi evenimente capturate pe WhatsApp.
Trei contracte
Alege direcția corectă a integrării.
Documentația Swagger separă fluxurile pentru a evita confuzia între apelurile către Whatsplaid, consultările făcute de asistent și evenimentele trimise către sistemul tău.
Whatsplaid apelează sistemul tău pentru a consulta produse, comenzi, clienți sau disponibilitate în timp real în timpul unei conversații.
Whatsplaid trimite evenimente către o URL a ta. Evenimentul disponibil în panou este lead-ul capturat în timpul conversației.
Swagger în `api.whatsplaid.com/docs/` conține schemele, exemplele, răspunsurile așteptate și contractele tehnice complete.
Referință rapidă a principalelor endpoint-uri.
Această vedere rezumă resursele care apar în documentația oficială. Implementarea finală trebuie să urmeze Swagger.
GET
/store
Returnează datele contului, comerțul electronic conectat și modulele active.
Account
GET
/modules
Lista de module active, cum ar fi lead-uri, consultant de vânzări, post-vânzare, bază de cunoștințe și coș de cumpărături.
Account
GET
/ecommerce/products/search
Caută produse în integrațiile native conectate, cum ar fi Nuvemshop, Wix sau Shopify.
Ecommerce
GET
/ecommerce/orders/search
Caută comenzi după număr, e-mail sau telefon în integrațiile native conectate.
Ecommerce
POST
/contacts
Creează sau actualizează contactul folosind telefonul ca cheie principală.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Actualizează câmpurile personalizate pentru segmentare și context operațional.
Fields
POST
/messages/send
Trimite mesaj text în fereastra de asistență de 24 de ore WhatsApp.
Messaging
POST
/handoffs
Solicită asistență umană folosind configurația actuală a companiei.
Handoff
Contracte tehnice
Documentația acoperă API, conector extern și webhooks.
Meniul de integrații al ADMIN folosește aceeași separare: API publică Whatsplaid, conector extern pentru interogări în sisteme proprii și webhook de ieșire pentru lead-uri capturate.
Validează contul, modulele, contactele, etichetele, câmpurile personalizate, mesajele, conversațiile, coșul și asistența umană.
Sistemul tău expune endpoint-uri precum `/products/search` și `/orders/search` pentru ca Whatsplaid să le consulte în timpul conversației.
Rezultatul așteptat cu `products`, incluzând ID, nume, descriere, preț, disponibilitate, stoc, URL și imagine.
Rezultatul așteptat cu `orders`, incluzând număr, stare, plată, livrare, total, client, urmărire și articole.
Evenimentul `LEAD_CAPTURE` trimite datele lead-ului către URL-ul configurat. Endpoint-ul trebuie să răspundă cu HTTP 200 sau 204.
Folosește `Authorization: Bearer` în apeluri. Token-urile nu trebuie expuse în frontend public.
Ai nevoie să implementezi sau să validezi o integrare?
Deschide documentația interactivă pentru a comuta între `Whatsplaid Public API`, `Custom Data Connector Contract` și `Outgoing Webhooks`.