Profili clienti e ticket
Consulta e sincronizza i profili dei clienti e crea ticket dal tuo sistema.
4.4 Scheda cliente
Le conversazioni dello stesso cliente confluiscono in un'unica scheda cliente, a cui punta il contact_id della conversazione. Regole di identificazione: l'ID membro firmato da te (user_token o user.id passato via API) > utente del canale (ad esempio openid di WeChat) > visitatore del sito. Il visitatore anonimo, dopo l'accesso, viene unito alla scheda del membro; due membri diversi non vengono mai uniti automaticamente: se email o telefono coincidono, il backend mostra solo un avviso e l'unione viene fatta manualmente dall'operatore.
| Metodo | Percorso | Descrizione |
|---|---|---|
| GET | /v1/contacts?user_id= oppure ?email= | Cerca la scheda cliente per ID membro o email |
| GET | /v1/contacts/{id} | Scheda cliente: nome, email, telefono, tag tags, note notes, campi personalizzati attributes, numero di conversazioni, ultima visita, ID membro user_ids |
| PATCH | /v1/contacts/{id} | Sincronizza i dati dal tuo sistema: name, phone, tags (massimo 30), notes, attributes (sostituzione completa, massimo 30 campi). Invia solo i campi da modificare |
4.5 Ticket
| Metodo | Percorso | Descrizione |
|---|---|---|
| POST | /v1/tickets | Crea un ticket, ad esempio dal modulo «Contattaci» del sito: subject, description, priority (urgent / high / normal / low), name / email / phone del cliente, con eventuale collegamento a conversation_id o contact_id. Se è presente un'email, le risposte dell'operatore vengono inviate al cliente via email |
| GET | /v1/tickets/{id} | Ticket e timeline (messaggi del cliente, risposte dell'operatore, cambi di stato; escluse le note interne) |
Stati del ticket: open in attesa di gestione, pending in attesa del cliente, resolved risolto, closed chiuso. I tempi di gestione per priorità si impostano in «Impostazioni del bot».
Questa pagina ti è stata utile?
Ultimo aggiornamento:
