Open APIs

REST APIOAuth 2.0WebhooksReal-time

Mới bắt đầu với Zalo APIs?

Bắt đầu với Hướng dẫn Quick Start để thực hiện API call đầu tiên trong vài phút.

Tổng quan

API Mở Zalo cung cấp các công cụ mạnh mẽ để tích hợp khả năng Tài khoản Chính thức và Tin nhắn Mẫu ZBS vào các ứng dụng kinh doanh của bạn. Xây dựng các giải pháp tương tác với khách hàng, hệ thống nhắn tin tự động và nền tảng giao tiếp kinh doanh toàn diện.

Với xác thực OAuth 2.0, thiết kế RESTful và tài liệu toàn diện, bạn có thể nhanh chóng tích hợp các tính năng như quản lý người theo dõi, gửi tin truyền thông, thông báo giao dịch và tự động hóa dịch vụ khách hàng.

Danh mục API

Tài khoản Chính thức Zalo (OA)

Quản lý Tài khoản Chính thức Zalo của bạn, gửi tin nhắn đến những người theo dõi, truyền thông nội dung, xử lý tương tác với khách hàng và truy cập thông tin người theo dõi một cách lập trình.

Gửi tin nhắnTruyền thôngNgười theo dõiWebhook

Xem tài liệu

Tin nhắn Mẫu ZBS

Gửi thông báo giao dịch, cập nhật đơn hàng, xác nhận đặt chỗ và tin nhắn kinh doanh đến khách hàng của bạn bằng cách sử dụng các mẫu đã được phê duyệt.

TemplatesThông báoGiao dịchOTP

Xem tài liệu

Bắt đầu nhanh

Ví dụ xác thực

Bắt đầu với xác thực OAuth 2.0

// Bước 1: Tạo code_verifier + code_challenge (PKCE)
// code_challenge = Base64URL(SHA-256(code_verifier))
// Cấu hình callback URL + code_challenge trên Zalo for Developers,
// gửi đường dẫn cấp quyền cho admin OA. Callback nhận: ?code=<CODE>&oa_id=<OA_ID>

// Bước 2: Đổi authorization code lấy OA access token
const axios = require("axios");

async function getOaAccessToken(code, codeVerifier) {
  const response = await axios.post(
    "https://oauth.zaloapp.com/v4/oa/access_token",
    new URLSearchParams({
      app_id: APP_ID,
      code,
      grant_type: "authorization_code",
      code_verifier: codeVerifier,
    }),
    {
      headers: {
        secret_key: SECRET_KEY,
        "Content-Type": "application/x-www-form-urlencoded",
      },
    }
  );

  return response.data.access_token;
}

// Bước 3: Gọi OA API với header access_token
async function getOaInfo(accessToken) {
  const response = await axios.get("https://openapi.zalo.me/v2.0/oa/getoa", {
    headers: { access_token: accessToken },
  });

  return response.data;
}