Bỏ qua

API SMSBAT

SMSBAT là nền tảng API RESTful để gửi nhiều loại tin nhắn khác nhau bao gồm băng chuyền Viber, hộp thoại ý kiến Viber, quảng cáo Viber (hình ảnh, video), trò chuyện doanh nghiệp Viber, thông báo OTP (Viber OTP, Flash Call) và các biến thể dự phòng của chúng.

URL cơ sở

Các yêu cầu tới API SMSBAT được truyền đến điểm cuối có bản địa hóa. Yêu cầu địa chỉ từ Người quản lý của bạn trước.

Ví dụ: https://restapi.smsbat.com (URL thực tế có thể thay đổi tùy theo khu vực của bạn)

Xác thực

API SMSBAT hỗ trợ ba phương thức xác thực:

Cách 1: Xác thực cơ bản HTTP

Sử dụng thông tin đăng nhập tên người dùng và mật khẩu của bạn:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Cách 2: Tiêu đề khóa API

Sử dụng tiêu đề X-Authorization-Key:

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

Cách 3: API Key làm mật khẩu

Sử dụng @ làm tên người dùng và khóa API của bạn làm mật khẩu:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-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 /bat/người nhắn tin Gửi tin nhắn
NHẬN /bat/message/{messageId} Kiểm tra trạng thái tin nhắn

Loại tin nhắn

API SMSBAT hỗ trợ các loại tin nhắn sau:

  • SMS - Tin nhắn văn bản tiêu chuẩn
  • Viber Promo - Tin nhắn quảng cáo đa phương tiện
  • Giao dịch Viber - Thông báo giao dịch
  • Băng chuyền Viber - Tin nhắn băng chuyền tương tác
  • Khảo sát Viber - Tin nhắn hộp thoại ý kiến
  • Viber OTP - Thông báo mật khẩu một lần
  • RCS - Tin nhắn Dịch vụ truyền thông đa dạng
  • Flash Call - Xác minh cuộc gọi im lặng

Tính năng chính

Nhắn tin dự phòng

Khi phân phối chính không thành công, SMSBAT sẽ tự động chuyển sang các kênh thay thế:

Viber → SMS → Email

Hỗ trợ đa phương tiện

Gửi tin nhắn với:

  • Hình ảnh (JPG, PNG)
  • Video (MP4)
  • PDF
  • Nút và liên kết hành động

Theo dõi trạng thái tin nhắn

Theo dõi trạng thái giao hàng theo thời gian thực:

  • Đã gửi
  • Đã giao
  • Đọc
  • Thất bại
  • Đã hết hạn

Gọi lại

Nhận cuộc gọi lại tin nhắn Viber đến để liên lạc hai chiều.

Bắt đầu nhanh

  1. Gửi tin nhắn - Tìm hiểu cách gửi tin nhắn đầu tiên của bạn
  2. Kiểm tra trạng thái - Theo dõi trạng thái gửi tin nhắn
  3. Loại tin nhắn - Khám phá các loại tin nhắn khác nhau

Định dạng yêu cầu

Tất cả các yêu cầu đều sử dụng định dạng JSON với cấu trúc sau:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

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

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

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

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ủ

Các bước tiếp theo