Ogni conversazione e ogni chiamata viene archiviata sotto un cliente, la stessa persona su tutti i tuoi canali. I clienti vengono uniti solo in base a dati che nessuno può falsificare, come il numero da cui chiamano o l'ID che il tuo sito firma per un visitatore che ha effettuato l'accesso; un'email o un numero di telefono digitato da qualcuno resta nella scheda, e il tuo team unisce i clienti nella dashboard. I tuoi sistemi possono leggere l'archivio clienti, tenerlo aggiornato e aggiungere ciò che succede fuori da EvaSay.
| Metodo | Percorso | Cosa fa |
|---|---|---|
| GET | /api/v1/voice/contacts | I clienti, i visti più di recente per primi: q cerca in nomi, email, telefoni, aziende e tag, segment_id tiene solo quelli di un gruppo, limit (fino a 100) e offset paginano |
| GET | /api/v1/voice/contacts/{id} | Un cliente con i suoi dati, tag, consensi e i tuoi campi personalizzati |
| PATCH | /api/v1/voice/contacts/{id} | Modifica name, email, phone, company, city, country, language, timezone, tags o attributes |
| GET | /api/v1/voice/contact-fields | I tuoi campi cliente: per ognuno key, label, type e options |
| GET | /api/v1/voice/contacts/{id}/events | La cronologia del cliente, i più recenti per primi |
| POST | /api/v1/voice/contacts/{id}/events | Aggiungi un evento dai tuoi sistemi |
| GET | /api/v1/voice/contacts/{id}/consent | Ogni modifica di un consenso, con la sua provenienza e la sua prova |
| POST | /api/v1/voice/contacts/{id}/consent | Registra una modifica di un consenso |
| GET | /api/v1/voice/segments | I gruppi di clienti; counts=true aggiunge quanti clienti ha ognuno adesso |
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID \
-X PATCH \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "company": "Acme Dental", "tags": ["vip"], "attributes": { "plan": "Gold" } }'
tags sostituisce tutti i tag del cliente. attributes accetta le chiavi dei tuoi campi (aggiungili nella pagina Clienti; GET /api/v1/voice/contact-fields li elenca) con un valore del tipo del campo; una stringa vuota ne cancella uno. Un valore inserito dal tuo team nella dashboard viene mantenuto: l'API non lo sovrascrive, e nemmeno l'agente. Cambiare un'email o un numero di telefono non unisce il cliente a un altro che li ha. I dati standard (name, email, phone e gli altri) vengono sostituiti così come li invii.
Invia ciò che succede nei tuoi sistemi, come un acquisto, una visita o un rinnovo, perché compaia nella cronologia del cliente:
curl https://evasay.com/api/v1/voice/contacts/CONTACT_ID/events \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "event_id": "order-1042", "name": "order_paid", "subject": "Order 1042", "values": { "total": "89.00" } }'
name usa lettere minuscole, cifre, _ e .. event_id è il tuo ID: lo stesso event_id sullo stesso cliente viene registrato una sola volta, quindi riprovare è sicuro, e accepted è false per una ripetizione. values contiene testo, flags true o false, e appointment_at è un orario in millisecondi Unix.
EvaSay tiene separati quattro tipi di consenso: marketing_email, marketing_sms, marketing_calls e service_calls (i due tipi di chiamata includono le chiamate con voce IA). Ognuno è granted, withdrawn oppure, prima di qualsiasi registrazione, unknown. Una modifica non viene mai corretta, solo aggiunta allo storico con la sua fonte e la sua prova:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Solo le chiavi di proprietari e amministratori possono registrare un consenso, e note, la tua prova, è obbligatoria.
I gruppi sono filtri salvati sull'archivio clienti: quelli che ha ogni workspace (tutti i clienti, VIP, nuovi negli ultimi 7 giorni e altri), quelli del tuo settore e quelli che crei nella pagina Clienti. GET /api/v1/voice/segments li elenca con il loro id; passalo come segment_id per elencare i clienti di un gruppo.
I tuoi sistemi possono anche sapere dei cambiamenti appena avvengono: contact.created, contact.updated, contact.consent_changed e contact.merged sono eventi webhook.