Hver samtale og hvert anrop arkiveres under en kunde, den samme personen på alle kanalene dine. Kunder slås bare sammen på opplysninger ingen kan forfalske, som nummeret de ringer fra, eller ID-en nettstedet ditt signerer for en innlogget besøkende; en e-post eller et telefonnummer noen skriver inn selv, lagres på profilen, og teamet ditt slår sammen kunder i dashbordet. Systemene dine kan lese kundebiblioteket, holde det oppdatert og legge til det som skjer utenfor EvaSay.
| Metode | Sti | Hva den gjør |
|---|---|---|
| GET | /api/v1/voice/contacts | Kunder, de sist sette først: q søker i navn, e-poster, telefonnumre, firmaer og tagger, segment_id beholder én gruppes, limit (opptil 100) og offset blar |
| GET | /api/v1/voice/contacts/{id} | Én kunde med opplysninger, tagger, samtykke og dine egne felt |
| PATCH | /api/v1/voice/contacts/{id} | Endre name, email, phone, company, city, country, language, timezone, tags eller attributes |
| GET | /api/v1/voice/contact-fields | Dine egne kundefelt: for hvert key, label, type og options |
| GET | /api/v1/voice/contacts/{id}/events | Kundens tidslinje, de nyeste først |
| POST | /api/v1/voice/contacts/{id}/events | Legg til en hendelse fra dine egne systemer |
| GET | /api/v1/voice/contacts/{id}/consent | Hver endring av samtykke, med hvor den kom fra og dokumentasjonen |
| POST | /api/v1/voice/contacts/{id}/consent | Registrer en endring av samtykke |
| GET | /api/v1/voice/segments | Kundegrupper; counts=true legger til hvor mange kunder hver har nå |
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 erstatter alle kundens tagger. attributes tar nøklene til dine egne felt (legg dem til på siden Kunder; GET /api/v1/voice/contact-fields viser dem) med en verdi av feltets type; en tom streng tømmer en. En verdi teamet ditt har skrevet i dashbordet, beholdes: API-et overskriver den ikke, og det gjør heller ikke agenten. En endret e-post eller et endret telefonnummer slår ikke kunden sammen med en annen som har det. Standardopplysningene (name, email, phone og resten) erstattes slik du sender dem.
Send det som skjer i dine egne systemer, som et kjøp, et besøk eller en fornyelse, så det vises på kundens tidslinje:
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 bruker små bokstaver, sifre, _ og .. event_id er din egen ID: samme event_id på samme kunde registreres én gang, så det er trygt å prøve på nytt, og accepted er false ved en gjentakelse. values inneholder tekst, flags true eller false, og appointment_at er et tidspunkt i Unix-millisekunder.
EvaSay holder fire typer samtykke atskilt: marketing_email, marketing_sms, marketing_calls og service_calls (begge typene samtaler omfatter samtaler med KI-stemme). Hver er granted, withdrawn eller, før noe er registrert, unknown. En endring redigeres aldri, den legges bare til i historikken med kilde og dokumentasjon:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Bare nøkler fra eiere og administratorer kan registrere samtykke, og note, dokumentasjonen din, er påkrevd.
Grupper er lagrede filtre på kundebiblioteket: de alle arbeidsområder har (alle kunder, VIP, nye siste 7 dager og andre), bransjens og de du lager selv på siden Kunder. GET /api/v1/voice/segments viser dem med id; send den som segment_id for å vise kundene i en gruppe.
Systemene dine kan også få vite om endringer med en gang: contact.created, contact.updated, contact.consent_changed og contact.merged er webhook-hendelser.