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

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

Kết nối OplaGO với HexaSync bằng API key chỉ đọc để đọc lead và liên hệ, thêm webhook để cập nhật theo thời gian thực, 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 OplaGO với HexaSync Automation Engine để đọc dữ liệu lead và liên hệ từ OplaGO. Bạn cần tạo API key trong OplaGO và cấu hình webhook để HexaSync nhận thay đổi theo thời gian thực.

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

  • Tài khoản Beehexa để đăng nhập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
  • Tài khoản OplaGO tại go.oplacrm.com. HexaSync chỉ thấy được những bản ghi mà người dùng này thấy, nên hãy dùng tài khoản xem được toàn bộ lead và liên hệ bạn cần.
  • Quyền mở Company settings trong OplaGO để thêm webhook. Nếu bạn không có quyền này, nhờ quản trị viên OplaGO làm bước thêm webhook.

Lưu ý: Connector này chỉ đọc lead và liên hệ. HexaSync không lấy đơn hàng, hóa đơn hay bất kỳ dữ liệu thanh toán nào từ OplaGO.

Phần 1: Cấp quyền kết nối OplaGO trên HexaSync

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

  1. Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa.
  2. Mở Templates.

Bước 2: Bắt đầu kết nối OplaGO

  1. Mở trang thiết lập OplaGo Connector.
  2. Trên dòng OplaGO, chọn Connect.

Nếu OplaGO đã được kết nối trước đó, HexaSync sẽ hiển thị màn hình Choose an app to connect to OplaGO:

  • Để tiếp tục dùng API key hiện tại, giữ lựa chọn Connector App đó và chọn Continue, sau đó chuyển đến Bước 5: Thêm webhook trong OplaGO.
  • Để dùng API key khác, chọn Use a different app, rồi chọn I will enter my OplaGO API key.

Bước 3: Tạo API key trong OplaGO

  1. Mở tab mới, đăng nhập OplaGO bằng tài khoản đã chọn.

  2. Chọn ảnh đại diện ở góc trên bên phải, chọn Personal Settings, sau đó chọn API Keys & MCP.

  3. Chọn Create new API key và điền:

    TrườngGiá trị
    Key name
    HexaSync
    Read-only keyBật
    No expiryBật, để API key không hết hạn

  4. Chọn Create.

  5. Sao chép Client_id và Secret key, lưu ở nơi an toàn.

Lưu ý: OplaGO chỉ hiện Secret key một lần. Nếu đóng cửa sổ trước khi sao chép, hãy tạo API key mới. Secret key có giá trị như mật khẩu, không chia sẻ cho người khác.

Bước 4: Nhập API key vào HexaSync

  1. Quay lại HexaSync.
  2. Dán Client_id vào trường Client ID và Secret key vào trường Secret Key, sau đó chọn Continue.

Bước 5: Thêm webhook trong OplaGO

Màn hình tiếp theo cho bạn Your HexaSync Webhook URL và Your Webhook Secret Key. Bạn dùng hai giá trị này để tạo webhook trong OplaGO, giúp HexaSync nhận thay đổi của lead và liên hệ theo thời gian thực.

  1. Sao chép Your HexaSync Webhook URL và Your Webhook Secret Key, lưu ở nơi an toàn.

  2. Trong OplaGO, mở Company settings, chọn Integration › Webhook, rồi mở tab Configurations.

  3. Chọn Add new và điền:

    TrườngGiá trị
    Endpoint URLDán Your HexaSync Webhook URL, đủ cả đường dẫn
    Method
    POST
    Event typeChọn một sự kiện trong bảng ở thao tác 5
    Secret KeyDán Your Webhook Secret Key, không để dư khoảng trắng
    StatusBật Active
    Description
    HexaSync

  4. Chọn Save.

  5. Lặp lại thao tác 3 và 4 cho từng sự kiện sau. Mỗi sự kiện là một webhook riêng, tất cả dùng chung Endpoint URL và Secret Key.

    Dữ liệuEvent type
    LeadCreate Lead, Update Lead
    Liên hệCreate Contact, Update Contact

  6. Quay lại HexaSync, kéo xuống cuối màn hình và chọn I have set up the webhooks in OplaGO — continue.

