목적

이 API는 Sidetalk 고객 연락처에 저장된 고객정보를 삭제합니다.

삭제 대상은 memberId, sessionId, 또는 userInfoId로 지정할 수 있습니다.

URL

💡https://api.sidetalk.ai/v1/users/delete

HTTP 메서드

POST

헤더

헤더 값 설명
Content-Type application/json 요청 본문이 JSON 형식임을 나타냅니다.
Authorization Bearer <api_key> Sidetalk 대시보드에서 설치하기 메뉴에 제공된 API 키를 사용하세요.

본문

파라미터 타입 필수 설명
memberId String 조건부 필수 외부 서비스의 회원 고유 ID입니다.
sessionId String 조건부 필수 대화 세션 ID입니다.
userInfoId String 조건부 필수 Sidetalk 고객정보 ID입니다.

memberId, sessionId, userInfoId 중 하나는 반드시 포함해야 합니다.

요청 예시

member_id로 삭제

curl -X POST <https://api.sidetalk.ai/v1/users/delete> \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{
      "memberId": "user_123"
  }'

여러 member_id 삭제

curl -X POST <https://api.sidetalk.ai/v1/users/delete> \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{
      "memberIds": ["user_123", "user_456"]
  }'

user_info_id로 삭제

curl -X POST <https://api.sidetalk.ai/v1/users/delete> \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_KEY}" \
  -d '{
      "userInfoId": "123"
  }'

응답 본문