Κάθε συνομιλία και κάθε κλήση αρχειοθετείται κάτω από έναν πελάτη, το ίδιο πρόσωπο σε όλα τα κανάλια σας. Οι πελάτες ενώνονται μόνο με στοιχεία που κανείς δεν μπορεί να πλαστογραφήσει, όπως ο αριθμός από τον οποίο καλούν ή το ID που υπογράφει ο ιστότοπός σας για έναν συνδεδεμένο επισκέπτη· ένα email ή τηλέφωνο που πληκτρολογεί κάποιος μένει στο προφίλ, και η ομάδα σας ενώνει πελάτες στον πίνακα ελέγχου. Τα συστήματά σας μπορούν να διαβάζουν τη βάση πελατών, να την κρατούν ενημερωμένη και να προσθέτουν ό,τι συμβαίνει έξω από το EvaSay.
| Μέθοδος | Διαδρομή | Τι κάνει |
|---|---|---|
| GET | /api/v1/voice/contacts | Οι πελάτες, πρώτα όσοι εμφανίστηκαν πιο πρόσφατα: το q αναζητά σε ονόματα, email, τηλέφωνα, εταιρείες και ετικέτες, το segment_id κρατά μόνο όσους ανήκουν σε μία ομάδα, τα limit (έως 100) και offset σελιδοποιούν |
| GET | /api/v1/voice/contacts/{id} | Ένας πελάτης με τα στοιχεία, τις ετικέτες, τις συγκαταθέσεις και τα δικά σας πεδία |
| PATCH | /api/v1/voice/contacts/{id} | Αλλάξτε name, email, phone, company, city, country, language, timezone, tags ή attributes |
| GET | /api/v1/voice/contact-fields | Τα δικά σας πεδία πελατών: για το καθένα key, label, type και options |
| GET | /api/v1/voice/contacts/{id}/events | Το χρονολόγιο του πελάτη, πρώτα τα νεότερα |
| POST | /api/v1/voice/contacts/{id}/events | Προσθέστε ένα συμβάν από τα δικά σας συστήματα |
| GET | /api/v1/voice/contacts/{id}/consent | Κάθε αλλαγή συγκατάθεσης, με την προέλευση και την απόδειξή της |
| POST | /api/v1/voice/contacts/{id}/consent | Καταγράψτε μια αλλαγή συγκατάθεσης |
| GET | /api/v1/voice/segments | Ομάδες πελατών· το counts=true προσθέτει πόσους πελάτες έχει τώρα η καθεμία |
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 αντικαθιστά όλες τις ετικέτες του πελάτη. Το attributes δέχεται τα κλειδιά των δικών σας πεδίων (προσθέστε τα στη σελίδα Πελάτες· τα απαριθμεί το GET /api/v1/voice/contact-fields) με τιμή του τύπου του πεδίου· μια κενή συμβολοσειρά σβήνει μία τιμή. Μια τιμή που έγραψε η ομάδα σας στον πίνακα ελέγχου διατηρείται: το API δεν την αντικαθιστά, ούτε ο agent. Η αλλαγή email ή τηλεφώνου δεν ενώνει τον πελάτη με κάποιον άλλο που το έχει. Τα βασικά στοιχεία (name, email, phone και τα υπόλοιπα) αντικαθίστανται όπως τα στέλνετε.
Στείλτε ό,τι συμβαίνει στα δικά σας συστήματα, όπως μια αγορά, μια επίσκεψη ή μια ανανέωση, ώστε να εμφανιστεί στο χρονολόγιο του πελάτη:
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 χρησιμοποιεί πεζά γράμματα, ψηφία, _ και .. Το event_id είναι το δικό σας ID: το ίδιο event_id στον ίδιο πελάτη καταγράφεται μία φορά, οπότε η επανάληψη είναι ασφαλής, και το accepted είναι false σε επανάληψη. Το values περιέχει κείμενο, το flags true ή false, και το appointment_at είναι μια ώρα σε χιλιοστά του δευτερολέπτου Unix.
Το EvaSay κρατά χωριστά τέσσερα είδη συγκατάθεσης: marketing_email, marketing_sms, marketing_calls και service_calls (και τα δύο είδη κλήσεων περιλαμβάνουν κλήσεις με φωνή τεχνητής νοημοσύνης). Το καθένα είναι granted, withdrawn ή, πριν από κάθε καταγραφή, unknown. Μια αλλαγή δεν διορθώνεται ποτέ, μόνο προστίθεται στο ιστορικό με την πηγή και την απόδειξή της:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
Μόνο κλειδιά ιδιοκτητών και διαχειριστών μπορούν να καταγράψουν συγκατάθεση, και το note, η απόδειξή σας, είναι υποχρεωτικό.
Οι ομάδες είναι αποθηκευμένα φίλτρα στη βάση πελατών: όσες έχει κάθε χώρος εργασίας (όλοι οι πελάτες, VIP, νέοι των τελευταίων 7 ημερών και άλλες), του κλάδου σας και όσες φτιάχνετε στη σελίδα Πελάτες. Το GET /api/v1/voice/segments τις απαριθμεί με το id τους· δώστε το ως segment_id για να δείτε τους πελάτες μιας ομάδας.
Τα συστήματά σας μπορούν επίσης να μαθαίνουν τις αλλαγές τη στιγμή που γίνονται: τα contact.created, contact.updated, contact.consent_changed και contact.merged είναι συμβάντα webhook.