تُحفظ كل محادثة وكل مكالمة تحت عميل، وهو الشخص نفسه على جميع قنواتك. لا يُدمج العملاء إلا بمعلومات لا يمكن لأحد تزويرها، مثل الرقم الذي يتصلون منه أو المعرّف الذي يوقّعه موقعك لزائر سجّل دخوله؛ أما البريد الإلكتروني أو رقم الهاتف الذي يكتبه أحدهم بنفسه فيُحفظ في الملف، ويدمج فريقك العملاء من لوحة التحكم. يمكن لأنظمتك قراءة مكتبة العملاء وإبقاؤها محدّثة وإضافة ما يحدث خارج 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) بقيمة من نوع الحقل؛ والسلسلة الفارغة تمسح القيمة. تبقى القيمة التي أدخلها فريقك في لوحة التحكم: لا تستبدلها الواجهة البرمجية، ولا الوكيل أيضًا. تغيير البريد الإلكتروني أو رقم الهاتف لا يدمج العميل مع عميل آخر يحمله. أما البيانات الأساسية (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 هو معرّفك الخاص: يُسجَّل 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.