Minden beszélgetés és hívás egy ügyfélhez kerül, aki minden csatornán ugyanaz a személy. Az ügyfeleket csak olyan adatok alapján vonjuk össze, amelyeket senki sem hamisíthat meg, például a hívó szám vagy az az azonosító, amelyet webhelye egy bejelentkezett látogatónak aláír; a valaki által begépelt e-mail-cím vagy telefonszám a profilon marad, az ügyfeleket pedig csapata vonja össze az irányítópulton. Rendszerei olvashatják az ügyféltárat, naprakészen tarthatják, és hozzáadhatják, ami az EvaSay-en kívül történik.
| Metódus | Útvonal | Mit csinál |
|---|---|---|
| GET | /api/v1/voice/contacts | Ügyfelek, a legutóbb látottak elöl: a q nevekben, e-mailekben, telefonszámokban, cégekben és címkékben keres, a segment_id csak egy csoportéit hagyja meg, a limit (legfeljebb 100) és az offset lapoz |
| GET | /api/v1/voice/contacts/{id} | Egy ügyfél adataival, címkéivel, hozzájárulásaival és saját mezőivel |
| PATCH | /api/v1/voice/contacts/{id} | name, email, phone, company, city, country, language, timezone, tags vagy attributes módosítása |
| GET | /api/v1/voice/contact-fields | Saját ügyfélmezői: mindegyiknek a key, label, type és options értéke |
| GET | /api/v1/voice/contacts/{id}/events | Az ügyfél idővonala, a legújabbak elöl |
| POST | /api/v1/voice/contacts/{id}/events | Esemény hozzáadása saját rendszereiből |
| GET | /api/v1/voice/contacts/{id}/consent | A hozzájárulás minden változása, forrással és bizonyítékkal |
| POST | /api/v1/voice/contacts/{id}/consent | A hozzájárulás változásának rögzítése |
| GET | /api/v1/voice/segments | Ügyfélcsoportok; a counts=true hozzáadja, hány ügyfél van most mindegyikben |
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" } }'
A tags az ügyfél összes címkéjét lecseréli. Az attributes saját mezőinek kulcsait fogadja (vegye fel őket az Ügyfelek oldalon; a GET /api/v1/voice/contact-fields listázza őket) a mező típusának megfelelő értékkel; az üres karakterlánc törli az értéket. A csapata által az irányítópulton beírt érték megmarad: az API nem írja felül, és az ügynök sem. Az e-mail-cím vagy telefonszám módosítása nem vonja össze az ügyfelet egy másikkal, akinél ugyanez szerepel. A szabványos adatok (name, email, phone és a többi) úgy cserélődnek, ahogy elküldi őket.
Küldje el, ami saját rendszereiben történik, például egy vásárlást, egy látogatást vagy egy megújítást, hogy megjelenjen az ügyfél idővonalán:
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" } }'
A name kisbetűkből, számjegyekből, _ és . karakterekből áll. Az event_id az Ön saját azonosítója: ugyanaz az event_id ugyanannál az ügyfélnél egyszer rögzül, így az újrapróbálás biztonságos, ismétlésnél pedig az accepted értéke false. A values szöveget tartalmaz, a flags true vagy false értéket, az appointment_at pedig egy időpont Unix-ezredmásodpercben.
Az EvaSay négyféle hozzájárulást tart külön: marketing_email, marketing_sms, marketing_calls és service_calls (mindkét hívástípus az MI-hangú hívásokat is magában foglalja). Mindegyik granted, withdrawn vagy, amíg nincs bejegyzés, unknown. Egy változást sosem szerkesztünk, csak forrással és bizonyítékkal hozzáfűzzük az előzményekhez:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Hozzájárulást csak tulajdonosok és adminisztrátorok kulcsai rögzíthetnek, és a note, vagyis az Ön bizonyítéka, kötelező.
A csoportok az ügyféltárra mentett szűrők: azok, amelyek minden munkaterületen megvannak (minden ügyfél, VIP, az utóbbi 7 nap újai és mások), az Ön iparágáé és azok, amelyeket az Ügyfelek oldalon hoz létre. A GET /api/v1/voice/segments listázza őket az id értékükkel; adja meg segment_id-ként, ha egy csoport ügyfeleit listázza.
Rendszerei a változásokról azonnal is értesülhetnek: a contact.created, contact.updated, contact.consent_changed és contact.merged webhook-események.