Vô hiệu hóa chiến dịch nhắn tin

Vô hiệu hóa chiến dịch nhắn tin hiện có

Sử dụng tuyến này khi ngừng sử dụng một chiến dịch thuộc sở hữu tài khoản. Giữ lại mã định danh chiến dịch để đối soát và lưu lịch sử. Để sửa nội dung hoặc cập nhật văn bản chấp thuận, hãy dùng chức năng Cập nhật chiến dịch nhắn tin thay thế.

Xác thực bằng tài khoản API đã được kích hoạt qua HTTPS từ địa chỉ IP nguồn được cho phép. Trước tiên, truy xuất thông tin chiến dịch và kiểm tra thương hiệu cùng các số gửi tin liên quan. Việc vô hiệu hóa làm thay đổi đăng ký; thao tác này không tạo chiến dịch thay thế hoặc chuyển các số sang chiến dịch khác.

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

Trước tiên, gỡ các liên kết số điện thoại bị ảnh hưởng

Thao tác DELETE chiến dịch công khai không tách các số điện thoại khỏi nhà mạng nhắn tin hoặc xóa liên kết của chúng trong hệ thống cục bộ. Hãy sử dụng quy trình gỡ liên kết số điện thoại với chiến dịch cho từng số bị ảnh hưởng thuộc sở hữu tài khoản, sau đó xác minh liên kết của số đó. Việc gỡ liên kết không giải phóng số điện thoại.

Quy trình Xóa thương hiệu trên cổng thông tin có phạm vi rộng hơn: quy trình này dọn dẹp các chiến dịch và số điện thoại của thương hiệu trước khi xóa thương hiệu đó. Không sử dụng thao tác này nếu bạn muốn giữ lại thương hiệu và các chiến dịch khác của thương hiệu. Trình chỉnh sửa chiến dịch thông thường hiện không có nút xóa chiến dịch riêng tương đương với tuyến API trực tiếp này.

Gửi yêu cầu vô hiệu hóa đã xác định

Sau khi rà soát mã định danh chiến dịch và cấu hình gửi tin bị ảnh hưởng, gửi DELETE mà 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/campaign/$CAMPAIGN_ID"

Phản hồi thành công được mô tả trong tài liệu là HTTP 204 với phần thân trống. Hãy kiểm tra mã trạng thái HTTP thay vì chờ một cấu trúc bao status/response dạng JSON. Khi yêu cầu xóa được chấp nhận, dịch vụ hiện tại đánh dấu tài nguyên chiến dịch là đã xóa và hết hạn trong hệ thống cục bộ, đồng thời đánh dấu bản ghi chiến dịch kiểu cũ tương ứng là hết hạn. Thao tác này không xóa dây chuyền thương hiệu.

Sử dụng một khóa bảo đảm tính lũy đẳng cho yêu cầu đã xác định này và giữ nguyên phương thức, đường dẫn, truy vấn cùng từng byte phần thân để gửi lại. Yêu cầu trùng lặp đang được xử lý có thể trả về 409 kèm Retry-After; với yêu cầu đã hoàn tất, hệ thống có thể trả lại kết quả đã lưu. Lỗi được lưu trong bộ nhớ đệm hoặc kết nối bị gián đoạn không xác nhận được hệ thống đăng ký đã thực hiện thao tác hay chưa. Giữ lại mã định danh chiến dịch và requestId nếu có.

Xác minh cả đăng ký lẫn các liên kết số điện thoại

Sau khi gửi yêu cầu, kiểm tra trạng thái hiện tại của chiến dịch và các số bị ảnh hưởng trên cổng thông tin. API có thể giữ lại siêu dữ liệu về quyền sở hữu trong hệ thống cục bộ sau khi ngừng sử dụng, nên vẫn có thể kiểm tra mã định danh thuộc sở hữu tài khoản; đừng suy ra rằng cùng mã định danh đó luôn phải trả về 404 từ hệ thống cục bộ. Hệ thống đăng ký quyết định trạng thái được trả về hoặc khả năng truy xuất bản ghi đã ngừng sử dụng.

Nếu một số vẫn còn liên kết, hãy đối soát liên kết hiện có đó. Không tạo chiến dịch khác chỉ để thử vô hiệu hóa lại hoặc cho rằng HTTP 204 chứng minh việc dọn dẹp phía nhà mạng đã diễn ra. Nếu đồng bộ hóa cục bộ thất bại sau khi hệ thống đăng ký chấp nhận yêu cầu, API có thể trả về 500 mặc dù việc vô hiệu hóa ở hệ thống bên ngoài đã diễn ra.

Việc ngừng sử dụng tách biệt với việc quyết toán tài khoản

Dịch vụ DELETE hiện tại không phát lệnh ghi nợ phí đăng ký chiến dịch ngay lập tức. Điều này không bảo đảm hoàn tiền, không xóa bỏ cam kết hiện có và không giải phóng các số đang thuê. Kiểm tra các điều khoản về chiến dịch của tài khoản và các hóa đơn chưa thanh toán trên cổng thông tin. Việc thuê số và sử dụng tin nhắn tách biệt với việc đăng ký chiến dịch.

Nếu ngừng sử dụng toàn bộ đăng ký doanh nghiệp sau khi đã đối soát các chiến dịch và liên kết số điện thoại, hãy tiếp tục với việc ngừng sử dụng thương hiệu.