Hubz API: tích hợp Zalo vào CRM qua API và webhook

Hubz API v1 cho phép phần mềm của bạn (CRM, ERP, Odoo, website) làm việc với các cuộc trò chuyện Zalo mà đội ngũ đang chăm sóc trong Hubz: tìm khách, đọc hội thoại, gửi tin do nhân viên soạn, nhận webhook khi có tin mới và nhúng khung chat Hubz.

Bạn làm được gì với Hubz API

• Đồng bộ khách hàng: tìm khách theo số điện thoại hoặc tên (GET /v1/contacts), liên kết khách Hubz với bản ghi trong phần mềm của bạn (PUT /v1/contacts/{id}/links).
• Đọc hội thoại và tin: lấy hội thoại, lịch sử tin, tải tệp đính kèm.
• Gửi tin: gửi tin do nhân viên soạn hoặc duyệt vào một hội thoại có sẵn. Tin đi qua cùng hàng đợi và giới hạn của số Zalo như khi nhân viên gửi tay.
• Nhận sự kiện: webhook khi có tin mới, tin thay đổi, hội thoại thay đổi; hoặc kéo sự kiện định kỳ nếu phần mềm nằm sau NAT.
• Nhúng Hubz: khung chat của một hội thoại, hoặc cả app Hubz, ngay trong phần mềm của bạn.

Khái niệm

• Số Zalo (Account): tài khoản Zalo của doanh nghiệp đã kết nối vào Hubz.
• Khách (Contact): người bạn trò chuyện, có thể liên kết với một bản ghi bên phần mềm của bạn.
• Hội thoại (Conversation) và tin (Message): cuộc trò chuyện của một số Zalo với một khách hoặc một nhóm.
• Sự kiện (Event): message.created, message.updated, conversation.updated.

Thông tin chung

• Địa chỉ: https://api.hubz.vn. Dữ liệu gửi và nhận dạng JSON.
• Xác thực bằng khóa tích hợp do Chủ doanh nghiệp tạo: xem Xác thực.
• Khoảng 300 request mỗi phút cho mỗi khóa, có thể điều chỉnh trong giai đoạn beta: xem Giới hạn và mã lỗi.
• v1 chỉ thêm trường, không đổi hay bỏ trường; thay đổi phá vỡ tương thích sẽ ra /v2 và được ghi ở Nhật ký thay đổi.

Bắt đầu từ đâu

Làm theo Bắt đầu nhanh: tạo khóa, gọi request đầu tiên và nhận webhook đầu tiên. Dùng Odoo thì xem Hướng dẫn Odoo.