Chaque conversation et chaque appel est classé sous un client, la même personne sur tous vos canaux. Les clients ne sont rapprochés que par des informations que personne ne peut falsifier, comme le numéro depuis lequel ils appellent ou l'identifiant que votre site signe pour un visiteur connecté ; un e-mail ou un numéro de téléphone saisi par quelqu'un est gardé sur la fiche, et votre équipe fusionne les clients dans le tableau de bord. Vos systèmes peuvent lire le fichier clients, le tenir à jour et y ajouter ce qui se passe en dehors d'EvaSay.
| Méthode | Chemin | Ce qu'il fait |
|---|---|---|
| GET | /api/v1/voice/contacts | Les clients, les plus récemment vus en premier : q cherche dans les noms, e-mails, téléphones, entreprises et étiquettes, segment_id garde ceux d'un groupe, limit (jusqu'à 100) et offset paginent |
| GET | /api/v1/voice/contacts/{id} | Un client avec ses coordonnées, étiquettes, consentements et vos propres champs |
| PATCH | /api/v1/voice/contacts/{id} | Modifier name, email, phone, company, city, country, language, timezone, tags ou attributes |
| GET | /api/v1/voice/contact-fields | Vos propres champs clients : pour chacun key, label, type et options |
| GET | /api/v1/voice/contacts/{id}/events | La chronologie du client, la plus récente en premier |
| POST | /api/v1/voice/contacts/{id}/events | Ajouter un événement venant de vos propres systèmes |
| GET | /api/v1/voice/contacts/{id}/consent | Chaque changement de consentement, avec sa provenance et sa preuve |
| POST | /api/v1/voice/contacts/{id}/consent | Enregistrer un changement de consentement |
| GET | /api/v1/voice/segments | Les groupes de clients ; counts=true ajoute combien de clients chacun compte maintenant |
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 remplace toutes les étiquettes du client. attributes prend les clés de vos propres champs (ajoutez-les sur la page Clients ; GET /api/v1/voice/contact-fields les liste) avec une valeur du type du champ ; une chaîne vide en efface une. Une valeur saisie par votre équipe dans le tableau de bord est conservée : l'API ne l'écrase pas, et l'agent non plus. Changer un e-mail ou un numéro de téléphone ne fusionne pas le client avec un autre qui l'a. Les coordonnées standard (name, email, phone et les autres) sont remplacées telles que vous les envoyez.
Envoyez ce qui se passe dans vos propres systèmes, comme un achat, une visite ou un renouvellement, pour qu'il apparaisse dans la chronologie du client :
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 utilise des minuscules, des chiffres, _ et .. event_id est votre propre identifiant : le même event_id sur le même client n'est enregistré qu'une fois, vous pouvez donc réessayer sans risque, et accepted vaut false pour une répétition. values contient du texte, flags true ou false, et appointment_at est une heure en millisecondes Unix.
EvaSay tient quatre types de consentement séparés : marketing_email, marketing_sms, marketing_calls et service_calls (les deux types d'appels incluent les appels avec une voix d'IA). Chacun est granted, withdrawn ou, avant tout enregistrement, unknown. Un changement n'est jamais modifié, seulement ajouté à l'historique avec sa source et sa preuve :
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Seules les clés des propriétaires et des administrateurs peuvent enregistrer un consentement, et note, votre preuve, est obligatoire.
Les groupes sont des filtres enregistrés sur le fichier clients : ceux que tout espace de travail possède (tous les clients, VIP, nouveaux depuis 7 jours et d'autres), ceux de votre secteur et ceux que vous créez sur la page Clients. GET /api/v1/voice/segments les liste avec leur id ; passez-le comme segment_id pour lister les clients d'un groupe.
Vos systèmes peuvent aussi être prévenus des changements au moment où ils arrivent : contact.created, contact.updated, contact.consent_changed et contact.merged sont des événements webhook.