MultiTEL
개발자

DELETE/tcr/v2/campaign/{campaignId}

메시징 캠페인 비활성화

캠페인 사용을 종료하고 번호 할당을 대조·정리하며 본문이 비어 있는 성공 응답의 의미를 알아봅니다.

이 페이지의 내용
  1. 기존 메시징 캠페인 비활성화
  2. 대상 번호의 할당을 먼저 해제
  3. 대상 캠페인의 비활성화 요청 제출
  4. 등록 상태와 할당을 모두 확인
  5. 사용 종료와 계정 정산은 별개

기존 메시징 캠페인 비활성화

계정이 소유한 캠페인의 사용을 종료할 때 이 경로를 사용하세요. 대조 및 이력 관리를 위해 캠페인 ID를 보관하세요. 내용을 수정하거나 동의 문구를 업데이트하려면 대신 메시징 캠페인 업데이트를 사용하세요.

허용된 출발지 IP 주소에서 활성화된 API 계정을 사용하여 HTTPS로 인증하세요. 먼저 캠페인을 조회하고 연결된 브랜드와 발신 번호를 확인하세요. 비활성화하면 등록 상태가 변경되지만, 대체 캠페인이 생성되거나 번호가 다른 캠페인으로 이동하지는 않습니다.

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

대상 번호의 할당을 먼저 해제

공개 캠페인 DELETE 작업은 메시징 통신사에서 전화번호 연결을 해제하거나 로컬 할당을 삭제하지 않습니다. 계정이 소유한 각 대상 번호에 대해 번호와 캠페인 간 할당 해제 워크플로를 수행한 다음 할당 상태를 확인하세요. 할당을 해제해도 전화번호 자체가 해지되지는 않습니다.

포털의 '브랜드 삭제' 워크플로는 더 넓은 범위를 처리하며, 해당 브랜드를 삭제하기 전에 브랜드의 캠페인과 번호 연결을 정리합니다. 브랜드와 해당 브랜드의 다른 캠페인을 유지하려면 이 작업을 사용하지 마세요. 현재 일반 캠페인 편집기에는 이 직접 API 경로에 해당하는 별도의 캠페인 삭제 버튼이 없습니다.

대상 캠페인의 비활성화 요청 제출

캠페인 ID와 영향을 받는 발신 설정을 검토한 다음 JSON 본문 없이 DELETE를 전송하세요:

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/campaign/$CAMPAIGN_ID"

문서에 명시된 성공 응답은 본문이 비어 있는 HTTP 204입니다. JSON status/response 응답 봉투를 기대하지 말고 HTTP 상태를 확인하세요. 삭제가 수락되면 현재 서비스는 로컬에서 캠페인 리소스를 삭제됨 및 만료됨으로 표시하고, 기존 캠페인 레코드도 만료됨으로 표시합니다. 브랜드까지 연쇄적으로 삭제하지는 않습니다.

이 비활성화 요청에는 동일한 멱등성 키를 사용하고, 재전송을 위해 메서드, 경로, 쿼리 및 본문 바이트를 정확히 보존하세요. 처리 중인 요청과 중복되면 Retry-After와 함께 409가 반환될 수 있으며, 완료된 요청은 저장된 결과를 다시 반환할 수 있습니다. 캐시된 오류나 연결 중단만으로는 등록 시스템이 이미 작업을 수행했는지 판단할 수 없습니다. 캠페인 ID를 보관하고, requestId가 있으면 함께 보관하세요.

등록 상태와 할당을 모두 확인

요청 후 포털에서 캠페인의 현재 상태와 대상 번호를 확인하세요. API는 사용 종료 후에도 로컬 소유권 메타데이터를 유지할 수 있으므로, 소유한 식별자를 계속 조회할 수 있습니다. 같은 ID에 대해 로컬에서 항상 404가 반환된다고 단정하지 마세요. 사용이 종료된 레코드의 반환 상태나 조회 가능 여부는 등록 시스템이 결정합니다.

번호가 계속 할당되어 있다면 기존 할당을 대조하여 정리하세요. 단순히 비활성화를 재시도하려고 다른 캠페인을 만들거나, HTTP 204가 통신사 측 정리 완료를 입증한다고 가정하지 마세요. 등록 시스템이 요청을 수락한 후 로컬 동기화가 실패하면, 외부 비활성화가 이미 이루어졌더라도 API는 500을 반환할 수 있습니다.

비활성화 결과
결과다음 조치
204응답 본문은 없습니다. 캠페인 상태와 별도로 관리되는 번호 할당을 확인하세요.
400반환된 유효성 검사 오류 또는 등록 시스템 상태 오류를 확인하세요. 캠페인 ID가 정확한지와 현재 상태를 확인하세요.
401, 403, 404API 인증 정보, 허용된 출발지 IP 및 계정 소유권을 확인하세요. 다른 고객의 ID로 대체하지 마세요.
409, 429진행 중이거나 충돌하는 멱등 요청과 요청 속도 제한을 구분하세요. Retry-After가 제공되면 해당 지시를 따르세요.
500, 502 또는 시간 초과요청 세부 정보를 보관하고, 다시 제출하기 전에 기존 캠페인을 조회하여 상태를 대조하고 정리하세요.

사용 종료와 계정 정산은 별개

현재 DELETE 서비스는 캠페인 등록 요금을 즉시 인출하는 처리를 실행하지 않습니다. 이는 환불을 약속하거나 기존 계약상 의무를 없애거나 임대 번호를 해지한다는 뜻이 아닙니다. 포털에서 계정에 적용되는 캠페인 약관과 미결제 청구서를 확인하세요. 번호 임대료와 메시지 사용료는 캠페인 등록 요금과 별개입니다.

캠페인과 할당을 대조·정리한 후 사업자 등록 전체의 사용을 종료하려면 브랜드 사용 종료로 진행하세요.