Bắt đầu nhanh với Hubz API

1. Tạo khóa tích hợp

1. Đăng nhập Hubz bằng tài khoản Chủ doanh nghiệp: chỉ Chủ doanh nghiệp tạo được khóa.
2. Mở Tích hợp, tạo khóa mới, chọn quyền (read, send, link, events) và các số Zalo mà khóa được dùng.
3. Sao chép khóa hbz_live_… và cất như mật khẩu. Trong tài liệu này, khóa mẫu là hbz_live_xxx.

2. Gọi request đầu tiên

GET /v1/me cho biết khóa thuộc công ty nào, đang hành động dưới tên ai và dùng được những số Zalo nào:

curl https://api.hubz.vn/v1/me \
  -H "Authorization: Bearer hbz_live_xxx"

Sau đó liệt kê các số Zalo khóa dùng được, hoặc tìm khách theo số điện thoại (mọi cách viết số đều được):

curl https://api.hubz.vn/v1/accounts \
  -H "Authorization: Bearer hbz_live_xxx"

curl "https://api.hubz.vn/v1/contacts?phone=0912345678" \
  -H "Authorization: Bearer hbz_live_xxx"

3. Nhận webhook đầu tiên

Khóa cần quyền events. Đăng ký địa chỉ https của bạn và các sự kiện muốn nhận:

curl -X PUT https://api.hubz.vn/v1/webhook \
  -H "Authorization: Bearer hbz_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://crm.example.com/hubz/webhook", "events": ["message.created", "conversation.updated"]}'

Hubz trả lại bí mật ký (secret) khi tạo mới, khi đổi địa chỉ hoặc khi gửi rotateSecret. Lưu bí mật này để kiểm chữ ký:

{
  "url": "https://crm.example.com/hubz/webhook",
  "events": ["message.created", "conversation.updated"],
  "secret": "…"
}

Gửi thử một sự kiện ping, kết quả trả về ngay:

curl -X POST https://api.hubz.vn/v1/webhook/test \
  -H "Authorization: Bearer hbz_live_xxx"

{"ok": true, "status": 200, "error": null}

Tiếp theo

• Webhook: các sự kiện, thử lại, kiểm chữ ký với code mẫu.
• Lấy sự kiện bị lỡ khi phần mềm không nhận được webhook.
• API reference: mọi endpoint.