• Hướng dẫn kết nối
  • BowNow
  • HexaSync

Hướng dẫn bắt đầu với BowNow trên HexaSync

Kết nối tracking code BowNow với HexaSync bằng Tracking ID và API Key để đọc dữ liệu lead, thêm webhook, cấp lại quyền và xử lý lỗi.

HexaSync Team

Hướng dẫn này giúp bạn kết nối BowNow với HexaSync Automation Engine để đồng bộ danh sách lead từ tracking code BowNow. Connector App đọc toàn bộ lead hiện có khi kết nối lần đầu, sau đó cập nhật mỗi giờ, hoặc cập nhật theo thời gian thực qua webhook nếu bạn cấu hình. Dữ liệu được dùng để đánh giá chất lượng dữ liệu trước khi kết nối với hệ thống khác.

Chuẩn bị trước khi bắt đầu

Lưu ý: Mỗi tracking code cần một Connector App riêng. Nếu cần đồng bộ nhiều tracking code, hãy kết nối từng tracking code riêng.

Phần 1: Kết nối BowNow với HexaSync

Bước 1: Đăng nhập HexaSync

  1. Truy cập HexaSync Automation Engine.
  2. Đăng nhập bằng tài khoản Beehexa.

Bước 2: Mở template BowNow Connector

  1. Mở Link thiết lập BowNow Connector.
  2. Trên thẻ BowNow, chọn Connect.

Bước 3: Lấy Tracking ID và API Key

  1. Đăng nhập BowNow và mở Settings ▸ Configure System của tracking code cần đồng bộ.
  2. Sao chép Tracking ID.
  3. Sao chép API Key nằm cạnh Tracking ID.

Hai giá trị phải thuộc cùng một tracking code. Nếu lấy Tracking ID và API Key từ hai tracking code khác nhau, BowNow sẽ từ chối kết nối.

Bước 4: Nhập thông tin kết nối BowNow

  1. Quay lại HexaSync và điền:

    TrườngGiá trị
    Tracking IDDán Tracking ID đã sao chép
    Tracking Code NameNhập tên tracking code, ví dụ Acme Corp. HexaSync dùng tên này để gợi ý tên Connector App ở bước sau
    API KeyDán API Key đã sao chép

  2. Chọn Continue.

Lưu ý: HexaSync không hiển thị lại API Key đã lưu. Nếu kết nối lại cùng tracking code, bạn cần nhập API Key một lần nữa.

Bước 5: Cấu hình webhook trong BowNow

HexaSync hiển thị một webhook URL. Nếu muốn nhận thay đổi theo thời gian thực, hãy thêm URL này vào cấu hình webhook của đúng tracking code trong BowNow. Bước này không bắt buộc: không có webhook thì HexaSync vẫn cập nhật dữ liệu mỗi giờ một lần.

  1. Sao chép webhook URL trên màn hình HexaSync.
  2. Trong BowNow, mở Settings ▸ Configure Webhook của tracking code đang kết nối.
  3. Tạo webhook mới, dán URL vào trường URL và chọn các sự kiện muốn đồng bộ.
  4. Lưu cấu hình trong BowNow. Bạn không cần dán giá trị nào ngược lại HexaSync.
  5. Quay lại HexaSync và chọn Continue.

Bước 6: Xác nhận kết nối BowNow

  1. Khi dòng BowNow hiển thị trạng thái Connected, chọn Create BowNow Connector.

Kết nối lại cùng một tracking code? HexaSync cập nhật đúng kết nối cũ, không tạo thêm kết nối mới. Bạn phải nhập lại API Key vì HexaSync không hiển thị lại key đã lưu.

Bước 7: Tạo Connector App

  1. Kiểm tra Name và Description được đề xuất, chỉnh sửa nếu cần.
  2. Chọn Continue.
  3. Giữ trang mở cho đến khi HexaSync chuyển sang trang Connector App. Quá trình tạo Connector App có thể mất vài phút.

Connector App mới có tác vụ [BowNow] Leads. Tiếp tục kiểm tra trạng thái kết nối và dữ liệu theo Phần 3.

Phần 2: Cấp lại quyền kết nối BowNow

Cấp lại quyền khi HexaSync không còn lấy được lead bằng API Key cũ, ví dụ:

  • API Key của tracking code đã được đổi trong BowNow.
  • Tác vụ [BowNow] Leads báo lỗi xác thực và không lấy thêm dữ liệu.

Bạn cần API Key mới và Tracking ID của chính tracking code đang kết nối. Cách lấy giống Bước 3 của Phần 1.

Bước 1: Mở phần cài đặt Connector App

  1. Mở Connector Apps, chọn BowNow Connector App cần cấp lại quyền.
  2. Chọn Settings ở menu bên trái.
  3. Ở mục Connected Apps & Credentials, chọn Re-authorize trên dòng BowNow. Dòng System key ngay bên dưới cho biết Tracking ID đang được dùng.

Không thực hiện được Re-authorize? Thao tác này chỉ hiển thị với người tạo Connector App hoặc người có quyền quản trị Connector App. Hãy nhờ người có quyền phù hợp thực hiện.

