메시징 브랜드 등록

메시지 뒤의 비즈니스를 등록하기

메시징 브랜드는 미국 10DLC 메시지를 발송하는 비즈니스를 식별합니다. 캠페인 사용 사례를 선택하기 전에 브랜드를 등록하십시오. 비즈니스의 법적 세부 정보와 필요한 검증을 완료할 수 있는 연락처를 사용하십시오. 반환된 브랜드 ID는 그 자체만으로 메시지 발송 승인을 의미하지 않습니다.

활성화된 API 계정과 허용된 출발지 IP 주소로 HTTPS를 통해 이 현재 계정 소유 경로를 사용하십시오. user_id, username 또는 다른 고객의 소유자 식별자를 제출하지 마십시오. MultiTEL은 인증된 계정에서 소유권을 기록합니다.

명시적인 샌드박스 요청부터 시작하기

포털 양식의 mode 필드는 기본적으로 샌드박스로 설정됩니다. 모의 브랜드를 의도하는 경우 직접 API 요청에 JSON 불리언 mock: true를 명시적으로 포함해야 합니다. 해당 플래그를 생략하면 샌드박스가 보장되지 않으며 과금되는 프로덕션 등록이 생성될 수 있습니다. 포털의 mode 필드는 API의 mock 필드를 대체하지 않습니다.

아래 필드를 사용하여 로컬 brand.json 파일을 준비하십시오. 플레이스홀더를 적절한 테스트 세부 정보와 최신 카탈로그 코드로 바꾸십시오. 이 예는 민간 영리 사업자이며 다른 엔터티 유형은 요구 사항이 다릅니다.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

위의 사업자명, 주소, 전화번호, 식별자는 플레이스홀더이며 등록 가능한 사업자 ID가 아닙니다. entityType, vertical, country, state, brandRelationship 및 기타 열거형의 최신 값은 다음 카탈로그에서 확인하십시오:메시징 카탈로그.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

비즈니스 및 연락처 필드

개인 사업자는 미국 또는 캐나다 등록에서 지원되며 캠페인 자격 전에 OTP 검증이 필요합니다. 상장 회사는 사업자 연락처 검증 단계가 필요할 수 있습니다. GOVERNMENT는 미국 소재 정부 기관용이며 다른 조직은 올바른 엔터티 범주를 확인하십시오. 엔터티별 요구 사항과 반환된 검증 오류를 모두 따르십시오.

안정적인 멱등성 키 유지하기

이 등록 의도에 대해 Idempotency-Key 하나를 생성하십시오. 공백 없이 1–128자의 인쇄 가능한 ASCII 문자를 포함해야 합니다. 동일한 키는 동일한 HTTP 메서드, 경로, 쿼리 문자열 및 정확히 동일한 요청 본문 바이트와 함께만 재사용하십시오. 의미를 변경하지 않는 JSON 서식 변경도 요청 지문을 변경합니다.

키가 포함된 완료된 요청은 등록을 다시 제출하지 않고 저장된 응답을 재생할 수 있습니다. 아직 처리 중인 중복 요청은 HTTP 409를 반환하며 Retry-After를 포함할 수 있습니다. 동일한 키로 변경된 요청은 충돌합니다. 요청이 시간 초과되거나 오류를 반환했다는 이유만으로 새 키를 생성하지 마십시오. 비즈니스가 이미 등록되었을 수 있습니다.

해당 요청을 해결하는 동안 brand.json 파일을 변경하지 마십시오. 캐시된 500 또는 502는 등록을 재시도하지 않고 원래 오류를 재생할 수 있습니다. 반환된 brandId, requestId 및 상관 관계 헤더를 보관하고 다른 요청을 시작하기 전에 기존 브랜드를 대사하십시오.

브랜드와 상태를 조회하기

이 API는 v3 status/response 엔벌로프가 아니라 HTTP 상태 코드와 직접 JSON 본문을 사용합니다. 등록에 성공하면 brandId를 포함한 브랜드 객체가 반환됩니다. 해당 식별자를 저장하고 반환된 검증 또는 ID 상태를 확인하십시오. 추가 필드는 엔터티와 등록 상태에 따라 다릅니다.

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

계정에 속한 브랜드만 읽으십시오. 404는 해당 브랜드를 이 계정에서 사용할 수 없음을 의미할 수 있습니다. 필요한 검증을 완료한 다음,브랜드 자격 확인을 통해 사용 가능한 캠페인 사용 사례를 찾으십시오. 모의 리소스가 프로덕션 발송에 적합하다고 가정하지 마십시오.

프로덕션 요금

이 소매 금액은 시월 24일, 2026년 기준 현재 포털 구성과 대조되었습니다. 프로덕션 등록 전에 포털에서 현재 요금을 확인하십시오. 캠페인 요금, 추가 심사 및 메시징 사용량은 별도입니다. 프로덕션 등록은 제출 전에 구매 권한과 사용 가능한 자금을 확인하며, 레지스트리 내 브랜드 생성 성공과 로컬 청구는 별도의 처리 단계이므로 오류나 청구 문제가 발생하면 리소스 ID를 보관하고 거래를 대사하십시오.

모의 브랜드를 프로덕션으로 변경하는 것은 별도로 확인되는 워크플로이며 새 프로덕션 ID와 요금이 발생할 수 있습니다. 이후 요청에서 mock를 false로 편집하면 기존 브랜드가 전환된다고 가정하지 마십시오.

브랜드를 중복하지 않고 오류 처리하기