> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tích hợp ActiveCampaign

> Kết nối ActiveCampaign với ChatbotX để tạo hoặc cập nhật liên hệ, gắn Tag, thêm vào List hoặc Automation từ Flow.

Tích hợp **ActiveCampaign** giúp bạn gửi thông tin liên hệ từ ChatbotX sang ActiveCampaign ngay trong Flow. Bạn có thể tạo hoặc cập nhật liên hệ, thêm khách vào danh sách, gắn Tag và đưa khách vào một Automation.

Ví dụ: sau khi khách để lại email để nhận tư vấn, ChatbotX tạo liên hệ trong ActiveCampaign, thêm Tag `NEW` và đưa khách vào chuỗi email chăm sóc phù hợp.

## Chuẩn bị API URL và API Key

Bạn cần **API URL** và **API Key** của tài khoản ActiveCampaign trước khi kết nối. Hai thông tin này cho phép ChatbotX gửi dữ liệu liên hệ sang đúng tài khoản của bạn.

<Steps>
  <Step title="Đăng nhập ActiveCampaign">
    Đăng nhập tài khoản ActiveCampaign mà bạn muốn kết nối với ChatbotX.
  </Step>

  <Step title="Mở Developer Settings">
    Chọn **Settings** ở góc dưới bên trái, sau đó chọn **Developer** trong menu cài đặt tài khoản.
  </Step>

  <Step title="Sao chép thông tin API">
    Sao chép cả **API URL** và **API Key** trong phần API Access. Bạn sẽ nhập hai giá trị này vào ChatbotX ở bước tiếp theo.

    Xem hướng dẫn chính thức tại [Getting started with the API](https://help.activecampaign.com/hc/en-us/articles/207317590-Getting-started-with-the-API).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/m1KhKPOSptGzQPOL/images/activecampaign_developer_settings_api_credentials.png?fit=max&auto=format&n=m1KhKPOSptGzQPOL&q=85&s=c869b8569e55a421d84ddaa8941b737e" alt="Activecampaign Developer Settings Api Credentials" width="3328" height="1882" data-path="images/activecampaign_developer_settings_api_credentials.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  API Key cho phép ứng dụng khác truy cập dữ liệu ActiveCampaign của bạn. Không chia sẻ khóa trong tin nhắn, ảnh chụp công khai hoặc tài liệu dành cho khách hàng.
</Warning>

Mỗi người dùng ActiveCampaign có API URL và API Key riêng. Nếu người dùng cung cấp khóa bị xóa hoặc khóa được đặt lại, bạn cần cập nhật thông tin kết nối trong ChatbotX.

## Kết nối ActiveCampaign với ChatbotX

<Steps>
  <Step title="Mở Settings">
    Trong workspace ChatbotX, chọn **Settings** từ menu bên trái.
  </Step>

  <Step title="Chọn Integrations">
    Chọn tab **Integrations**, sau đó mở mục **ActiveCampaign**.
  </Step>

  <Step title="Mở cửa sổ kết nối">
    Nhấn **Connect** để mở cửa sổ **Connect ActiveCampaign**.
  </Step>

  <Step title="Nhập thông tin API">
    Dán địa chỉ vào trường **API URL** và khóa vào trường **API Key**. API URL thường có dạng `https://youraccount.api-us1.com`.
  </Step>

  <Step title="Xác nhận kết nối">
    Nhấn **Confirm**. Khi thông tin hợp lệ, ChatbotX lưu kết nối để bạn sử dụng ActiveCampaign trong Flow.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/m1KhKPOSptGzQPOL/images/connect_activecampaign_in_chatbotx_integrations.png?fit=max&auto=format&n=m1KhKPOSptGzQPOL&q=85&s=c3782b8fc1b8d35c86eb42819f278e62" alt="Connect Activecampaign In Chatbotx Integrations" width="3182" height="1496" data-path="images/connect_activecampaign_in_chatbotx_integrations.png" />
    </Frame>
  </Step>
</Steps>

## Thêm ActiveCampaign vào Flow

Sau khi kết nối, bạn có thể thêm action ActiveCampaign vào một Send Message node hoặc vị trí phù hợp trong Flow.

<Steps>
  <Step title="Mở Flow cần chỉnh sửa">
    Chọn **Flows**, sau đó mở Flow mà bạn muốn dùng để đồng bộ liên hệ.
  </Step>

  <Step title="Thêm Actions">
    Trong Send Message node, nhấn **+ Create** rồi chọn **Actions**.
  </Step>

  <Step title="Chọn Email Actions">
    Mở **Email Actions** và chọn **Add Contact to ActiveCampaign**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/m1KhKPOSptGzQPOL/images/select_add_contact_to_activecampaign_action.png?fit=max&auto=format&n=m1KhKPOSptGzQPOL&q=85&s=485e7759e1e0b66d203de7483c083e85" alt="Select Add Contact To Activecampaign Action" width="3182" height="1892" data-path="images/select_add_contact_to_activecampaign_action.png" />
    </Frame>
  </Step>

  <Step title="Mở phần cấu hình">
    Nhấn **Edit** trên action vừa thêm để chọn operation và ánh xạ dữ liệu liên hệ.
  </Step>
</Steps>

## Tạo hoặc cập nhật liên hệ

Chọn operation **Create or Update Contact** khi bạn muốn gửi dữ liệu khách từ ChatbotX sang ActiveCampaign. Nếu email đã tồn tại, ActiveCampaign cập nhật liên hệ đó thay vì tạo bản ghi trùng lặp.

| Trường                              | Cách thiết lập                                                                                             |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Email Field**                     | Chọn trường ChatbotX đang lưu email của khách. Đây là dữ liệu dùng để xác định liên hệ.                    |
| **Phone**                           | Chọn trường số điện thoại nếu bạn muốn đồng bộ thêm thông tin này.                                         |
| **List**                            | Chọn một hoặc nhiều danh sách ActiveCampaign mà liên hệ sẽ tham gia.                                       |
| **Tags**                            | Chọn Tag ActiveCampaign cần gắn cho liên hệ, ví dụ `NEW` hoặc `Fashion Lead`.                              |
| **Custom Fields in ActiveCampaign** | Nhấn **+ Add custom field** để ánh xạ Custom Field của ChatbotX với trường tương ứng trong ActiveCampaign. |

Nhấn **Save** để lưu action.

<Frame>
  <img src="https://mintcdn.com/chatbotx/m1KhKPOSptGzQPOL/images/configure_activecampaign_create_or_update_contact.png?fit=max&auto=format&n=m1KhKPOSptGzQPOL&q=85&s=f540eb427ce6a41bea0e9dd14601a4f5" alt="Configure Activecampaign Create Or Update Contact" width="3181" height="1894" data-path="images/configure_activecampaign_create_or_update_contact.png" />
</Frame>

<Note>
  Hãy thu thập email bằng Get User Data trước khi action chạy. Nếu trường email trống hoặc sai định dạng, ChatbotX không thể tạo đúng liên hệ trong ActiveCampaign.
</Note>

## Thêm liên hệ vào Automation

Chọn operation **Add Contact to Automation** khi bạn muốn đưa một liên hệ đã có email vào chuỗi tự động hóa của ActiveCampaign.

<Steps>
  <Step title="Chọn operation">
    Trong trường **Operation**, chọn **Add Contact to Automation**.
  </Step>

  <Step title="Chọn trường email">
    Trong **Email Field**, chọn trường ChatbotX chứa email của khách.
  </Step>

  <Step title="Chọn Automation">
    Trong **Automation**, chọn chuỗi ActiveCampaign mà khách cần tham gia, sau đó nhấn **Save**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/m1KhKPOSptGzQPOL/images/configure_add_contact_to_activecampaign_automation.png?fit=max&auto=format&n=m1KhKPOSptGzQPOL&q=85&s=d04705a3507804eb01646c2784169615" alt="Configure Add Contact To Activecampaign Automation" width="3184" height="1897" data-path="images/configure_add_contact_to_activecampaign_automation.png" />
    </Frame>
  </Step>
</Steps>

Ví dụ: khách yêu cầu nhận bộ sưu tập mới qua email. Sau khi khách nhập địa chỉ email, Flow tạo hoặc cập nhật liên hệ, rồi thêm khách vào Automation gửi email giới thiệu sản phẩm.

## Kiểm tra hoạt động của tích hợp

Trước khi Publish Flow, hãy chạy thử bằng một địa chỉ email mà bạn có thể kiểm tra.

* Mở **Contacts** trong ActiveCampaign và xác nhận liên hệ đã được tạo hoặc cập nhật.
* Kiểm tra List, Tags và Custom Fields đã nhận đúng dữ liệu.
* Nếu dùng **Add Contact to Automation**, kiểm tra liên hệ đã xuất hiện trong Automation đã chọn.
* Nếu kết nối thất bại, sao chép lại API URL và API Key từ **Settings > Developer** rồi kết nối lại.

<Warning>
  Việc đặt lại API Key trong ActiveCampaign làm kết nối hiện tại ngừng hoạt động. Sau khi đặt lại khóa, hãy cập nhật API Key mới trong ChatbotX.
</Warning>