Lưu ý:

  • Bạn vẫn có thể tiếp tục nếu chưa thể thêm webhook ngay. Khi chưa có webhook, dữ liệu vẫn được cập nhật mỗi giờ. Để xem lại Webhook URL và Webhook Secret Key, hãy cấp lại quyền theo Phần 2 và giữ nguyên API key đang dùng.
  • Nếu công ty đã đổi tên đối tượng trong OplaGO, tên trong danh sách Event type cũng thay đổi. Hãy chọn sự kiện Create và Update tương ứng với Lead và Contact.

Bước 6: Khởi tạo OplaGo Connector

  1. Khi dòng OplaGO hiện Connected, chọn Create OplaGo Connector.

  2. Kiểm tra tên Connector được đề xuất, ví dụ [Acme Corp] OplaGo Connector, sửa nếu cần, rồi chọn Continue.

  3. Việc tạo Connector mất vài phút. Giữ nguyên trang cho đến khi HexaSync tự chuyển sang trang Tasks của Connector.

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

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

  • API key đã bị thu hồi (Revoke) hoặc đã hết hạn trong OplaGO.
  • Người dùng OplaGO sở hữu API key đã nghỉ việc hoặc bị khóa tài khoản.
  • Bạn muốn HexaSync dùng API key của người dùng khác.

Bạn cũng dùng cách này để xem lại Webhook URL và Webhook Secret Key.

Bước 1: Mở Settings của Connector

  1. Mở Connector Apps, chọn OplaGo Connector.
  2. Chọn Settings ở menu bên trái.
  3. Ở mục Connected Apps & Credentials, chọn Re-authorize trên dòng OplaGO.

Không thực hiện được Re-authorize? Chỉ người tạo Connector App hoặc người có vai trò quản trị Connector App mới thấy nút này. Hãy nhờ một trong những người đó thực hiện.

Bước 2: Chọn API key

  • Để tiếp tục dùng API key hiện tại, giữ nguyên lựa chọn và chọn Continue.
  • Để dùng API key mới, tạo key theo Bước 3 ở Phần 1, chọn Use a different app, rồi chọn I will enter my OplaGO API key. Nhập Client ID và Secret Key mới, sau đó chọn Continue.

Bước 3: Kiểm tra webhook

Màn hình hiện lại Your HexaSync Webhook URL và Your Webhook Secret Key.

  1. So sánh Your Webhook Secret Key với Secret Key của các webhook trong OplaGO. Nếu khác, cập nhật Secret Key của từng webhook.
  2. Nếu chưa cấu hình webhook, thực hiện theo Bước 5 ở Phần 1.
  3. Kéo xuống cuối màn hình và chọn I have set up the webhooks in OplaGO — continue.

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

  • HexaSync lưu API key vào Connector App và mở lại trang Tasks.
  • Trong Settings, xác nhận dòng OplaGO có trạng thái Connected.
  • Lần cập nhật tiếp theo sẽ dùng API key mới trong vòng một giờ. Dữ liệu đã lấy trước đó vẫn được 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 và chọn OplaGO Connector App vừa tạo.
  2. Chọn Settings.
  3. Trong Connected Apps & Credentials, xác nhận dòng OplaGO có trạng thái Connected.

Kiểm tra dữ liệu

