Sistemul dvs. apelează Whatsplaid pentru a valida conturi, a gestiona contacte, etichete, câmpuri, conversații, coș, mesaje și suport uman.
API publică și documentație
Conectați sistemele dvs. la Whatsplaid prin API-uri, conectori și webhook-uri.
Folosiți API-ul public atunci când un alt sistem trebuie să declanșeze Whatsplaid. Folosiți conectorul extern atunci când asistentul trebuie să interogheze produse, comenzi sau date din sistemul dvs. în timpul conversației. Folosiți 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, interogările realizate de asistent și evenimentele trimise către sistemul dumneavoastră.
Whatsplaid apelează sistemul dvs. pentru a consulta produse, comenzi, clienți sau disponibilitatea în timp real în timpul unei conversații.
Whatsplaid trimite evenimente către un URL pe care îl furnizați. Evenimentul afișat în panou este lead-ul capturat în timpul conversației.
Swagger la `api.whatsplaid.com/docs/` conține schemele, exemplele, răspunsurile așteptate și contractele tehnice complete.
Referință rapidă pentru principalele endpoint-uri.
Această vizualizare rezumă funcționalitățile 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
Listă cu module active, precum leads, consultant de vânzări, post-vânzare, bază de cunoștințe și coș.
Account
GET
/ecommerce/products/search
Caută produse în integrările native conectate, precum 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ă un contact folosind numărul de telefon ca cheie principală.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Actualizează câmpurile personalizate pentru targetare și contextul operațional.
Fields
POST
/messages/send
Trimite un mesaj text în cadrul ferestrei de mesagerie de 24 de ore a WhatsApp.
Messaging
POST
/handoffs
Solicită asistență umană folosind configurația curentă a companiei.
Handoff
Contracte tehnice
Documentația acoperă API-ul, conectorul extern și webhooks.
Meniul de integrări din ADMIN folosește aceeași separare: Whatsplaid Public API, conector extern pentru interogări în sistemele proprii și webhook de ieșire pentru lead-urile capturate.
Validează contul, modulele, contactele, etichetele, câmpurile personalizate, mesajele, conversațiile, coșul și suportul uman.
Sistemul dvs. expune endpointuri precum `/products/search` și `/orders/search` pentru ca Whatsplaid să le interogheze în timpul conversației.
Returnare așteptată cu `products`, incluzând ID, nume, descriere, preț, disponibilitate, stoc, URL și imagine.
Răspunsul 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.
Utilizați `Authorization: Bearer` în apeluri. Tokenurile nu trebuie expuse în frontend-ul public.
Aveți nevoie să implementați sau să validați o integrare?
Deschide documentația interactivă pentru a comuta între `Whatsplaid Public API`, `Custom Data Connector Contract` și `Outgoing Webhooks`.