Każda rozmowa i każde połączenie trafia do klienta, tej samej osoby we wszystkich Twoich kanałach. Klienci są łączeni tylko na podstawie danych, których nikt nie podrobi, takich jak numer, z którego dzwonią, albo identyfikator, który Twoja strona podpisuje dla zalogowanego odwiedzającego; e-mail lub numer telefonu wpisany przez kogoś zostaje w profilu, a Twój zespół łączy klientów w panelu. Twoje systemy mogą czytać bazę klientów, aktualizować ją i dodawać to, co dzieje się poza EvaSay.
| Metoda | Ścieżka | Co robi |
|---|---|---|
| GET | /api/v1/voice/contacts | Klienci, ostatnio widziani najpierw: q przeszukuje imiona, e-maile, telefony, firmy i tagi, segment_id zostawia klientów jednej grupy, limit (do 100) i offset stronicują |
| GET | /api/v1/voice/contacts/{id} | Jeden klient z danymi, tagami, zgodami i Twoimi własnymi polami |
| PATCH | /api/v1/voice/contacts/{id} | Zmień name, email, phone, company, city, country, language, timezone, tags lub attributes |
| GET | /api/v1/voice/contact-fields | Twoje własne pola klientów: dla każdego key, label, type i options |
| GET | /api/v1/voice/contacts/{id}/events | Oś czasu klienta, najnowsze najpierw |
| POST | /api/v1/voice/contacts/{id}/events | Dodaj zdarzenie z własnych systemów |
| GET | /api/v1/voice/contacts/{id}/consent | Każda zmiana zgody, ze źródłem i dowodem |
| POST | /api/v1/voice/contacts/{id}/consent | Zapisz zmianę zgody |
| GET | /api/v1/voice/segments | Grupy klientów; counts=true dodaje, ilu klientów ma teraz każda |
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 zastępuje wszystkie tagi klienta. attributes przyjmuje klucze Twoich własnych pól (dodaj je na stronie Klienci; GET /api/v1/voice/contact-fields je wyświetla) z wartością typu pola; pusty ciąg czyści wartość. Wartość wpisana przez Twój zespół w panelu zostaje: API jej nie nadpisuje, agent też nie. Zmiana e-maila lub numeru telefonu nie łączy klienta z innym, który go ma. Dane standardowe (name, email, phone i pozostałe) są zastępowane tak, jak je wysyłasz.
Wysyłaj to, co dzieje się w Twoich systemach, na przykład zakup, wizytę lub odnowienie, aby pojawiło się na osi czasu klienta:
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 składa się z małych liter, cyfr, _ i .. event_id to Twój własny identyfikator: ten sam event_id u tego samego klienta zapisuje się raz, więc ponowienie jest bezpieczne, a przy powtórzeniu accepted ma wartość false. values zawiera tekst, flags true lub false, a appointment_at to czas w milisekundach Unix.
EvaSay rozdziela cztery rodzaje zgód: marketing_email, marketing_sms, marketing_calls i service_calls (oba rodzaje połączeń obejmują połączenia głosem AI). Każda ma stan granted, withdrawn albo, zanim cokolwiek zapisano, unknown. Zmiany nigdy się nie edytuje, tylko dopisuje do historii ze źródłem i dowodem:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Zgody mogą zapisywać tylko klucze właścicieli i administratorów, a note, Twój dowód, jest wymagany.
Grupy to zapisane filtry na bazie klientów: te, które ma każdy obszar roboczy (wszyscy klienci, VIP, nowi z ostatnich 7 dni i inne), grupy Twojej branży i te, które tworzysz na stronie Klienci. GET /api/v1/voice/segments wyświetla je z ich id; przekaż je jako segment_id, aby wyświetlić klientów grupy.
Twoje systemy mogą też od razu dowiadywać się o zmianach: contact.created, contact.updated, contact.consent_changed i contact.merged to zdarzenia webhook.