Đăng ký chiến dịch 10DLC

Đánh giá điều kiện thương hiệu trước khi đăng ký chiến dịch của thương hiệu đó

Chiến dịch 10DLC mô tả các tin nhắn mà doanh nghiệp đã đăng ký dự định gửi, cách người nhận đồng ý, và cách họ có thể nhận trợ giúp hoặc dừng tin nhắn. API này tạo bản ghi tại cơ quan đăng ký; việc hoàn tất kích hoạt với nhà mạng cho môi trường chính thức là một bước thiết lập tài khoản riêng. Hãy sử dụng thương hiệu thuộc sở hữu của bạn từ đăng ký thương hiệu, sau đó tải các trường hợp sử dụng khả dụng và, đối với trường hợp sử dụng đã chọn, yêu cầu hiện tại.

Hãy sử dụng kết quả đánh giá điều kiện hiện tại để chọn các trường hợp sử dụng phụ, ID mạng đủ điều kiện, mẫu tin nhắn và các khai báo đồng ý nhận/từ chối/trợ giúp. Yêu cầu có thể khác nhau tùy theo thương hiệu và mạng. Không gửi các định danh trong ví dụ và không sao chép mô tả về sự đồng ý của ví dụ cho một doanh nghiệp có quy trình khác.

Giữ tách biệt môi trường thử nghiệm và môi trường chính thức

Đối với bài thực hành trong môi trường thử nghiệm, hãy sử dụng thương hiệu giả lập của riêng bạn và một trường hợp sử dụng hiện tại mà thương hiệu đó đủ điều kiện. Chỉ sử dụng TRIAL khi kết quả đánh giá điều kiện đó cung cấp giá trị này. Cổng thông tin kiểm tra để đảm bảo thương hiệu đã chọn và môi trường chiến dịch phải khớp nhau. Yêu cầu API trực tiếp không chạy toàn bộ quy trình xác thực theo trình hướng dẫn của cổng thông tin thay cho bạn, vì vậy hãy giữ sự tách biệt đó trong phần tích hợp của bạn.

Việc tạo chiến dịch chính thức sẽ bị tính phí và không tự động làm cho một số điện thoại sẵn sàng gửi tin. Hãy giữ môi trường chiến dịch nhất quán với thương hiệu của chiến dịch, và xem xét phí cùng các điều khoản áp dụng trước khi tạo chiến dịch thực tế.

Gửi JSON chiến dịch

Hãy chuẩn bị campaign.json với các giá trị đủ điều kiện của bạn. R000000 có nghĩa là không có nhà bán lại; chỉ sử dụng giá trị này khi đó là cấu hình dự định. Đối với cấu hình nhà bán lại MultiTEL thông thường, hãy lấy định danh nhà bán lại MultiTEL LLC được phép từ bộ sưu tập nhà bán lại trong tài khoản của bạn hoặc từ luồng chuẩn bị của cổng thông tin thay vì gán cứng định danh của người khác.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  'https://api.multitel.net/tcr/v2/reseller?companyName=MultiTEL%20LLC&recordsPerPage=500'

JSON dưới đây minh họa một chiến dịch dùng thử cho thương hiệu giả lập thuộc sở hữu của bạn. Hãy thay thế thương hiệu, trường hợp sử dụng, nhà bán lại và nội dung về sự đồng ý bằng các giá trị thực sự đủ điều kiện cho bài kiểm thử của bạn.

{
  "brandId": "B123ABC",
  "channelId": "10DLC",
  "usecase": "TRIAL",
  "subUsecases": [],
  "resellerId": "R000000",
  "description": "Trial account notices requested by users of the example application.",
  "messageFlow": "Test users explicitly select an unchecked consent box before requesting these trial notices.",
  "sample1": "Example application: your requested account notice is available. Reply STOP to stop notices.",
  "subscriberOptin": true,
  "optinKeywords": "START",
  "optinMessage": "You are subscribed to the example application's requested account notices.",
  "subscriberOptout": true,
  "optoutKeywords": "STOP",
  "optoutMessage": "You will no longer receive the example application's account notices.",
  "subscriberHelp": true,
  "helpKeywords": "HELP",
  "helpMessage": "For help with example account notices, contact support@example.invalid.",
  "embeddedLink": false,
  "embeddedPhone": false,
  "numberPool": false,
  "ageGated": false,
  "directLending": false,
  "termsAndConditions": true,
  "autoRenewal": false,
  "mnoIds": [],
  "referenceId": "your-trial-reference"
}

Chỉ đặt termsAndConditions thành true sau khi người được ủy quyền đã xem xét và chấp nhận các điều khoản áp dụng. Ví dụ không phải là sự đồng ý thay cho bạn. Hãy sử dụng giá trị boolean JSON cho các cờ, không dùng chuỗi trong dấu ngoặc kép.

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

