Whatsplaid
Plannen
Zoeken op de site
Publieke API en documentatie

Koppel uw systemen aan Whatsplaid met API's, connectors en webhooks.

Gebruik de openbare API wanneer een ander systeem Whatsplaid moet activeren. Gebruik de externe connector wanneer de assistent tijdens het gesprek producten, bestellingen of gegevens uit uw systeem moet opvragen. Gebruik webhooks om gebeurtenissen te ontvangen die op WhatsApp zijn vastgelegd.

Drie contracten

Kies de juiste richting van de integratie.

De Swagger-documentatie scheidt de stromen om verwarring te voorkomen tussen oproepen naar Whatsplaid, query's die door de assistent worden gedaan en gebeurtenissen die naar uw systeem worden verzonden.

01 Public API

Uw systeem roept Whatsplaid aan om accounts te valideren en contacten, tags, velden, gesprekken, winkelwagen, berichten en menselijke ondersteuning te beheren.

02 Custom Data Connector

Whatsplaid roept uw systeem aan om tijdens een gesprek producten, bestellingen, klanten of realtime beschikbaarheid op te vragen.

03 Outgoing Webhooks

Whatsplaid stuurt gebeurtenissen naar een door u opgegeven URL. De gebeurtenis die in het dashboard wordt weergegeven, is de lead die tijdens het gesprek is vastgelegd.

04 Documentatie

De Swagger op `api.whatsplaid.com/docs/` bevat de schema's, voorbeelden, verwachte reacties en volledige technische contracten.

Snelreferentie voor de belangrijkste endpoints.

Deze weergave vat de functies samen die in de officiële documentatie voorkomen. De uiteindelijke implementatie moet voldoen aan Swagger.

GET /store

Geeft accountgegevens, verbonden e-commerce en actieve modules terug.

Account
GET /modules

Lijst met actieve modules, zoals leads, salesconsultant, aftersales, kennisbank en winkelwagen.

Account
GET /ecommerce/products/search

Zoek naar producten in verbonden native integraties, zoals Nuvemshop, Wix of Shopify.

Ecommerce
GET /ecommerce/orders/search

Zoek bestellingen op nummer, e-mail of telefoon in de verbonden native integraties.

Ecommerce
POST /contacts

Maakt of werkt een contact bij met het telefoonnummer als primaire sleutel.

Contacts
PATCH /contacts/{contactId}/custom-fields

Werk aangepaste velden bij voor targeting en operationele context.

Fields
POST /messages/send

Verstuurt een sms-bericht binnen het 24-uurs berichtvenster van WhatsApp.

Messaging
POST /handoffs

Vraag menselijke ondersteuning aan met de huidige configuratie van het bedrijf.

Handoff
Technische contracten

De documentatie behandelt de API, de externe connector en webhooks.

Het integratiemenu van ADMIN hanteert dezelfde scheiding: Whatsplaid Public API, externe connector voor queries in eigen systemen en uitgaande webhook voor vastgelegde leads.

API pública

Valideert account, modules, contacten, tags, aangepaste velden, berichten, gesprekken, winkelwagen en menselijke ondersteuning.

Externe connector

Uw systeem stelt endpoints zoals `/products/search` en `/orders/search` bloot zodat Whatsplaid deze tijdens het gesprek kan raadplegen.

Producten

Verwachte terugkeer met `products`, inclusief ID, naam, omschrijving, prijs, beschikbaarheid, voorraad, URL en afbeelding.

Bestellingen

Verwachte reactie met `orders`, inclusief nummer, status, betaling, verzending, totaal, klant, tracking en items.

Webhooks

Het evenement `LEAD_CAPTURE` stuurt leadgegevens naar de geconfigureerde URL. De endpoint moet reageren met HTTP 200 of 204.

Beveiliging

Gebruik `Authorization: Bearer` bij oproepen. Tokens mogen niet worden blootgesteld in de openbare frontend.

Moet u een integratie implementeren of valideren?

Open de interactieve documentatie om te schakelen tussen `Whatsplaid Public API`, `Custom Data Connector Contract` en `Outgoing Webhooks`.

Open Swagger