Tin nhắn Viber

API SMSBAT hỗ trợ nhiều loại tin nhắn Viber cho các trường hợp sử dụng khác nhau, từ chiến dịch quảng cáo đến thông báo giao dịch.

Tổng quan về loại tin nhắn

Loại	Mục đích	Đa phương tiện	Tương tác
`viber_promo`	Chiến dịch tiếp thị	✅ Hình ảnh, Video	✅ Nút
`viber_trans`	Thông báo giao dịch	✅ PDF	❌
`viber_carousel`	Trưng bày sản phẩm	✅ Hình ảnh	✅ Nhiều nút
`viber_khảo sát`	Thăm dò ý kiến và phản hồi	❌	✅ Nhiều lựa chọn
`viber_otp`	Mật khẩu một lần	❌	❌

Khuyến mãi Viber

Thông điệp quảng cáo với sự hỗ trợ đa phương tiện cho các chiến dịch tiếp thị.

Nội dung được hỗ trợ

Chỉ hình ảnh
Chỉ văn bản
Nút văn bản +
Hình ảnh + văn bản + nút
Video + văn bản
Video + văn bản + nút
Chỉ video

Thông số

Tham số	Loại	Bắt buộc	Mô tả
`img`	chuỗi	Không	URL hình ảnh
`video`	chuỗi	Không	URL tệp video
`hình thu nhỏ`	chuỗi	Không	Hình ảnh xem trước video
`nútText`	chuỗi	Không	Nhãn nút kêu gọi hành động
`buttonAction`	chuỗi	Không	Đích URL nhấp chuột vào nút
`Kích thước tập tin`	số nguyên	Không	Kích thước tệp video tính bằng byte
`thời lượng`	số nguyên	Không	Thời lượng video tính bằng giây

Ví dụ

Văn bản + Hình ảnh + Nút

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

Video + Văn bản + Nút

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

Chỉ hình ảnh

Ví dụ chỉ bằng hình ảnh

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

Chỉ văn bản

Ví dụ chỉ có văn bản

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

Chỉ video

Ví dụ chỉ dành cho video

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Video + Văn bản

Ví dụ về video + văn bản

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Giao dịch Viber

Thông báo giao dịch đối với thông tin nhạy cảm về thời gian như xác nhận đơn hàng và biên lai.

Nội dung được hỗ trợ

Chỉ văn bản
Tệp PDF + văn bản
Chỉ tập tin PDF

Thông số

Tham số	Loại	Bắt buộc	Mô tả
`fileUrl`	chuỗi	Không	URL tài liệu PDF
`Tên tệp`	chuỗi	Không	Tên hiển thị cho tệp đính kèm
`loại tệp`	chuỗi	Không	Loại tệp (sử dụng "pdf")

Ví dụ

Chỉ văn bản

Ví dụ chỉ có văn bản

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

Văn bản + PDF

Ví dụ về văn bản + PDF

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Chỉ PDF

Ví dụ chỉ có PDF

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Băng chuyền Viber

Trưng bày nhiều mặt hàng có thể xem được cho các sản phẩm hoặc nội dung.

Cấu trúc

Mảng các mục băng chuyền, mỗi mục chứa:

Tiêu đề
Hình ảnh
Nút chính (hành động chính)
Nút phụ (hành động thay thế)

Thông số

Tham số	Loại	Bắt buộc	Mô tả
`băng chuyền`	mảng	Có	Mảng vật phẩm băng chuyền
`mục`	mảng	Có	Đối tượng thẻ cá nhân

Ví dụ

Ví dụ về băng chuyền Viber

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

Khảo sát Viber

Các cuộc thăm dò tương tác và thu thập phản hồi với nhiều lựa chọn.

Thông số

Tham số	Loại	Bắt buộc	Mô tả
`khảo sát`	đối tượng	Có	Thùng khảo sát
`tùy chọn`	mảng	Có	Mảng từ 1-5 phương án trả lời

Ràng buộc

Hỗ trợ tối đa 5 tùy chọn phản hồi
Mỗi tùy chọn nên ngắn gọn (khuyến nghị: dưới 30 ký tự)

Ví dụ

Ví dụ khảo sát trên Viber

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

Viber OTP

Gửi mật khẩu một lần với các mẫu được xác định trước.

Các tính năng chính

9 mẫu được xác định trước
Xác thực tham số (loại TEXT, NUMBER)
Hỗ trợ đa ngôn ngữ (19 ngôn ngữ)
Tên biến phân biệt chữ hoa chữ thường

Ngôn ngữ được hỗ trợ

Tiếng Ukraina, tiếng Anh, tiếng Nga, tiếng Ba Lan, tiếng Rumani, tiếng Tây Ban Nha, tiếng Đức, tiếng Pháp, tiếng Ý, tiếng Bồ Đào Nha, tiếng Hà Lan, tiếng Thổ Nhĩ Kỳ, tiếng Ả Rập, tiếng Do Thái, tiếng Hindi, tiếng Trung, tiếng Nhật, tiếng Hàn, tiếng Việt

