고객 프로필 및 티켓
고객 프로필을 조회하고 동기화하며, 시스템에서 티켓을 생성하세요.
4.4 고객 프로필
같은 고객의 대화는 하나의 고객 프로필로 묶이며, 대화의 contact_id가 해당 프로필을 가리킵니다. 식별 규칙: 서명된 회원 ID(user_token 또는 API로 전달한 user.id) > 채널 사용자(예: 위챗 openid) > 웹 방문자. 익명 방문자가 로그인하면 회원의 프로필로 병합됩니다. 서로 다른 두 회원은 자동으로 병합되지 않으며, 이메일이나 휴대폰 번호가 같은 경우에는 백오피스에서 알림만 표시되고 상담원이 직접 병합합니다.
| 방법 | 경로 | 설명 |
|---|---|---|
| GET | /v1/contacts?user_id= 또는 ?email= | 회원 ID 또는 이메일로 고객 프로필 조회 |
| GET | /v1/contacts/{id} | 고객 프로필: 이름, 이메일, 휴대폰, 태그 tags, 메모 notes, 사용자 정의 필드 attributes, 대화 수, 최근 방문 시간, 회원 ID user_ids |
| PATCH | /v1/contacts/{id} | 내 시스템에서 정보 동기화: name, phone, tags(최대 30개), notes, attributes(전체 교체, 최대 30개 필드). 변경할 필드만 전달 |
4.5 티켓
| 방법 | 경로 | 설명 |
|---|---|---|
| POST | /v1/tickets | 티켓 생성. 예: 웹사이트의 '문의하기' 양식: subject, description, priority(urgent / high / normal / low), 고객의 name / email / phone, 선택적으로 conversation_id 또는 contact_id 연결. 이메일이 있으면 상담원의 답변이 고객에게 이메일로 발송됩니다 |
| GET | /v1/tickets/{id} | 티켓과 타임라인(고객 메시지, 상담원 답변, 상태 변경, 내부 메모 제외) |
티켓 상태: open 처리 대기, pending 고객 답변 대기, resolved 해결됨, closed 종료됨. 처리 기한은 우선순위에 따라 '봇 설정'에서 설정합니다.
이 페이지가 도움이 되었나요?
마지막 업데이트:
