Jokainen keskustelu ja puhelu tallennetaan asiakkaan alle, samana henkilönä kaikissa kanavissasi. Asiakkaat yhdistetään vain tietojen perusteella, joita kukaan ei voi väärentää, kuten numero, josta he soittavat, tai tunniste, jonka sivustosi allekirjoittaa kirjautuneelle kävijälle; jonkun itse kirjoittama sähköposti tai puhelinnumero tallennetaan profiiliin, ja tiimisi yhdistää asiakkaat hallintapaneelissa. Järjestelmäsi voivat lukea asiakasrekisteriä, pitää sen ajan tasalla ja lisätä sen, mitä EvaSayn ulkopuolella tapahtuu.
| Menetelmä | Polku | Mitä se tekee |
|---|---|---|
| GET | /api/v1/voice/contacts | Asiakkaat, viimeksi nähdyt ensin: q hakee nimistä, sähköposteista, puhelinnumeroista, yrityksistä ja tunnisteista, segment_id rajaa yhden ryhmän asiakkaisiin, limit (enintään 100) ja offset sivuttavat |
| GET | /api/v1/voice/contacts/{id} | Yksi asiakas tietoineen, tunnisteineen, suostumuksineen ja omine kenttinesi |
| PATCH | /api/v1/voice/contacts/{id} | Muuta name, email, phone, company, city, country, language, timezone, tags tai attributes |
| GET | /api/v1/voice/contact-fields | Omat asiakaskenttäsi: kustakin key, label, type ja options |
| GET | /api/v1/voice/contacts/{id}/events | Asiakkaan aikajana, uusimmat ensin |
| POST | /api/v1/voice/contacts/{id}/events | Lisää tapahtuma omista järjestelmistäsi |
| GET | /api/v1/voice/contacts/{id}/consent | Jokainen suostumuksen muutos lähteineen ja todisteineen |
| POST | /api/v1/voice/contacts/{id}/consent | Kirjaa suostumuksen muutos |
| GET | /api/v1/voice/segments | Asiakasryhmät; counts=true lisää, montako asiakasta kussakin on nyt |
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 korvaa kaikki asiakkaan tunnisteet. attributes ottaa omien kenttiesi avaimet (lisää ne sivulla Asiakkaat; GET /api/v1/voice/contact-fields listaa ne) ja kentän tyyppiä olevan arvon; tyhjä merkkijono tyhjentää arvon. Tiimisi hallintapaneelissa syöttämä arvo säilyy: API ei korvaa sitä, eikä myöskään agentti. Muutettu sähköposti tai puhelinnumero ei yhdistä asiakasta toiseen, jolla se on. Vakiotiedot (name, email, phone ja muut) korvataan sellaisinaan kuin ne lähetetään.
Lähetä omissa järjestelmissäsi tapahtuva, kuten osto, käynti tai uusiminen, niin se näkyy asiakkaan aikajanalla:
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 käyttää pieniä kirjaimia, numeroita, _ ja .. event_id on oma tunnisteesi: sama event_id samalla asiakkaalla kirjataan kerran, joten uudelleenyritys on turvallinen, ja accepted on toistossa false. values sisältää tekstiä, flags true tai false, ja appointment_at on aika Unix-millisekunteina.
EvaSay pitää neljä suostumuslajia erillään: marketing_email, marketing_sms, marketing_calls ja service_calls (molemmat puhelulajit kattavat myös tekoälyäänellä soitetut puhelut). Kukin on granted, withdrawn tai, ennen ensimmäistä kirjausta, unknown. Muutosta ei koskaan muokata, se vain lisätään historiaan lähteineen ja todisteineen:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Vain omistajien ja ylläpitäjien avaimet voivat kirjata suostumuksen, ja note, todisteesi, on pakollinen.
Ryhmät ovat asiakasrekisteriin tallennettuja suodattimia: ne, jotka jokaisella työtilalla on (kaikki asiakkaat, VIP, viimeisten 7 päivän uudet ja muut), toimialasi ryhmät ja ne, jotka luot itse sivulla Asiakkaat. GET /api/v1/voice/segments listaa ne ja niiden id:n; anna se segment_id:nä, kun listaat ryhmän asiakkaat.
Järjestelmäsi voivat myös kuulla muutoksista heti: contact.created, contact.updated, contact.consent_changed ja contact.merged ovat webhook-tapahtumia.