메시징 브랜드 사용 종료

사용 종료 절차 선택

사업상 해당 등록이 더 이상 필요하지 않으면 메시징 브랜드의 사용을 종료합니다. 이 작업은 기존 등록의 사용을 중단하며, 대체 등록 생성, 임대한 전화번호 해지 또는 사업자 식별 정보 수정을 수행하지 않습니다. 수정할 때 사용할 기능은 ‘메시징 브랜드 업데이트’입니다.

공개 브랜드 DELETE 호출과 포털의 ‘브랜드 삭제’ 작업은 처리 범위가 다릅니다. 공개 호출은 레지스트리의 브랜드 한 개를 삭제합니다. 포털은 전화번호 할당 해제와 캠페인 비활성화를 연계하여 수행한 뒤 브랜드 삭제를 시도합니다.

포털에서 영향 확인

메시징 등록 페이지를 열고 대상 브랜드를 찾아 ‘브랜드 삭제’를 선택합니다. 연결된 캠페인 수와 할당된 전화번호 수를 확인하세요. 정확한 브랜드 ID를 입력하면 최종 작업이 활성화됩니다. 이 고객용 양식은 계정에 등록 관리 권한이 있을 때만 사용할 수 있습니다.

포털은 활성 캠페인을 순서대로 처리합니다. 현재 할당된 각 전화번호의 할당 해제를 시도하고 캠페인을 비활성화한 다음 브랜드를 삭제합니다. 이미 만료 또는 삭제 상태로 표시된 캠페인은 원격 삭제를 다시 수행하지 않습니다. 이러한 외부 단계가 성공하면 데이터베이스 트랜잭션으로 로컬 캠페인 및 전화번호 레코드를 업데이트합니다.

이 절차는 레지스트리, 통신사 및 로컬 레코드 전체에 걸친 단일 원자적 트랜잭션이 아닙니다. 이후 단계에서 실패해도 외부에서 이미 변경된 전화번호나 캠페인을 복원할 수 없습니다. 할당 해제된 전화번호와 비활성화된 캠페인의 세부 정보가 반환되면 보관하세요. 다른 브랜드를 생성하는 대신 해당 식별자로 상태를 대조하고 불일치를 해소하세요.

API 직접 삭제 준비

허용된 출발지 IP 주소에서 활성화된 API 계정을 사용해 HTTPS로 접속하세요. 브랜드는 해당 계정에 속해야 합니다. 브랜드의 ID와 현재 상태를 조회하여 보관한 다음 캠페인과 전화번호 할당을 확인하세요. 브랜드를 삭제하기 전에 대상 전화번호의 할당을 해제하고 캠페인 비활성화 작업을 수행하세요. 이 DELETE를 연쇄 삭제 작업으로 취급하지 마세요.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

확인한 브랜드 삭제

브랜드 ID를 확인하고 앞서 설명한 정리를 완료한 후, 의도한 사용 종료를 수행하는 경우에만 다음을 실행하세요. 요청 JSON 본문은 없습니다.

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

문서에 명시된 성공 결과는 HTTP 204이며 응답 본문은 없습니다. JSON 성공 객체나 기존 v3의 status/response 엔벌로프를 필수로 요구하지 마세요. 2xx가 아닌 거부 결과는 현재 API 동기화 경로를 통해 브랜드를 삭제 상태로 표시하지 않습니다.

의도한 요청에는 동일한 멱등성 키를 사용하세요. 재전송할 때는 메서드, 경로, 쿼리 및 본문의 바이트를 변경하지 마세요. 이 키는 포털의 전체 정리 절차를 원자적으로 만들지 않으며, 통신사 측 전화번호 할당이 해제되었음을 입증하지도 않습니다. 처리 중인 요청과 중복되면 Retry-After와 함께 409가 반환될 수 있습니다. 완료된 요청은 오류를 포함하여 저장된 응답을 다시 반환할 수 있습니다.

사용 종료 확인 및 부분 처리 결과 대조

작업 후 포털의 브랜드 및 캠페인 목록과 대상 전화번호를 확인하세요. 공개 API의 성공 동기화는 해당 브랜드를 로컬에서 삭제 상태로 표시합니다. 다른 캠페인 리소스를 제거하거나 구매한 전화번호의 할당을 해제하지는 않습니다. 레지스트리 상태, 통신사 측 할당 및 로컬 표시는 각각 별도로 확인해야 합니다.

현재 포털의 통신사 어댑터는 본문에 있는 모든 업무 상태 값을 별도로 검증하지 않고 HTTP 성공 응답을 수락합니다. 따라서 포털에서 성공으로 보고했더라도 정리 후 대상 전화번호의 실제 캠페인 할당을 확인하세요. 할당이나 상태가 일치하지 않으면 관련 ID를 보관하고, 사용 종료한 구성을 통해 메시지를 전송하거나 해당 구성을 다시 만들기 전에 지원팀에 문의하세요.

HTTP 400의 경우 레지스트리의 상세 오류, 특히 활성 캠페인으로 인한 제한을 확인하세요. 401, 403 또는 404의 경우 인증 정보, 허용된 출발지 IP 및 계정 소유 관계를 확인하세요. 429의 경우 Retry-After의 지시를 따르세요. 외부 변경이 완료된 후에도 시간 초과, 500 또는 502가 발생할 수 있으므로 요청을 반복하기 전에 기존 등록을 확인하세요.

계정에 남아 있는 요금 확인

현재 DELETE 서비스는 브랜드 등록 요금의 즉시 차감 처리를 전송하지 않습니다. 브랜드를 삭제해도 임대한 전화번호가 해지되거나 환불이 이루어지거나 계정의 최종 잔액이 확정되지 않습니다. 기존 캠페인의 계약상 지급 의무, 전화번호 임대료 및 사용 요금을 포털에서 확인하세요. 이 작업은 이러한 별도 서비스에 대한 요금 견적이 아닙니다.