SEsendon
Contacts

통합 수신거부 연락처 추가

Changed on

특정 전화번호를 통합 수신거부 목록에 추가합니다. 통합관리를 켠 계정은 발신번호·카카오 채널·RCS 브랜드와 무관하게 계정의 모든 발송에서 이 번호가 자동으로 제외됩니다. 통합관리를 끈 계정은 기존 수신거부 목록으로 판정합니다.

post/v2/contacts/blocklist/unified

Request

  • Base URL
    https://api.sendon.io
  • URL
    https://api.sendon.io/v2/contacts/blocklist/unified
  • Auth
    HTTP basic

Request body

phoneNumberstring required

통합 수신거부 목록에 추가할 전화번호입니다. 통합관리를 켠 계정은 발신번호·채널과 무관하게 이 번호로 메시지가 발송되지 않으며, 하이픈(-) 없이 숫자만 입력해주세요.

messageType'DIRECT' | 'SMS' | 'KAKAO' | 'RCS'

등록 사유가 된 메시지 유형입니다. 기본값 DIRECT는 발신정보 없이 직접 등록한 것을 뜻하며, 어떤 값이든 차단은 계정 단위로 적용됩니다.

senderNumberstring

등록 사유가 된 발신번호입니다. messageType이 SMS일 때 기록용으로 남으며 차단 범위에는 영향이 없습니다.

kakaoChannelIdstring

등록 사유가 된 카카오 채널 이름입니다. messageType이 KAKAO일 때 기록용으로 남습니다.

rcsBrandIdstring

등록 사유가 된 RCS 브랜드ID입니다. messageType이 RCS일 때 기록용으로 남습니다.

rcsChatbotIdstring

등록 사유가 된 RCS 챗봇ID입니다. messageType이 RCS일 때 기록용으로 남습니다.

Example request

{
  "phoneNumber": "01012345678",
  "messageType": "DIRECT",
  "senderNumber": "01087654321",
  "kakaoChannelId": "센드온"
}

Response

통합 수신거부 연락처 추가가 성공적으로 완료되었습니다. 생성된 통합 수신거부 항목의 ID가 반환됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "OK",
  "data": {
    "id": 12345
  }
}

Changes