Elk gesprek en elk telefoontje wordt onder een klant opgeslagen, dezelfde persoon op al je kanalen. Klanten worden alleen samengevoegd op gegevens die niemand kan vervalsen, zoals het nummer waarvandaan iemand belt of de ID die je site ondertekent voor een ingelogde bezoeker; een e-mailadres of telefoonnummer dat iemand zelf intypt, blijft op het profiel staan, en je team voegt klanten samen in het dashboard. Je systemen kunnen het klantenbestand lezen, bijhouden en toevoegen wat er buiten EvaSay gebeurt.
| Methode | Pad | Wat het doet |
|---|---|---|
| GET | /api/v1/voice/contacts | Klanten, de laatst geziene eerst: q zoekt in namen, e-mails, telefoonnummers, bedrijven en tags, segment_id houdt alleen die van één groep over, limit (tot 100) en offset bladeren |
| GET | /api/v1/voice/contacts/{id} | Eén klant met gegevens, tags, toestemmingen en je eigen velden |
| PATCH | /api/v1/voice/contacts/{id} | name, email, phone, company, city, country, language, timezone, tags of attributes wijzigen |
| GET | /api/v1/voice/contact-fields | Je eigen klantvelden: van elk key, label, type en options |
| GET | /api/v1/voice/contacts/{id}/events | De tijdlijn van de klant, de nieuwste eerst |
| POST | /api/v1/voice/contacts/{id}/events | Een gebeurtenis uit je eigen systemen toevoegen |
| GET | /api/v1/voice/contacts/{id}/consent | Elke wijziging van een toestemming, met herkomst en bewijs |
| POST | /api/v1/voice/contacts/{id}/consent | Een wijziging van een toestemming vastleggen |
| GET | /api/v1/voice/segments | Klantgroepen; counts=true voegt toe hoeveel klanten elke groep nu heeft |
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 vervangt alle tags van de klant. attributes neemt de sleutels van je eigen velden (voeg ze toe op de pagina Klanten; GET /api/v1/voice/contact-fields geeft ze) met een waarde van het type van het veld; een lege string wist er een. Een waarde die je team in het dashboard invulde, blijft staan: de API overschrijft hem niet, en de agent ook niet. Een gewijzigd e-mailadres of telefoonnummer voegt de klant niet samen met een andere klant die het heeft. De standaardgegevens (name, email, phone en de rest) worden vervangen zoals je ze stuurt.
Stuur wat er in je eigen systemen gebeurt, zoals een aankoop, een bezoek of een verlenging, zodat het op de tijdlijn van de klant verschijnt:
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 gebruikt kleine letters, cijfers, _ en .. event_id is je eigen ID: dezelfde event_id bij dezelfde klant wordt één keer vastgelegd, dus opnieuw proberen is veilig, en accepted is false bij een herhaling. values bevat tekst, flags true of false, en appointment_at is een tijdstip in Unix-milliseconden.
EvaSay houdt vier soorten toestemming apart: marketing_email, marketing_sms, marketing_calls en service_calls (beide soorten gesprekken omvatten gesprekken met een AI-stem). Elke soort is granted, withdrawn of, zolang er niets is vastgelegd, unknown. Een wijziging wordt nooit aangepast, alleen met bron en bewijs aan de geschiedenis toegevoegd:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Alleen sleutels van eigenaren en beheerders kunnen toestemming vastleggen, en note, je bewijs, is verplicht.
Groepen zijn opgeslagen filters op het klantenbestand: de groepen die elke werkruimte heeft (alle klanten, VIP, nieuw in de laatste 7 dagen en andere), die van je branche en de groepen die je zelf maakt op de pagina Klanten. GET /api/v1/voice/segments geeft ze met hun id; geef die mee als segment_id om de klanten van een groep op te vragen.
Je systemen kunnen ook direct van wijzigingen horen: contact.created, contact.updated, contact.consent_changed en contact.merged zijn webhook-gebeurtenissen.