POST/api/public/widget/message

Invia un messaggio chat del visitatore al chatbot e restituisce la sua risposta — endpoint centrale del Widget chat.

Autenticazione e sicurezza

Token di incorporamento del widget (header X-Widget-Token) + elenco delle origini consentite

Idempotente: No

Parametri

widget_code(body, string, obbligatorio)
message(body, string, obbligatorio)
visitor_id(body, string, obbligatorio)— ID visitatore persistente generato lato client
session_id(body, string)— null alla prima chiamata di una nuova conversazione

Richiesta di esempio

{"widget_code":"...","message":"Ciao, cosa può fare Zentor App?","visitor_id":"<UUID o ID generata dal client>"}

Risposta di esempio

{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}

Codici di errore

401 WIDGET_TOKEN_MISSING — Header X-Widget-Token mancante.
401 WIDGET_TOKEN_INVALID — Token non valido oppure Origin non presente nella lista di autorizzazione del Widget.
400 VISITOR_ID_REQUIRED — visitor_id mancante.

Prova del test live

Successo (200, vera risposta chatbot generata) e più casi negativi (Token mancante/non valido, visitor_id mancante) verificati live.

← Widget chat