Trang Tasks của Connector mới có hai tác vụ: [OplaGO] Leads và [OplaGO] Contacts.

  • Trong vòng một giờ, HexaSync lấy lead và liên hệ lần đầu.
  • Sau đó, dữ liệu tự cập nhật mỗi giờ. Nếu bạn đã thêm webhook, lead và liên hệ được cập nhật theo thời gian thực khi có thay đổi.
  • Mỗi bản ghi giữ đầy đủ thông tin OplaGO trả về: tên, chức danh, tên khách hàng, số điện thoại, email, địa chỉ, nguồn, trạng thái, người phụ trách, điểm số, trường tùy chỉnh và ngày tạo.

Lưu ý: HexaSync chỉ đọc dữ liệu, không thay đổi gì trong OplaGO.

Kiểm tra webhook

  1. Trong OplaGO, tạo hoặc sửa một lead thử.
  2. Mở Company settings › Integration › Webhook, sau đó chọn tab Delivery logs.
  3. Xác nhận sự kiện vừa tạo có trạng thái SENT hoặc PUBLISHED. Nếu trạng thái là FAILED, kiểm tra lại Endpoint URL và Secret Key của webhook.

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

HexaSync Could Not Connect Your OplaGO API Key

Client ID hoặc Secret Key không đúng.

  1. Sao chép lại từ OplaGO, kiểm tra không dán nhầm ô.
  2. Chọn Back to the API key details và nhập lại.

OplaGO Did Not Issue An Access Token

API key đã bị thu hồi hoặc hết hạn.

  1. Tạo API key mới trong OplaGO theo Bước 3 ở Phần 1.
  2. Chọn Fix my details and try again, chọn I will enter my OplaGO API key và nhập key mới.

Các lỗi khác

Thông báoCách xử lý
This API key is already registered to another accountAPI key này đã được người khác kết nối. Nhờ họ chia sẻ, hoặc tạo API key mới.
HexaSync Could Not Give You An OplaGO Webhook URLKết nối đã được lưu, chọn Continue để tiếp tục. Gửi ảnh chụp màn hình đến support@beehexa.com để nhận Webhook URL.
The name already existsĐặt tên Connector khác.
Connector Quota ReachedLiên hệ support@beehexa.com để tăng hạn mức.
HexaSync Could Not Link The Credential To Your ProfileAPI key đã được lưu nhưng chưa gắn vào Connector. Chọn Go to Manage Credentials và gắn key vào Connector, hoặc liên hệ support@beehexa.com.
Webhook trong OplaGO báo FAILEDKiểm tra Endpoint URL đã dán đủ và Secret Key giống Your Webhook Secret Key.

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 OplaGO không?

Không. Mọi lệnh gọi đến OplaGO đều là lệnh đọc, nên một API key chỉ đọc là đủ.

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

Chỉ lead và liên hệ, nhưng giữ đầy đủ các trường OplaGO trả về cho hai loại này: tên, chức danh, tên khách hàng, số điện thoại, email, địa chỉ, nguồn, trạng thái, người phụ trách, điểm số, trường tùy chỉnh và ngày tạo.

Dữ liệu lead và liên hệ được lưu như thế nào?

Đúng như OplaGO trả về, không chỉnh sửa gì. HexaSync chỉ thấy những bản ghi mà tài khoản OplaGO bạn dùng để kết nối nhìn thấy được.

Vì sao Connector không có đơn hàng và hóa đơn?

Connector này chỉ để xác nhận kết nối đến OplaGO của bạn hoạt động, nên nó chỉ đọc hai loại dữ liệu cơ bản. Đơn hàng, hóa đơn và dữ liệu thanh toán không được lấy.

Cần thêm bao nhiêu webhook trong OplaGO?

Cần 4 webhook: Create Lead, Update Lead, Create Contact và Update Contact. Tất cả dùng chung Endpoint URL và Secret Key. Xem cách thêm ở Bước 5.

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

Khi API key bị thu hồi hoặc hết hạn, khi người sở hữu key nghỉ việc, khi bạn muốn dùng key của người khác, hoặc khi bạn cần xem lại Webhook URL và Webhook Secret Key. Làm theo Phần 2.

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