Đăng ký thương hiệu nhắn tin

Đăng ký doanh nghiệp đứng sau các tin nhắn của bạn

Thương hiệu nhắn tin xác định doanh nghiệp gửi tin nhắn US 10DLC. Hãy đăng ký thương hiệu trước khi chọn trường hợp sử dụng cho chiến dịch. Sử dụng thông tin pháp lý của doanh nghiệp và một liên hệ có thể hoàn tất mọi bước xác thực bắt buộc. Mã thương hiệu được trả về tự nó không phải là phê duyệt để gửi tin nhắn.

Sử dụng tuyến hiện tại thuộc sở hữu tài khoản này qua HTTPS với tài khoản API đã bật và địa chỉ IP nguồn được phép của tài khoản đó. Không gửi user_id, username hoặc mã định danh chủ sở hữu của khách hàng khác. MultiTEL ghi nhận quyền sở hữu từ tài khoản đã xác thực.

Bắt đầu bằng một yêu cầu thử nghiệm tường minh

Trong biểu mẫu của cổng thông tin, trường mode được đặt mặc định ở chế độ thử nghiệm; yêu cầu API trực tiếp phải bao gồm tường minh giá trị luận lý JSON mock: true khi bạn định tạo thương hiệu mô phỏng. Việc bỏ sót cờ này không đảm bảo ở trong môi trường thử nghiệm và có thể tạo ra một đăng ký thực tế bị tính phí. Trường mode của cổng thông tin không thể thay thế cho trường mock của API.

Chuẩn bị tệp brand.json cục bộ bằng các trường dưới đây. Thay các giá trị giữ chỗ bằng chi tiết thử nghiệm phù hợp và mã danh mục hiện tại. Ví dụ này là doanh nghiệp tư nhân vì lợi nhuận; các loại hình tổ chức khác có yêu cầu khác nhau.

{
  "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
}

Doanh nghiệp, địa chỉ, số điện thoại và mã định danh ở trên chỉ là giá trị giữ chỗ, không phải là danh tính doanh nghiệp sẵn sàng để đăng ký. Hãy lấy giá trị hiện tại cho entityType, vertical, country, state, brandRelationship và các danh mục liệt kê khác từ các danh mục nhắn tin.

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'

Các trường doanh nghiệp và liên hệ

Hộ kinh doanh cá thể được hỗ trợ cho đăng ký tại US hoặc Canada và cần xác minh OTP trước khi đủ điều kiện nhận chiến dịch. Công ty đại chúng có thể cần thêm bước xác thực liên hệ công việc. GOVERNMENT dành cho các tổ chức chính phủ tại US; hãy xác nhận đúng nhóm loại hình cho các tổ chức khác. Tuân thủ các yêu cầu riêng theo từng loại hình cũng như các lỗi xác thực được trả về.

Giữ một khóa lũy đẳng ổn định

Tạo một Idempotency-Key cho lần đăng ký đã định này. Khóa phải chứa 1–128 ký tự ASCII có thể in được và không có dấu cách. Chỉ tái sử dụng cùng một khóa với cùng phương thức HTTP, đường dẫn, chuỗi truy vấn và đúng từng byte của nội dung yêu cầu. Việc định dạng lại JSON, dù không làm thay đổi ý nghĩa, cũng làm thay đổi dấu vân tay của yêu cầu.

Một yêu cầu có khóa đã hoàn tất có thể phát lại phản hồi đã lưu mà không cần gửi đăng ký lần nữa. Một yêu cầu trùng lặp vẫn đang được xử lý sẽ trả về HTTP 409 và có thể bao gồm Retry-After. Một yêu cầu đã thay đổi nhưng dùng cùng khóa sẽ gây xung đột. Không tạo khóa mới chỉ vì yêu cầu hết thời gian chờ hoặc trả về lỗi: doanh nghiệp có thể đã được đăng ký rồi.

Giữ nguyên brand.json trong khi xử lý yêu cầu đó. Lỗi 500 hoặc 502 đã lưu trong bộ nhớ đệm có thể phát lại lỗi gốc thay vì thử lại việc đăng ký. Giữ lại mọi brandId, requestId được trả về cùng các tiêu đề tương quan; hãy kiểm tra trạng thái thực tế của thương hiệu hiện có và xử lý mọi sai lệch trước khi bắt đầu một yêu cầu khác.

Đọc thương hiệu và trạng thái của thương hiệu

API này sử dụng mã trạng thái HTTP và nội dung JSON trực tiếp, thay vì phong bì v3 status/response. Đăng ký thành công sẽ trả về một đối tượng thương hiệu bao gồm brandId. Hãy lưu trữ mã định danh đó và kiểm tra trạng thái xác thực hoặc danh tính được trả về. Các trường bổ sung phụ thuộc vào loại hình và trạng thái đăng ký.

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

Chỉ đọc thương hiệu thuộc về tài khoản của bạn. Lỗi 404 có thể có nghĩa là thương hiệu này không khả dụng đối với tài khoản này. Hãy hoàn tất mọi bước xác thực bắt buộc, sau đó sử dụng đánh giá điều kiện thương hiệu để tìm các trường hợp sử dụng cho chiến dịch khả dụng của thương hiệu đó. Không thể mặc định cho rằng tài nguyên mô phỏng đủ điều kiện để gửi trong môi trường thực tế.

Phí đăng ký thực tế

Các mức giá bán lẻ này đã được đối chiếu với cấu hình cổng thông tin hiện tại vào ngày 24 tháng Mười năm 2026. Hãy xác nhận mức phí hiện tại trên cổng thông tin trước khi đăng ký thực tế. Phí chiến dịch, phí thẩm định bổ sung và lưu lượng nhắn tin là các khoản riêng. Một đăng ký thực tế sẽ kiểm tra quyền mua và số dư khả dụng trước khi gửi; việc tạo thành công trên hệ thống đăng ký và việc lập hóa đơn trong hệ thống nội bộ là các bước xử lý riêng biệt, vì vậy hãy giữ lại mã tài nguyên và đối chiếu giao dịch nếu xảy ra lỗi hoặc sự cố thanh toán.

Việc chuyển thương hiệu mô phỏng sang môi trường thực tế là một quy trình được xác nhận riêng và có thể tạo ra một danh tính thực tế mới cùng khoản phí mới. Đừng cho rằng việc sửa mock thành false trong yêu cầu sau sẽ chuyển đổi thương hiệu hiện có.

Xử lý lỗi mà không tạo trùng thương hiệu