Jedes Gespräch und jeder Anruf wird einem Kunden zugeordnet, derselben Person auf allen Ihren Kanälen. Kunden werden nur über Angaben zusammengeführt, die niemand fälschen kann, etwa die Nummer, von der jemand anruft, oder die ID, die Ihre Website für einen angemeldeten Besucher signiert; eine E-Mail-Adresse oder Telefonnummer, die jemand selbst eintippt, wird im Profil gespeichert, und Ihr Team führt Kunden im Dashboard zusammen. Ihre Systeme können die Kundenbibliothek lesen, aktuell halten und hinzufügen, was außerhalb von EvaSay passiert.
| Methode | Pfad | Was er tut |
|---|---|---|
| GET | /api/v1/voice/contacts | Kunden, zuletzt gesehene zuerst: q durchsucht Namen, E-Mails, Telefonnummern, Firmen und Tags, segment_id zeigt nur die einer Gruppe, limit (bis 100) und offset blättern |
| GET | /api/v1/voice/contacts/{id} | Ein Kunde mit seinen Angaben, Tags, Einwilligungen und Ihren eigenen Feldern |
| PATCH | /api/v1/voice/contacts/{id} | name, email, phone, company, city, country, language, timezone, tags oder attributes ändern |
| GET | /api/v1/voice/contact-fields | Ihre eigenen Kundenfelder: jeweils key, label, type und options |
| GET | /api/v1/voice/contacts/{id}/events | Die Zeitleiste des Kunden, die neuesten zuerst |
| POST | /api/v1/voice/contacts/{id}/events | Ein Ereignis aus Ihren eigenen Systemen hinzufügen |
| GET | /api/v1/voice/contacts/{id}/consent | Jede Änderung einer Einwilligung, mit Herkunft und Nachweis |
| POST | /api/v1/voice/contacts/{id}/consent | Eine Änderung einer Einwilligung erfassen |
| GET | /api/v1/voice/segments | Kundengruppen; counts=true ergänzt, wie viele Kunden jede gerade hat |
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 ersetzt alle Tags des Kunden. attributes nimmt die Schlüssel Ihrer eigenen Felder (auf der Seite Kunden anlegen; GET /api/v1/voice/contact-fields listet sie auf) mit einem Wert vom Typ des Felds; ein leerer String löscht einen Wert. Ein Wert, den Ihr Team im Dashboard eingegeben hat, bleibt erhalten: Die API überschreibt ihn nicht, und der Agent auch nicht. Eine geänderte E-Mail-Adresse oder Telefonnummer führt den Kunden nicht mit einem anderen zusammen, der sie hat. Die Standardangaben (name, email, phone und die übrigen) werden so ersetzt, wie Sie sie senden.
Senden Sie, was in Ihren eigenen Systemen passiert, etwa einen Kauf, einen Besuch oder eine Verlängerung, damit es auf der Zeitleiste des Kunden erscheint:
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 besteht aus Kleinbuchstaben, Ziffern, _ und .. event_id ist Ihre eigene ID: Dieselbe event_id beim selben Kunden wird nur einmal erfasst, Wiederholungen sind also sicher, und accepted ist bei einer Wiederholung false. values enthält Text, flags true oder false, und appointment_at ist ein Zeitpunkt in Unix-Millisekunden.
EvaSay führt vier Arten von Einwilligung getrennt: marketing_email, marketing_sms, marketing_calls und service_calls (beide Anrufarten schließen Anrufe mit KI-Stimme ein). Jede ist granted, withdrawn oder, solange es keinen Eintrag gibt, unknown. Eine Änderung wird nie bearbeitet, sondern nur mit Quelle und Nachweis an den Verlauf angehängt:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Nur Schlüssel von Inhabern und Admins können Einwilligungen erfassen, und note, Ihr Nachweis, ist erforderlich.
Gruppen sind gespeicherte Filter auf der Kundenbibliothek: die, die jeder Arbeitsbereich hat (alle Kunden, VIP, neu in den letzten 7 Tagen und weitere), die Ihrer Branche und die, die Sie auf der Seite Kunden anlegen. GET /api/v1/voice/segments listet sie mit ihrer id auf; übergeben Sie sie als segment_id, um die Kunden einer Gruppe aufzulisten.
Ihre Systeme können auch sofort von Änderungen erfahren: contact.created, contact.updated, contact.consent_changed und contact.merged sind Webhook-Ereignisse.