Her konuşma ve her arama bir müşterinin altına kaydedilir; bu, tüm kanallarınızda aynı kişidir. Müşteriler yalnızca kimsenin taklit edemeyeceği bilgilerle birleştirilir; örneğin aradıkları numara veya sitenizin oturum açmış bir ziyaretçi için imzaladığı kimlik. Birinin kendisinin yazdığı e-posta veya telefon profilde tutulur ve müşterileri ekibiniz panelde birleştirir. Sistemleriniz müşteri kütüphanesini okuyabilir, güncel tutabilir ve EvaSay dışında olanları ekleyebilir.
| Yöntem | Yol | Ne yapar |
|---|---|---|
| GET | /api/v1/voice/contacts | Müşteriler, en son görülenler önce: q adlarda, e-postalarda, telefonlarda, şirketlerde ve etiketlerde arar, segment_id yalnızca bir grubun müşterilerini bırakır, limit (en fazla 100) ve offset sayfalar |
| GET | /api/v1/voice/contacts/{id} | Bilgileri, etiketleri, izinleri ve kendi alanlarınızla bir müşteri |
| PATCH | /api/v1/voice/contacts/{id} | name, email, phone, company, city, country, language, timezone, tags veya attributes değerini değiştirir |
| GET | /api/v1/voice/contact-fields | Kendi müşteri alanlarınız: her birinin key, label, type ve options değeri |
| GET | /api/v1/voice/contacts/{id}/events | Müşterinin zaman çizelgesi, en yeniler önce |
| POST | /api/v1/voice/contacts/{id}/events | Kendi sistemlerinizden bir olay ekler |
| GET | /api/v1/voice/contacts/{id}/consent | İzindeki her değişiklik, kaynağı ve kanıtıyla |
| POST | /api/v1/voice/contacts/{id}/consent | Bir izin değişikliğini kaydeder |
| GET | /api/v1/voice/segments | Müşteri grupları; counts=true her birinde şu an kaç müşteri olduğunu ekler |
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 müşterinin tüm etiketlerinin yerini alır. attributes kendi alanlarınızın anahtarlarını (onları Müşteriler sayfasında ekleyin; GET /api/v1/voice/contact-fields listeler) alanın türünde bir değerle alır; boş bir metin değeri temizler. Ekibinizin panelde girdiği değer korunur: API onun üzerine yazmaz, agent da yazmaz. Bir e-postayı veya telefon numarasını değiştirmek, müşteriyi bu bilgiye sahip başka bir müşteriyle birleştirmez. Standart bilgiler (name, email, phone ve diğerleri) gönderdiğiniz gibi değiştirilir.
Kendi sistemlerinizde olanları, örneğin bir satın almayı, bir ziyareti veya bir yenilemeyi gönderin; müşterinin zaman çizelgesinde görünsün:
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 küçük harf, rakam, _ ve . kullanır. event_id kendi kimliğinizdir: aynı müşteride aynı event_id bir kez kaydedilir, bu yüzden yeniden denemek güvenlidir ve tekrar edilen istekte accepted değeri false olur. values metin, flags true veya false içerir; appointment_at ise Unix milisaniyesi cinsinden bir zamandır.
EvaSay dört tür izni ayrı tutar: marketing_email, marketing_sms, marketing_calls ve service_calls (iki arama türü de yapay zekâ sesiyle yapılan aramaları kapsar). Her biri granted, withdrawn ya da henüz kayıt yokken unknown olur. Bir değişiklik asla düzenlenmez; yalnızca kaynağı ve kanıtıyla geçmişe eklenir:
{ "kind": "marketing_calls", "status": "granted", "note": "Ticked 'Call me about offers' on order 1042" }
İzni yalnızca sahiplerin ve yöneticilerin anahtarları kaydedebilir ve kanıtınız olan note zorunludur.
Gruplar, müşteri kütüphanesi üzerinde kaydedilmiş filtrelerdir: her çalışma alanında olanlar (tüm müşteriler, VIP, son 7 günün yenileri ve diğerleri), sektörünüzünkiler ve Müşteriler sayfasında kendi oluşturduklarınız. GET /api/v1/voice/segments onları id değerleriyle listeler; bir grubun müşterilerini listelemek için bunu segment_id olarak verin.
Sistemleriniz değişikliklerden anında da haberdar olabilir: contact.created, contact.updated, contact.consent_changed ve contact.merged birer webhook olayıdır.