כל שיחה וכל שיחת טלפון נשמרות תחת לקוח, אותו אדם בכל הערוצים שלכם. לקוחות מאוחדים רק לפי פרטים שאיש אינו יכול לזייף, כמו המספר שממנו מתקשרים או ה-ID שהאתר שלכם חותם עבור מבקר מחובר; אימייל או טלפון שמישהו מקליד בעצמו נשמרים בפרופיל, והצוות שלכם מאחד לקוחות בלוח הבקרה. המערכות שלכם יכולות לקרוא את מאגר הלקוחות, לשמור אותו מעודכן ולהוסיף את מה שקורה מחוץ ל-EvaSay.
| שיטה | נתיב | מה עושה |
|---|---|---|
| GET | /api/v1/voice/contacts | לקוחות, אלה שנראו לאחרונה קודם: q מחפש בשמות, אימיילים, טלפונים, חברות ותגיות, 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 לא דורס אותו, וגם לא הסוכן. שינוי אימייל או טלפון לא מאחד את הלקוח עם לקוח אחר שיש לו אותם. הפרטים הרגילים (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.