Bước 2: Nhập lại thông tin kết nối

HexaSync hiển thị các trường thông tin trống vì không hiển thị lại API Key đã lưu.

  1. Nhập Tracking ID hiện tại, Tracking Code Name và API Key mới.
  2. Chọn Continue.

Lưu ý: Giữ nguyên Tracking ID. Để đồng bộ tracking code khác, hãy tạo Connector App mới.

Bước 3: Lưu webhook URL

Màn hình webhook URL hiện lại. URL không đổi so với lần kết nối đầu.

  1. Nếu đã tạo webhook trong BowNow, bạn không cần làm gì thêm. Nếu chưa, làm theo Bước 5 của Phần 1.
  2. Chọn Continue.

Bước 4: Kiểm tra kết quả

HexaSync lưu API Key mới vào Connector App, rồi đưa bạn về trang Tasks.

  • Ở Settings, dòng BowNow hiển thị Connected.
  • Lần cập nhật kế tiếp, trong vòng một giờ, sẽ dùng API Key mới.
  • Lead đã đồng bộ trước đó vẫn giữ nguyên.

Phần 3: Kiểm tra kết nối thành công

Kiểm tra thông tin kết nối

  1. Mở Connector Apps.
  2. Chọn BowNow Connector App vừa tạo, sau đó mở Settings.
  3. Trong Connected Apps & Credentials, xác nhận dòng BowNow có trạng thái Connected.
  4. Kiểm tra Connector App có tác vụ [BowNow] Leads.

Kiểm tra dữ liệu

  • Lần đồng bộ đầu tiên, Connector App lấy toàn bộ lead hiện có trong tracking code.
  • Sau đó, dữ liệu cập nhật mỗi giờ nếu không cấu hình webhook. Nếu đã cấu hình webhook, thay đổi được cập nhật theo thời gian thực theo các sự kiện đã chọn trong BowNow.
  • Dữ liệu được đồng bộ gồm họ tên, email, số điện thoại, tên và thông tin công ty, địa chỉ, trạng thái, nhóm theo dõi, ngày tạo và ngày cập nhật của lead.

Lưu ý: Connector App chỉ đọc dữ liệu lead từ BowNow, không tạo hoặc sửa dữ liệu trong BowNow.

Phần 4: Lỗi thường gặp và cách xử lý

Thông báoCách xử lý
HexaSync Could Not Connect Your BowNow Tracking CodeĐọc dòng mô tả ngay trên màn hình để biết nguyên nhân. Thường gặp: Tracking ID hoặc API Key bị dư khoảng trắng, hai giá trị không cùng một tracking code, hoặc API Key đã bị đổi trong BowNow. Chọn Back to installation rồi nhập lại.
BowNow refused the token request: request quota exceededTracking code đã dùng hết hạn mức gọi API trong ngày. Chờ một lúc rồi kết nối lại.
Could not reach https://api.bownow.jp/v1/auth/tokenBowNow đang không truy cập được. Thử lại sau vài phút.
The name already existsĐặt tên Connector App khác.
Connector Quota ReachedLiên hệ support@beehexa.com để tăng hạn mức.
Couldn’t Start Connector Creation / Connector Creation FailedGửi ảnh chụp màn hình đến support@beehexa.com.
Connector Creation Is Taking Longer Than ExpectedChờ thêm vài phút. Nếu Connector App vẫn chưa xuất hiện, gửi Job ID trên màn hình đến support@beehexa.com.

Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che thông tin bảo mật) đến support@beehexa.com.

Phần 5: Câu hỏi thường gặp

HexaSync có ghi hoặc sửa dữ liệu trên BowNow không?

Không. BowNow Connector App chỉ đọc dữ liệu lead trong BowNow, không tạo hoặc sửa dữ liệu.

HexaSync lấy những dữ liệu nào từ BowNow?

HexaSync lấy thông tin lead: họ tên, email, số điện thoại, tên và thông tin công ty, địa chỉ, trạng thái, nhóm theo dõi, ngày tạo và ngày cập nhật.

Tracking ID và API Key có thể lấy từ hai tracking code khác nhau không?

Không. Hai giá trị phải thuộc cùng một tracking code; nếu không, BowNow sẽ từ chối kết nối.

Mỗi tracking code cần một Connector App riêng không?

Có. Mỗi Connector App kết nối với một tracking code. Để đồng bộ tracking code khác, hãy tạo Connector App mới.

Có bắt buộc phải cấu hình webhook không?

Không. Webhook là tùy chọn. Khi không cấu hình webhook, HexaSync vẫn cập nhật dữ liệu mỗi giờ. Nếu có webhook, dữ liệu được cập nhật theo thời gian thực khi có thay đổi. Xem cách thêm ở Bước 5.

Khi nào cần cấp lại quyền kết nối BowNow?

Cấp lại quyền khi API Key thay đổi hoặc tác vụ [BowNow] Leads báo lỗi xác thực và ngừng nhận dữ liệu. Làm theo Phần 2.

Đã sao chép link!
Hướng dẫn kết nốiBắt đầu kết nối BowNow