Thông số

Tham số	Loại	Bắt buộc	Mô tả
`templateId`	chuỗi (UUID)	Có	Mã định danh mẫu
`templateLang`	chuỗi	Có	Mã ngôn ngữ ISO
`templateParams`	đối tượng	Có	Mẫu khớp biến

Ví dụ

Ví dụ về Viber OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

Ví dụ về mẫu: "Mã của bạn: 123456. Có hiệu lực trong 10 phút. Không bao giờ chia sẻ mã này."

Mẫu và xác thực được hỗ trợ

Viber cung cấp các mẫu được xác định trước và được kiểm soát chặt chẽ. Các tham số biến được truyền phải tương ứng với đúng kiểu dữ liệu.

Các loại dữ liệu: - SỐ: Chỉ các chữ số [0-9], +, - và .. Các ký hiệu như / hoặc khoảng trắng không được hỗ trợ. - TEXT: Bất kỳ bảng chữ cái, ký hiệu ngôn ngữ nào (@#$%^&*().,<>;:!\"'+=-()[]{} \n, v.v.). - Ánh xạ thông thường: Một chuỗi <chữ cái> không thể tồn tại liền kề với một chuỗi <số>; họ yêu cầu tách khoảng trắng. Các khoảng trắng kép bên trong các mẫu thường bị cấm. Đối với các liên kết, hãy tránh khoảng trắng nếu chúng vượt quá giới hạn.

Dưới đây là 9 mẫu ISO tiêu chuẩn. Thay thế ID dựa trên yêu cầu đăng ký của bạn ở các quốc gia cụ thể. Liên hệ với bộ phận hỗ trợ nếu thêm ngôn ngữ bổ sung.

1. "CHỈ CÓ Mã (Bất kỳ mã PIN nào)"

Yêu cầu: Hỗ trợ mã PIN bằng chữ số & chữ cái tiếng Anh, ký hiệu - hoặc .. Mẫu yêu cầu định dạng để hiển thị đúng thương hiệu của bạn cùng với mã PIN xác minh.

2. "Hành động: Vui lòng sử dụng mã này"

Thông số: {pin} (SỐ hoặc TEXT) Định dạng ví dụ: "Vui lòng sử dụng mã này {pin} để xác minh."

3. "Đăng ký/Truy cập thương hiệu"

Thông số: {business_platform_name} (TEXT), {pin} (NUMBER hoặc TEXT) Định dạng ví dụ: "Mã cho {business_platform_name} của bạn là {pin}."

4. "Thời gian xác thực mã"

Thông số: {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Định dạng ví dụ: "Mã xác minh của bạn là {pin}. Nó có hiệu lực trong {code_validity_time} phút."

5. "Truy cập thương hiệu & Xác thực mã"

Thông số: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Định dạng ví dụ: "Mã xác minh {business_platform_name} là {pin} hợp lệ trong {code_validity_time} phút."

(Lưu ý: Có tới 9 khối cấu trúc được xác định trước cho các quy tắc OTP tiêu chuẩn của Viber dựa trên sự kết hợp của cách sử dụng pin, business_platform_name và code_validity_time).

Yêu cầu chung

Tất cả các loại tin nhắn Viber đều yêu cầu:

from: ID người gửi gồm chữ và số
to: Số điện thoại dạng E.164
type: Định danh loại tin nhắn
ttl: Thời gian hết hạn tin nhắn tính bằng giây (khuyến nghị)

Chuyển sang SMS

Tất cả các loại tin nhắn Viber đều hỗ trợ dự phòng SMS bằng cách sử dụng khối mảng dự phòng. Nếu việc gửi Viber không thành công, tin nhắn sẽ tự động chuyển về các kênh được định cấu hình thay thế.

Khuyến mãi Viber -> Dự phòng SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Khảo sát trên Viber -> Dự phòng SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Viber Trans -> Dự phòng SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

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

Hình ảnh

Sử dụng định dạng JPG hoặc PNG
Kích thước đề xuất: 800x600 pixel
Giữ kích thước file dưới 1MB
Sử dụng URL HTTPS

Video

Sử dụng định dạng MP4
Giữ kích thước file dưới 10MB
Bao gồm hình ảnh thu nhỏ
Chỉ định thời lượng và kích thước tệp

Nút

Giữ văn bản nút ngắn gọn (2-3 từ)
Sử dụng các cụm từ kêu gọi hành động rõ ràng
Luôn sử dụng URL HTTPS
Kiểm tra URL trước khi gửi

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

Tin nhắn khuyến mại: 24-72 giờ
Tin nhắn giao dịch: 24 giờ
Tin nhắn OTP: 5-10 phút
Khảo sát: 7-30 ngày

Các bước tiếp theo

Tin nhắn SMS - Tìm hiểu về dự phòng SMS
Tin nhắn RCS - Dịch vụ liên lạc đa dạng
Kiểm tra trạng thái - Theo dõi trạng thái giao hàng