모든 대화와 통화는 고객 단위로 기록되며, 모든 채널에서 같은 사람은 같은 고객입니다. 고객은 전화를 건 번호나 로그인한 방문자에게 사이트가 서명한 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(두 가지 전화 모두 AI 음성 전화를 포함). 각각 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는 웹훅 이벤트입니다.