Ngừng sử dụng thương hiệu nhắn tin

Chọn quy trình ngừng sử dụng

Ngừng sử dụng thương hiệu nhắn tin khi doanh nghiệp không còn cần đăng ký đó. Thao tác này chấm dứt việc sử dụng đăng ký hiện có; không đăng ký thương hiệu thay thế, trả lại số điện thoại đang thuê hay sửa thông tin định danh doanh nghiệp. Để chỉnh sửa, hãy dùng Cập nhật thương hiệu nhắn tin.

Lệnh gọi DELETE thương hiệu công khai và thao tác Xóa thương hiệu trên cổng thông tin có phạm vi khác nhau. Lệnh gọi công khai xóa một thương hiệu trong hệ thống đăng ký. Cổng thông tin điều phối việc gỡ gán số điện thoại và ngừng kích hoạt chiến dịch trước khi thử xóa thương hiệu.

Xem xét tác động trên cổng thông tin

Mở trang đăng ký nhắn tin, tìm đúng thương hiệu và chọn Xóa thương hiệu. Xem lại số lượng chiến dịch liên quan và số điện thoại đã được gán. Nhập chính xác mã định danh thương hiệu để bật thao tác cuối cùng. Biểu mẫu dành cho khách hàng chỉ khả dụng khi tài khoản có quyền quản lý đăng ký.

Cổng thông tin xử lý lần lượt các chiến dịch đang hoạt động: thử gỡ gán từng số điện thoại hiện được gán, ngừng kích hoạt chiến dịch, rồi xóa thương hiệu. Cổng thông tin bỏ qua việc xóa từ xa lần nữa đối với các chiến dịch đã được đánh dấu hết hạn hoặc đã xóa. Sau khi các bước bên ngoài đó thành công, cổng thông tin cập nhật các bản ghi chiến dịch và số điện thoại cục bộ trong một giao dịch cơ sở dữ liệu.

Chuỗi thao tác này không phải là một giao dịch nguyên tử duy nhất bao trùm hệ thống đăng ký, nhà mạng và các bản ghi cục bộ. Lỗi xảy ra ở bước sau không thể khôi phục số điện thoại hoặc chiến dịch đã được thay đổi ở hệ thống bên ngoài. Khi có thông tin trả về về các số đã được gỡ gán và các chiến dịch đã ngừng kích hoạt, hãy lưu lại; đối soát các mã định danh đó thay vì tạo một thương hiệu khác.

Chuẩn bị xóa trực tiếp qua API

Dùng tài khoản API đã được bật qua HTTPS từ địa chỉ IP nguồn được phép. Thương hiệu phải thuộc tài khoản đó. Đọc và lưu lại mã định danh cùng trạng thái hiện tại của thương hiệu, sau đó kiểm tra các chiến dịch và việc gán số điện thoại. Gỡ gán các số điện thoại bị ảnh hưởng và ngừng kích hoạt các chiến dịch trước khi xóa thương hiệu. Không coi lệnh DELETE này là thao tác xóa dây chuyền.

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

Xóa thương hiệu đã được xem xét

Chỉ thực thi lệnh sau cho việc ngừng sử dụng đã định, sau khi kiểm tra mã định danh thương hiệu và hoàn tất các bước dọn dẹp nêu trên. Yêu cầu không có phần thân 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"

Kết quả thành công được ghi trong tài liệu là HTTP 204, không có phần thân phản hồi. Không yêu cầu đối tượng thành công dạng JSON hay cấu trúc bao status/response của phiên bản v3 cũ. Kết quả bị từ chối với mã ngoài nhóm 2xx không đánh dấu thương hiệu là đã xóa thông qua luồng đồng bộ API hiện tại.

Dùng một khóa bảo đảm tính lũy đẳng cho yêu cầu đã định. Khi gửi lại, giữ nguyên phương thức, đường dẫn, chuỗi truy vấn và từng byte của phần thân. Khóa này không làm cho toàn bộ quy trình dọn dẹp trên cổng thông tin trở thành giao dịch nguyên tử và không chứng minh rằng số điện thoại đã được gỡ gán tại nhà mạng. Yêu cầu trùng lặp khi yêu cầu trước vẫn đang xử lý có thể trả về 409 kèm Retry-After; các yêu cầu đã hoàn tất có thể trả lại phản hồi đã lưu, kể cả phản hồi lỗi.

Xác minh việc ngừng sử dụng và đối soát kết quả từng phần

Kiểm tra danh sách thương hiệu, danh sách chiến dịch và các số điện thoại bị ảnh hưởng trên cổng thông tin sau thao tác. Việc đồng bộ khi API công khai thành công đánh dấu riêng thương hiệu đó là đã xóa trong hệ thống cục bộ; không xóa các tài nguyên chiến dịch khác hay gỡ các phép gán số điện thoại đã mua. Trạng thái trong hệ thống đăng ký, việc gán tại nhà mạng và thông tin hiển thị cục bộ cần được kiểm tra riêng.

Bộ điều hợp nhà mạng hiện tại của cổng thông tin chấp nhận phản hồi HTTP thành công mà không kiểm tra riêng từng giá trị trạng thái nghiệp vụ trong phần thân phản hồi. Vì vậy, hãy xác minh việc gán chiến dịch thực tế của các số điện thoại bị ảnh hưởng sau khi dọn dẹp trên cổng thông tin, ngay cả khi cổng thông tin báo thành công. Nếu có phép gán hoặc trạng thái không nhất quán, hãy lưu lại các mã định danh liên quan và liên hệ bộ phận hỗ trợ trước khi gửi tin qua cấu hình đã ngừng sử dụng hoặc tạo lại cấu hình đó.

Với HTTP 400, hãy đọc lỗi chi tiết từ hệ thống đăng ký, đặc biệt là hạn chế do chiến dịch đang hoạt động. Với 401, 403 hoặc 404, hãy kiểm tra thông tin xác thực, IP nguồn được phép và quyền sở hữu của tài khoản. Với 429, hãy tuân thủ Retry-After. Hết thời gian chờ, mã 500 hoặc 502 có thể xảy ra sau khi thay đổi ở hệ thống bên ngoài đã hoàn tất; hãy kiểm tra đăng ký hiện có trước khi gửi lại yêu cầu.

Kiểm tra các khoản phí còn lại của tài khoản

Dịch vụ DELETE hiện tại không phát lệnh ghi nợ phí đăng ký thương hiệu ngay lập tức. Xóa thương hiệu không trả lại số điện thoại đang thuê, không hoàn tiền và không xác định số dư cuối cùng của tài khoản. Hãy xem lại mọi cam kết chiến dịch hiện có, phí thuê số điện thoại và phí sử dụng trên cổng thông tin. Thao tác này không phải là báo giá cho các dịch vụ riêng biệt đó.