Các trường của chiến dịch và yêu cầu có điều kiện

Lược đồ đã công bố có một số cách viết hoa không nhất quán trong các bảng mô tả. Yêu cầu hiện tại của cổng thông tin sử dụng subscriberOptin và subscriberOptout như minh họa ở trên. Hãy giữ đúng cách viết hoa đó. Hướng dẫn này chỉ áp dụng cho quy trình 10DLC dành cho khách hàng thuê bao; không suy ra rằng các trường bắt buộc hay các bước kích hoạt của kênh khác cũng giống như vậy.

Thử lại cùng một yêu cầu dự định một cách an toàn

Hãy sử dụng một Idempotency-Key cho lần tạo dự định này. Khóa dài 1–128 ký tự ASCII in được, không chứa dấu cách và có phạm vi trong tài khoản chủ sở hữu. Khi thử lại, hãy giữ nguyên phương thức HTTP, đường dẫn, chuỗi truy vấn và byte nội dung chính xác. Tệp JSON đã định dạng lại sẽ xung đột ngay cả khi các giá trị của tệp là tương đương.

Yêu cầu trùng lặp đang xử lý có thể trả về HTTP 409 kèm Retry-After; các yêu cầu đã hoàn tất có thể phát lại phản hồi đã lưu. Lỗi đã lưu trong bộ nhớ đệm không chứng minh rằng cơ quan đăng ký chưa tạo gì. Hãy lưu campaignId, requestId và mọi tiêu đề tương quan, kiểm tra chiến dịch hiện có và kiểm tra trạng thái thực tế và xử lý các điểm không khớp do lỗi một phần trước khi xem xét dùng khóa mới.

ID chiến dịch không phải là bước thiết lập gửi tin cuối cùng

Phản hồi sử dụng trạng thái HTTP và JSON trực tiếp. Khi tạo thành công, hãy lưu campaignId và đọc trạng thái hiện tại của chiến dịch:

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

Quy trình chính thức hiện tại của cổng thông tin còn chia sẻ chiến dịch với nhà mạng nhắn tin và tải thương hiệu/chiến dịch vào tài khoản gửi tin. Đó là các thao tác riêng biệt với lệnh gọi tạo công khai này. Chiến dịch tại cơ quan đăng ký vẫn có thể tồn tại ngay cả khi bước chia sẻ hoặc tải lên nhà mạng sau đó thất bại.

Hãy sử dụng quy trình tạo chính thức tích hợp của cổng thông tin khi bạn cần chuỗi kết hợp gồm đăng ký, chia sẻ và tải lên nhà mạng. Đối với chiến dịch chính thức đã được tạo trực tiếp bằng API này, hãy giữ lại ID chiến dịch của chiến dịch đó và yêu cầu đối chiếu thiết lập nhà mạng của tài khoản thông qua bộ phận hỗ trợ. Giao diện khách hàng hiện tại không cung cấp nút tiếp tục chung cho mọi chiến dịch chính thức được tạo trực tiếp. Không tạo thêm một đăng ký khác để thử lại việc kích hoạt chiến dịch. Hãy xác nhận chiến dịch đang hoạt động và thiết lập nhà mạng đã hoàn tất trước khi gán số gửi tin. Số điện thoại cũng phải thuộc sở hữu của bạn, đang hoạt động và có hỗ trợ SMS. Việc tạo chiến dịch không gửi tin nhắn.

Phí chiến dịch chính thức

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 trường hợp sử dụng đủ điều kiện hiện tại và giá hiển thị trước khi gửi yêu cầu chính thức. monthlyFee trong phản hồi đánh giá điều kiện của cơ quan đăng ký không tự động là giá bán lẻ MultiTEL của bạn.

Cổng thông tin hiện tại quy định cam kết tối thiểu ba tháng đối với các chiến dịch chính thức không thuộc lĩnh vực chính trị. Hãy xem xét các điều khoản áp dụng và lựa chọn gia hạn trước khi xác nhận. Phí đăng ký, thuê số, thẩm định bổ sung và sử dụng tin nhắn là các khoản phí riêng. Phản hồi tạo thành công không tự chứng minh rằng mọi bước thanh toán hay kích hoạt với nhà mạng đã hoàn tất.

Xử lý lỗi xác thực và lỗi một phần

Hãy đọc status HTTP và JSON được trả về. Lỗi xác thực có thể là các mảng đối tượng code/description; lỗi cục bộ thay vào đó có thể là các đối tượng gồm message, status và, đối với một số lỗi xử lý, requestId.