Varje konversation och varje samtal arkiveras under en kund, samma person i alla dina kanaler. Kunder slås bara ihop på uppgifter som ingen kan förfalska, som numret de ringer från eller det ID din webbplats signerar för en inloggad besökare; en e-postadress eller ett telefonnummer som någon skriver in själv sparas i profilen, och ditt team slår ihop kunder i instrumentpanelen. Dina system kan läsa kundbiblioteket, hålla det uppdaterat och lägga till det som händer utanför EvaSay.
| Metod | Sökväg | Vad den gör |
|---|---|---|
| GET | /api/v1/voice/contacts | Kunder, de senast sedda först: q söker i namn, e-post, telefonnummer, företag och taggar, segment_id behåller en grupps, limit (upp till 100) och offset bläddrar |
| GET | /api/v1/voice/contacts/{id} | En kund med uppgifter, taggar, samtycken och dina egna fält |
| PATCH | /api/v1/voice/contacts/{id} | Ändra name, email, phone, company, city, country, language, timezone, tags eller attributes |
| GET | /api/v1/voice/contact-fields | Dina egna kundfält: för varje key, label, type och options |
| GET | /api/v1/voice/contacts/{id}/events | Kundens tidslinje, de nyaste först |
| POST | /api/v1/voice/contacts/{id}/events | Lägg till en händelse från dina egna system |
| GET | /api/v1/voice/contacts/{id}/consent | Varje ändring av samtycke, med varifrån den kom och dess bevis |
| POST | /api/v1/voice/contacts/{id}/consent | Registrera en ändring av samtycke |
| GET | /api/v1/voice/segments | Kundgrupper; counts=true lägger till hur många kunder varje grupp 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 ersätter alla kundens taggar. attributes tar nycklarna till dina egna fält (lägg till dem på sidan Kunder; GET /api/v1/voice/contact-fields listar dem) med ett värde av fältets typ; en tom sträng rensar ett. Ett värde som ditt team skrev i instrumentpanelen behålls: API:t skriver inte över det, och inte agenten heller. En ändrad e-postadress eller ett ändrat telefonnummer slår inte ihop kunden med en annan som har det. Standarduppgifterna (name, email, phone och resten) ersätts som du skickar dem.
Skicka det som händer i dina egna system, som ett köp, ett besök eller en förnyelse, så att det syns 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 använder små bokstäver, siffror, _ och .. event_id är ditt eget ID: samma event_id på samma kund registreras en gång, så det är säkert att försöka igen, och accepted är false vid en upprepning. values innehåller text, flags true eller false, och appointment_at är en tid i Unix-millisekunder.
EvaSay håller fyra sorters samtycke isär: marketing_email, marketing_sms, marketing_calls och service_calls (båda sorternas samtal omfattar samtal med AI-röst). Varje sort är granted, withdrawn eller, innan något registrerats, unknown. En ändring redigeras aldrig, den läggs bara till i historiken med källa och bevis:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Bara nycklar från ägare och administratörer kan registrera samtycke, och note, ditt bevis, krävs.
Grupper är sparade filter på kundbiblioteket: de som varje arbetsyta har (alla kunder, VIP, nya de senaste 7 dagarna och andra), din branschs och de du skapar själv på sidan Kunder. GET /api/v1/voice/segments listar dem med deras id; skicka det som segment_id för att lista en grupps kunder.
Dina system kan också få veta om ändringar direkt: contact.created, contact.updated, contact.consent_changed och contact.merged är webhook-händelser.