Quay lại catalog nguồn dữ liệu
MessagingPhù hợp với RetailerPhù hợp với DistributorPhù hợp với F&B

Zalo Official Account

Kênh messaging chính tại VN, push cảnh báo, nhắc lịch và broadcast cho khách hàng.

Trang chính của vendor Tài liệu API chính thức

Loại API

REST API

Xác thực

OAuth 2.0

Tần suất refresh khả thi

Real-time

Setup · Maintain hằng tháng

6-10 giờ (cộng 5-10 ngày nếu cần OA xác minh) · 1-2 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Tạo Zalo Official Account

    oa.zalo.me, đăng ký OA với mã số thuế. OA thường (chưa xác minh) tạo ngay; OA xác minh mất 5-10 ngày.

  2. 2

    Tạo App trong Zalo for Developers

    developers.zalo.me, tạo App, gắn OA vào App. Chọn scope: send_message, broadcast, get_followers.

  3. 3

    Lấy App ID + App Secret

    Copy từ App detail. Lưu vào vault.

  4. 4

    Generate access token cho OA

    OAuth flow với scope quản lý OA → nhận oa_access_token và oa_refresh_token. Access token hết hạn 1 giờ, refresh token 90 ngày.

  5. 5

    Setup job refresh token

    Refresh access token mỗi 30 phút (chủ động trước khi hết hạn), refresh refresh token mỗi 80 ngày.

  6. 6

    Gửi message tới khách đã follow OA

    POST /v3.0/oa/message/cs với user_id (khách phải đã interact với OA trong 7 ngày, hoặc dùng broadcast). Send text, image, link, hoặc rich message.

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • App ID
  • App Secret
  • OA Access Token
  • OA Refresh Token

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • user_id
  • message_id
  • follower_count
  • broadcast_id
  • interaction_time

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • Window 7 ngày: chỉ gửi cs_message tới user đã interact trong 7 ngày qua. Sau đó phải dùng broadcast (giới hạn 1-4 broadcast/tháng tùy gói).
  • Phí broadcast: tăng theo lượt follower và số lượng broadcast, kiểm tra pricing trước khi scale.
  • Zalo không cho lookup user_id từ số điện thoại trực tiếp, phải có user follow OA trước.
  • Rich message (button, list) có schema chặt, gửi sai format sẽ fail im lặng, không có error rõ.
  • Broadcast cần admin OA approve nội dung, không thể automate hoàn toàn.

Dashboard sử dụng Zalo Official Account

Xem toàn bộ thư viện dashboard →
Chuỗi F&BTrưởng phòng marketing

Loyalty và retention khách hàng

Phân nhóm khách hàng theo cohort, tần suất ghé, AOV và thời gian từ lần ghé gần nhất. Trả lời "có bao nhiêu khách quay lại trong 30 ngày" và "khách VIP nào đang biến mất".

Mở dashboard
Bước tiếp theo

Kết nối Zalo Official Account vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu