Chuyển tới nội dung chính
Trung tâm tài liệu tổng hợp

Xây dựng nhanh hơn vớihệ sinh thái Zalo Platform

Khám phá hướng dẫn toàn diện, tài liệu API và công cụ cho Mini App, ZBS, Open APIs và Zalo Bot. Tất cả trong một nơi.

Bắt đầu

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.

Các danh mục API

Các tính năng API Tài khoản Chính thức

API Tin nhắn

Gửi văn bản, hình ảnh, liên kết và tin nhắn tương tác đến những người theo dõi

API Truyền thông

Gửi tin nhắn quảng cáo đến nhiều người theo dõi cùng một lúc

API Thông tin Người dùng

Lấy thông tin hồ sơ người theo dõi và quản lý dữ liệu người dùng

Sự kiện Webhook

Nhận thông báo theo thời gian thực cho các hành động và tin nhắn của người dùng

Quản lý Thẻ

Tổ chức và phân đoạn người theo dõi bằng các thẻ tùy chỉnh

Tải lên phương tiện

Tải lên và quản lý hình ảnh, tệp và nội dung phương tiện

Các trường hợp sử dụng Tin nhắn Mẫu ZBS

Thương mại điện tử

  • Thông báo xác nhận đơn hàng
  • Cập nhật trạng thái vận chuyển
  • Xác nhận giao hàng
  • Biên lai thanh toán

Đặt chỗ & Cuộc hẹn

  • Xác nhận đặt chỗ
  • Nhắc nhở cuộc hẹn
  • Thông báo hủy bỏ
  • Thay đổi lịch trình

Dịch vụ Tài chính

  • Thông báo giao dịch
  • Xác nhận thanh toán
  • Cập nhật số dư
  • Cảnh báo bảo mật

Xác thực

  • Mã xác minh OTP
  • Thông báo đăng nhập
  • Liên kết đặt lại mật khẩu
  • Xác minh bảo mật

Ví dụ Bắt đầu Nhanh

Gửi Tin nhắn qua API Tài khoản Chính thức

Ví dụ về việc gửi tin nhắn văn bản đến một người theo dõi

send-message.js
const axios = require('axios');

async function sendMessage(accessToken, userId, message) {
  const response = await axios.post(
    'https://openapi.zalo.me/v2.0/oa/message',
    {
      recipient: {
        user_id: userId
      },
      message: {
        text: message
      }
    },
    {
      headers: {
        'access_token': accessToken,
        'Content-Type': 'application/json'
      }
    }
  );

  return response.data;
}

sendMessage(
  'YOUR_ACCESS_TOKEN',
  'USER_ID',
  'Hello! Thank you for following our Official Account.'
);

Gửi Tin nhắn Mẫu ZBS

Ví dụ về việc gửi thông báo giao dịch

send-template.js
const axios = require('axios');

async function sendTemplateMessage(accessToken, phone, templateId, params) {
  const response = await axios.post(
    'https://business.openapi.zalo.me/message/template',
    {
      phone: phone,
      template_id: templateId,
      template_data: params
    },
    {
      headers: {
        'access_token': accessToken,
        'Content-Type': 'application/json'
      }
    }
  );

  return response.data;
}

sendTemplateMessage(
  'YOUR_ACCESS_TOKEN',
  '84912345678',
  'ORDER_CONFIRMATION_TEMPLATE',
  {
    order_id: 'ORD123456',
    amount: '500,000đ',
    date: '15/05/2024'
  }
);