Bỏ qua

API xếp tầng

API Cascade cho phép gửi tin nhắn trên nhiều nền tảng với một yêu cầu duy nhất, tự động định tuyến tới Telegram Bot, Viber Bot, Viber Business Messages, RCS và SMS.

URL cơ sở

https://restapi.smsbat.com

Xác thực

API Cascade sử dụng xác thực dựa trên tiêu đề với ba tiêu đề xác thực có thể có:

Cách 1: Khóa API SMSBAT

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Cách 2: Viber Bot Token

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

Cách 3: Telegram Bot Key

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Điểm cuối có sẵn

Phương pháp Điểm cuối Mô tả
ĐĂNG /api/CascadeMessage/send_message/async Gửi tin nhắn chung theo tầng
ĐĂNG /api/CascadeMessage/send_message/tg-viber/async Tầng ưu tiên Telegram

Nó hoạt động như thế nào

Với một yêu cầu API duy nhất, Cascade tự động gửi tin nhắn của bạn trên nhiều kênh:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

Tin nhắn được gửi qua kênh khả dụng đầu tiên, với tính năng tự động chuyển sang kênh tiếp theo nếu việc gửi không thành công.

Tính năng chính

Giao hàng đa kênh

Gửi một tin nhắn, tiếp cận người dùng trên mọi nền tảng:

  • Telegram Bot
  • Viber Bot
  • Tin nhắn doanh nghiệp Viber
  • RCS (Dịch vụ truyền thông phong phú)
  • TIN NHẮN SMS

Thay thế biến

Sử dụng nội dung động với các phần giữ chỗ có thể thay đổi:

  • %name=id% - Biến văn bản
  • %url=id% - Biến URL
  • %short_url=id% - Biến URL rút ngắn

Lập lịch tin nhắn

Lên lịch gửi tin nhắn trong tương lai:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

Thời gian tồn tại (TTL)

Đặt thời gian hết hạn cho tin nhắn:

{
  "ttl": 3600
}

Loại tin nhắn

Hỗ trợ API Cascade:

  • Giao dịch - Xác nhận đơn hàng, thông báo
  • Khuyến mãi - Thông điệp tiếp thị và quảng cáo
  • Khảo sát trên Viber - Khảo sát tương tác
  • Cuộc gọi flash - Xác minh số điện thoại

Định dạng phản hồi

Phản hồi thành công trả về:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID để nhận dạng tin nhắn
  • trackinId - Chuỗi theo dõi trạng thái giao hàng

Bắt đầu nhanh

  1. Gửi tin nhắn - Bắt đầu gửi tin nhắn theo tầng
  2. Biến tin nhắn - Sử dụng nội dung động
  3. Loại tin nhắn - Khám phá các loại tin nhắn

Ví dụ yêu cầu

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

Xử lý lỗi

Mã trạng thái HTTP:

  • 200 OK - Yêu cầu thành công
  • 400 Yêu cầu Không hợp lệ - Định dạng yêu cầu không hợp lệ
  • 401 Không được phép - Xác thực không thành công
  • 429 Quá nhiều yêu cầu - Đã vượt quá giới hạn tỷ lệ
  • 500 Lỗi Máy chủ Nội bộ - Lỗi máy chủ

Lợi ích

Tích hợp đơn

Tích hợp một API cho tất cả các kênh nhắn tin - không cần tích hợp riêng với từng nền tảng.

Định tuyến tự động

Định tuyến thông minh đảm bảo gửi tin nhắn qua kênh tốt nhất hiện có cho mỗi người nhận.

Tối ưu hóa chi phí

Cascade thử các kênh rẻ hơn trước, tự động quay lại các tùy chọn đắt tiền hơn khi cần.

Tỷ lệ giao hàng cao hơn

Nhiều kênh dự phòng đảm bảo tin nhắn của bạn đến được người nhận ngay cả khi kênh chính bị lỗi.

Các bước tiếp theo