Il tuo sistema chiama Whatsplaid per convalidare l'account, gestire contatti, tag, campi, conversazioni, carrello, messaggi e assistenza umana.
API pubblica e documentazione
Collega i tuoi sistemi a Whatsplaid con API, connettori e webhook.
Usa l'API pubblica quando un altro sistema deve attivare Whatsplaid. Usa il connettore esterno quando l'assistente deve consultare prodotti, ordini o dati del tuo sistema durante la conversazione. Usa i webhook per ricevere eventi catturati su WhatsApp.
Tre contratti
Scegli il senso corretto dell'integrazione.
La documentazione Swagger separa i flussi per evitare confusione tra chiamate a Whatsplaid, consultazioni fatte dall'assistente ed eventi inviati al tuo sistema.
Whatsplaid chiama il tuo sistema per consultare prodotti, ordini, clienti o disponibilità in tempo reale durante una conversazione.
Whatsplaid invia eventi a un tuo URL. L'evento disponibile nel pannello è il lead catturato durante la conversazione.
Lo Swagger in `api.whatsplaid.com/docs/` contiene gli schemi, esempi, risposte attese e contratti tecnici completi.
Riferimento rapido dei principali endpoint.
Questa vista riassume le risorse presenti nella documentazione ufficiale. La implementazione finale deve seguire lo Swagger.
GET
/store
Restituisce dati dell'account, e-commerce collegato e moduli attivi.
Account
GET
/modules
Elenco moduli attivi, come lead, consulente di vendita, post-vendita, base di conoscenza e carrello.
Account
GET
/ecommerce/products/search
Cerca prodotti nelle integrazioni native connesse, come Nuvemshop, Wix o Shopify.
Ecommerce
GET
/ecommerce/orders/search
Cerca ordini per numero, email o telefono nelle integrazioni native connesse.
Ecommerce
POST
/contacts
Crea o aggiorna contatto usando il telefono come chiave principale.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Aggiorna campi personalizzati per segmentazione e contesto operativo.
Fields
POST
/messages/send
Invia messaggio di testo all'interno della finestra di assistenza di 24 ore di WhatsApp.
Messaging
POST
/handoffs
Richiedi assistenza umana usando la configurazione attuale dell'azienda.
Handoff
Contratti tecnici
La documentazione copre API, connettore esterno e webhook.
Il menu di integrazioni dell'ADMIN utilizza la stessa separazione: API pubblica di Whatsplaid, connettore esterno per query nei sistemi propri e webhook di uscita per lead catturati.
Convalida account, moduli, contatti, tag, campi personalizzati, messaggi, conversazioni, carrello e assistenza umana.
Il tuo sistema espone endpoint come `/products/search` e `/orders/search` per consultare Whatsplaid durante la conversazione.
Risposta attesa con `products`, inclusi ID, nome, descrizione, prezzo, disponibilità, stock, URL e immagine.
Risposta attesa con `orders`, inclusi numero, stato, pagamento, consegna, totale, cliente, tracciamento e articoli.
L'evento `LEAD_CAPTURE` invia i dati del lead all'URL configurato. L'endpoint deve rispondere con HTTP 200 o 204.
Usa `Authorization: Bearer` nelle chiamate. I token non devono essere esposti nel frontend pubblico.
Devi implementare o convalidare un'integrazione?
Apri la documentazione interattiva per alternare tra `Whatsplaid Public API`, `Custom Data Connector Contract` e `Outgoing Webhooks`.