Bỏ qua

Tin nhắn SMS

Gửi tin nhắn văn bản tiêu chuẩn bằng API SMSBAT. SMS là kênh nhắn tin phổ biến nhất với tốc độ gửi cao nhất trên tất cả các thiết bị di động.

Tổng quan

SMS (Dịch vụ tin nhắn ngắn) lý tưởng cho:

  • Thông báo quan trọng về thời gian
  • Dự phòng cho tin nhắn Viber/RCS
  • Tiếp cận người dùng không cần smartphone
  • Khả năng tương thích phổ quát trên tất cả các mạng di động
  • Tỷ lệ giao hàng cao (95%+)

Tin nhắn SMS cơ bản

Yêu cầu

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Thông số

Tham số Loại Bắt buộc Mô tả
từ chuỗi Có ID người gửi chữ và số (tối đa 11 ký tự)
đến chuỗi Có Số điện thoại người nhận ở định dạng E.164
loại chuỗi Có Đặt thành "sms"
văn bản chuỗi Có Nội dung tin nhắn
customerMessageId chuỗi Không ID theo dõi nội bộ của bạn
ttl số nguyên Không Thời gian tồn tại tính bằng giây

Ví dụ

SMS đơn giản

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS có ID khách hàng

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS có TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Mã hóa ký tự

Mã hóa GSM 7-bit

Bảng chữ cái GSM tiêu chuẩn (160 ký tự cho mỗi SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Ký tự GSM mở rộng

Các ký tự này được tính là 2 ký tự:

| ^ € { } [ ] ~ \

Mã hóa Unicode (UCS-2)

Tin nhắn có ký tự đặc biệt sử dụng bảng mã Unicode (70 ký tự cho mỗi SMS):

  • Biểu tượng cảm xúc: 😀 🎉 ❤️
  • Chữ Cyrillic: А Б В Г Д Е Ж
  • Ký hiệu đặc biệt: ✓ ✗ ★ ♥

Độ dài tin nhắn

SMS đơn

  • GSM 7-bit: 160 ký tự
  • Unicode: 70 ký tự

SMS nhiều phần

Khi tin nhắn của bạn vượt quá giới hạn, tin nhắn sẽ được chia thành nhiều phần:

  • GSM 7-bit: 153 ký tự mỗi phần
  • Unicode: 67 ký tự mỗi phần

Ví dụ

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Tin nhắn này (201 ký tự) sẽ được chia thành 2 phần.

Phản hồi

Phản hồi thành công

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Trường phản hồi

Lĩnh vực Mô tả
messageId Mã định danh duy nhất để theo dõi
trạng thái Trạng thái tin nhắn (được chấp nhận, bị từ chối)
bộ phận Số phần SMS
đến Số điện thoại người nhận

ID người gửi

Người gửi chữ và số

Sử dụng tên thương hiệu của bạn làm người gửi (tối đa 11 ký tự):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Hạn chế:

  • Tối đa 11 ký tự
  • Chỉ chữ cái và số
  • Không có khoảng trắng và ký tự đặc biệt
  • Người nhận không thể trả lời người gửi bằng chữ và số

Người gửi số

Sử dụng số điện thoại làm người gửi (đối với SMS hai chiều):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Trường hợp sử dụng

Xác thực OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Thông báo đặt hàng

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Nhắc nhở cuộc hẹn

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Xác nhận thanh toán

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Các phương pháp hay nhất

Nội dung tin nhắn

  • ✅ Giữ thông điệp ngắn gọn và rõ ràng
  • ✅ Bao gồm nhận dạng người gửi
  • ✅ Thêm lời kêu gọi hành động nếu cần
  • ✅ Sử dụng đúng ngữ pháp và chính tả
  • ❌ Tránh dùng quá nhiều dấu câu!!!
  • ❌ Không viết hoa toàn bộ
  • ❌ Tránh các trình rút gọn URL trông đáng ngờ

Cách sử dụng ký tự

  • Kiểm tra số ký tự trước khi gửi
  • Nhận biết các ký tự GSM mở rộng (được tính là 2)
  • Kiểm tra ký tự đặc biệt trước khi gửi số lượng lớn
  • Cân nhắc sử dụng mã hóa GSM cho tin nhắn dài hơn

Số điện thoại

  • Luôn sử dụng định dạng E.164: +380XXXXXXXXX
  • Xác thực số điện thoại trước khi gửi
  • Xóa số không hợp lệ khỏi danh sách của bạn
  • Luôn cập nhật danh sách liên lạc của bạn

Thời gian

  • Tôn trọng múi giờ địa phương
  • Tránh gửi vào ban đêm (22h - 8h sáng)
  • Xem xét giờ làm việc cho tin nhắn thương mại
  • Đặt TTL thích hợp cho các tin nhắn nhạy cảm với thời gian

Tuân thủ

  • Lấy sự đồng ý trước khi gửi tin nhắn tiếp thị
  • Bao gồm hướng dẫn từ chối nhận SMS quảng cáo
  • Tuân thủ các quy định của địa phương (GDPR, v.v.)
  • Tôn trọng danh sách "Không làm phiền"

Xử lý lỗi

Các lỗi thường gặp

Lỗi Nguyên nhân Giải pháp
INVALID_RECIPIENT Định dạng điện thoại sai Sử dụng định dạng E.164
INVALID_SENDER ID người gửi không hợp lệ Kiểm tra quy tắc ID người gửi
MESSAGE_TOO_LONG Vượt quá độ dài tối đa Tách hoặc rút ngắn tin nhắn
INVALID_ENCODING Ký tự không được hỗ trợ Sử dụng GSM hoặc Unicode

Tối ưu hóa chi phí

Giảm phần tin nhắn

  • Giữ tin nhắn dưới 160 ký tự (GSM) hoặc 70 (Unicode)
  • Tránh các ký tự đặc biệt kích hoạt Unicode
  • Sử dụng chữ viết tắt khi thích hợp
  • Loại bỏ những khoảng trống không cần thiết

Ví dụ về tối ưu hóa

❌ Trước (171 ký tự, 2 SMS): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Sau (156 ký tự, 1 SMS): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Gửi hàng loạt

Gửi nhiều tin nhắn trong một yêu cầu:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Các bước tiếp theo