Hver samtale og hvert opkald arkiveres under en kunde, den samme person på alle dine kanaler. Kunder slås kun sammen på oplysninger, ingen kan forfalske, som nummeret de ringer fra, eller det ID dit websted signerer for en logget ind besøgende; en e-mail eller et telefonnummer, nogen selv skriver, gemmes på profilen, og dit team slår kunder sammen i dashboardet. Dine systemer kan læse kundebiblioteket, holde det opdateret og tilføje det, der sker uden for EvaSay.
| Metode | Sti | Hvad den gør |
|---|---|---|
| GET | /api/v1/voice/contacts | Kunder, de senest sete først: q søger i navne, e-mails, telefonnumre, firmaer og tags, segment_id beholder én gruppes, limit (op til 100) og offset bladrer |
| GET | /api/v1/voice/contacts/{id} | Én kunde med oplysninger, tags, samtykke og dine egne felter |
| PATCH | /api/v1/voice/contacts/{id} | Ændr name, email, phone, company, city, country, language, timezone, tags eller attributes |
| GET | /api/v1/voice/contact-fields | Dine egne kundefelter: 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 | Tilføj en hændelse fra dine egne systemer |
| GET | /api/v1/voice/contacts/{id}/consent | Hver ændring af samtykke, med hvor den kom fra og dens dokumentation |
| POST | /api/v1/voice/contacts/{id}/consent | Registrer en ændring af samtykke |
| GET | /api/v1/voice/segments | Kundegrupper; counts=true tilføjer, hvor mange kunder hver har nu |
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 tags. attributes tager nøglerne til dine egne felter (tilføj dem på siden Kunder; GET /api/v1/voice/contact-fields viser dem) med en værdi af feltets type; en tom streng rydder en. En værdi, dit team har skrevet i dashboardet, bevares: API’et overskriver den ikke, og det gør agenten heller ikke. En ændret e-mail eller et ændret telefonnummer slår ikke kunden sammen med en anden, der har det. Standardoplysningerne (name, email, phone og resten) erstattes, som du sender dem.
Send det, der sker i dine egne systemer, som et køb, et besøg 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 bruger små bogstaver, cifre, _ og .. event_id er dit eget ID: det samme event_id på den samme kunde registreres én gang, så det er sikkert at prøve igen, og accepted er false ved en gentagelse. values indeholder tekst, flags true eller false, og appointment_at er et tidspunkt i Unix-millisekunder.
EvaSay holder fire slags samtykke adskilt: marketing_email, marketing_sms, marketing_calls og service_calls (begge slags opkald omfatter opkald med AI-stemme). Hver er granted, withdrawn eller, før der er nogen registrering, unknown. En ændring redigeres aldrig, den føjes kun til historikken med kilde og dokumentation:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Kun nøgler fra ejere og administratorer kan registrere samtykke, og note, din dokumentation, er påkrævet.
Grupper er gemte filtre på kundebiblioteket: dem, alle arbejdsområder har (alle kunder, VIP, nye inden for 7 dage og andre), din branches og dem, du selv laver på siden Kunder. GET /api/v1/voice/segments viser dem med deres id; send det som segment_id for at vise en gruppes kunder.
Dine systemer kan også høre om ændringer, når de sker: contact.created, contact.updated, contact.consent_changed og contact.merged er webhook-hændelser.