Sign in

v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB
Contacts

수신거부 연락처 추가

특정 전화번호를 수신거부 목록에 추가합니다. 추가된 연락처는 향후 모든 문자 발송 시 자동으로 제외되어 수신거부 의사를 준수할 수 있습니다. 전화번호와 발신번호 조합으로 관리됩니다.

post/v2/contacts/blocklist

Request body

phoneNumberstring required

수신거부 목록에 추가할 전화번호입니다. 이 번호로는 향후 메시지가 발송되지 않으며, 하이픈(-) 없이 숫자만 입력해주세요.

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

수신거부 할 메시지 타입입니다. SMS, KAKAO, RCS 중 선택할 수 있습니다.

senderNumberstring

수신거부를 적용할 발신번호입니다. 이 번호로 발송하는 메시지에만 수신거부가 적용되며, 하이픈(-) 없이 숫자만 입력해주세요.

kakaoChannelIdstring

수신거부를 적용할 카카오 채널 이름입니다. 이 채널로 발송하는 메시지에만 수신거부가 적용되며, 채널 이름은 카카오 채널 관리 페이지에서 확인할 수 있습니다.

rcsBrandIdstring

수신거부를 적용할 RCS 브랜드ID입니다. RCS 브랜드 관리 페이지에서 확인할 수 있습니다.

rcsChatbotIdstring

수신거부를 적용할 RCS 챗봇ID입니다. 입력한 RCS 브랜드 ID의 챗봇으로 수신거부가 적용됩니다.

Example request

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

Response

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

codenumber required

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

messagestring required

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

Example response

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