Il tuo sistema chiama Whatsplaid per convalidare gli account, gestire contatti, tag, campi, conversazioni, carrello, messaggi e assistenza umana.
API pubblica e documentazione
Collega i tuoi sistemi a Whatsplaid tramite API, connettori e webhook.
Usa l’API pubblica quando un altro sistema deve attivare Whatsplaid. Usa il connettore esterno quando l’assistente deve interrogare prodotti, ordini o dati del tuo sistema durante la conversazione. Usa i webhook per ricevere eventi catturati su WhatsApp.
Tre contratti
Scegli la direzione corretta dell'integrazione.
La documentazione Swagger separa i flussi per evitare confusione tra le chiamate a Whatsplaid, le query effettuate dall'assistente e gli eventi inviati al tuo sistema.
Whatsplaid chiama il tuo sistema per interrogare prodotti, ordini, clienti o la disponibilità in tempo reale durante una conversazione.
Whatsplaid invia eventi a un URL da te fornito. L'evento visualizzato nel pannello è il lead acquisito durante la conversazione.
Lo Swagger su `api.whatsplaid.com/docs/` contiene gli schemi, gli esempi, le risposte previste e i contratti tecnici completi.
Riferimento rapido dei principali endpoint.
Questa vista riassume le funzionalità presenti nella documentazione ufficiale. L’implementazione finale deve seguire lo Swagger.
GET
/store
Restituisce i dati dell'account, l'e-commerce collegato e i moduli attivi.
Account
GET
/modules
Elenco dei moduli attivi, come leads, consulente commerciale, post-vendita, knowledge base e carrello.
Account
GET
/ecommerce/products/search
Cerca prodotti nelle integrazioni native connesse, come Nuvemshop, Wix o Shopify.
Ecommerce
GET
/ecommerce/orders/search
Cerca gli ordini per numero, e-mail o telefono nelle integrazioni native connesse.
Ecommerce
POST
/contacts
Crea o aggiorna un contatto usando il numero di telefono come chiave principale.
Contacts
PATCH
/contacts/{contactId}/custom-fields
Aggiorna i campi personalizzati per il targeting e il contesto operativo.
Fields
POST
/messages/send
Invia un messaggio di testo entro la finestra di assistenza di 24 ore di WhatsApp.
Messaging
POST
/handoffs
Richiedi supporto umano utilizzando la configurazione aziendale attuale.
Handoff
Contratti tecnici
La documentazione copre l’API, il connettore esterno e i webhook.
Il menu delle integrazioni di ADMIN utilizza la stessa suddivisione: API pubblica di Whatsplaid, connettore esterno per interrogazioni nei sistemi proprietari e webhook in uscita per i lead catturati.
Valida account, moduli, contatti, tag, campi personalizzati, messaggi, conversazioni, carrello e assistenza umana.
Il vostro sistema espone endpoint come `/products/search` e `/orders/search` per permettere a Whatsplaid di interrogarli durante la conversazione.
Risultato atteso con `products`, inclusi ID, nome, descrizione, prezzo, disponibilità, giacenza, URL e immagine.
Risposta attesa con `orders`, inclusi numero, stato, pagamento, spedizione, totale, cliente, tracciamento e articoli.
L’evento `LEAD_CAPTURE` invia i dati del lead all’URL configurata. 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 passare tra `Whatsplaid Public API`, `Custom Data Connector Contract` e `Outgoing Webhooks`.