> ## 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 Drip

> Kết nối Drip với ChatbotX để tạo hoặc cập nhật subscriber từ dữ liệu Contact khi action chạy trong Flow.

Tích hợp **Drip** giúp bạn tạo hoặc cập nhật Person từ dữ liệu Contact ngay trong Flow. Action dùng email để nhận diện khách, đồng thời có thể đồng bộ số điện thoại, Tags và Custom Fields sang Drip.

Ví dụ: sau khi khách đăng ký nhận tư vấn sản phẩm, ChatbotX gửi email, số điện thoại và nhu cầu của khách sang Drip để bạn phân nhóm và cá nhân hóa nội dung Email Marketing.

## Chuẩn bị API Token

Bạn cần lấy **API Token** trong Drip trước khi kết nối. Token này xác thực tài khoản user và cho phép ChatbotX gửi dữ liệu Contact sang các Account mà user có quyền truy cập.

<Steps>
  <Step title="Đăng nhập Drip">
    Đăng nhập bằng user có quyền truy cập Account mà bạn muốn kết nối với ChatbotX.
  </Step>

  <Step title="Mở User Settings">
    Trong Drip, chọn **Settings > User Settings** để mở phần cài đặt của user.
  </Step>

  <Step title="Mở User Info">
    Chọn tab **Settings**, sau đó chọn **User Info** trong menu bên trái.
  </Step>

  <Step title="Sao chép API Token">
    Tìm trường **API Token** ở cuối trang và nhấn biểu tượng sao chép. Nếu API chưa được bật cho tài khoản, hãy liên hệ bộ phận hỗ trợ Drip.

    Xem hướng dẫn chính thức tại [User Settings: Settings and API Token](https://help.drip.com/hc/en-us/articles/4424695636237-User-Settings-Settings-and-API-Token).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kD96VU4ZqlnYUPJ5/images/drip_api_token_user_settings.png?fit=max&auto=format&n=kD96VU4ZqlnYUPJ5&q=85&s=41b9b9be07de03def526e573ec97731c" alt="Drip Api Token User Settings" width="2107" height="1776" data-path="images/drip_api_token_user_settings.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  API Token là thông tin bí mật và gắn với user Drip. Khi tạo token mới, token cũ ngừng hoạt động và bạn phải cập nhật lại kết nối trong ChatbotX.
</Warning>

## Kết nối Drip 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 **Drip**.
  </Step>

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

  <Step title="Nhập API Token">
    Dán token Drip vào trường **API Token**, sau đó nhấn **Confirm**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kD96VU4ZqlnYUPJ5/images/connect_drip_in_chatbotx_integrations.png?fit=max&auto=format&n=kD96VU4ZqlnYUPJ5&q=85&s=c170e1339232ab54c2dc0b9d439dd8fa" alt="Connect Drip In Chatbotx Integrations" width="3188" height="1551" data-path="images/connect_drip_in_chatbotx_integrations.png" />
    </Frame>
  </Step>
</Steps>

Khi token hợp lệ, ChatbotX lưu kết nối và tải các Account cùng Tags mà user Drip có quyền sử dụng trong Flow.

## Thêm Drip vào Flow

Hãy đặt action Drip sau bước thu thập email và các dữ liệu bạn muốn đồng bộ. Email là dữ liệu bắt buộc để Drip nhận diện Person.

<Steps>
  <Step title="Mở Flow cần chỉnh sửa">
    Chọn **Flows**, sau đó mở Flow mà bạn muốn dùng để thu thập Contact.
  </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 Drip**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/kD96VU4ZqlnYUPJ5/images/select_add_contact_to_drip_action.png?fit=max&auto=format&n=kD96VU4ZqlnYUPJ5&q=85&s=1c7997dac6a837a2ca33a258b0986cca" alt="Select Add Contact To Drip Action" width="3186" height="1886" data-path="images/select_add_contact_to_drip_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 Account và đồng bộ dữ liệu Contact.
  </Step>
</Steps>

## Cấu hình Add Contact to Drip

Thiết lập các trường trong cửa sổ **Drip**, sau đó nhấn **Save**.

| Trường                    | Cách thiết lập                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Account**               | Chọn Drip Account sẽ nhận Person. Nếu user có quyền truy cập nhiều Account, hãy kiểm tra đúng doanh nghiệp trước khi lưu. |
| **Email Field**           | Chọn trường ChatbotX đang lưu email của khách. Drip dùng email để tạo Person mới hoặc xác định Person đã tồn tại.         |
| **Phone**                 | Chọn trường số điện thoại cần đồng bộ sang hồ sơ Drip. Trường này không bắt buộc.                                         |
| **Tags**                  | Chọn một hoặc nhiều Tags để phân loại Person trong Drip. Trường này không bắt buộc.                                       |
| **Custom Fields in Drip** | Nhấn **+ Add Custom Field** để đồng bộ dữ liệu từ trường ChatbotX sang Custom Field tương ứng trong Drip.                 |

<Frame>
  <img src="https://mintcdn.com/chatbotx/kD96VU4ZqlnYUPJ5/images/configure_add_contact_to_drip.png?fit=max&auto=format&n=kD96VU4ZqlnYUPJ5&q=85&s=948bb84bfc44e79c5e6bd8fcb832608d" alt="Configure Add Contact To Drip" width="3186" height="1885" data-path="images/configure_add_contact_to_drip.png" />
</Frame>

Action hiển thị hai kết quả để bạn tiếp tục Flow:

* **Success**: Drip đã xử lý yêu cầu tạo hoặc cập nhật Person.
* **Error**: Yêu cầu thất bại do email, API Token, Account hoặc dữ liệu đồng bộ không hợp lệ.

Bạn có thể nối mỗi kết quả với một node khác để gửi xác nhận hoặc xử lý lỗi.

<Note>
  Action **Add Contact to Drip** không tự thêm Person vào Workflow. Bạn có thể dùng Tags hoặc Custom Fields làm điều kiện kích hoạt trong Drip nếu đã cấu hình Automation tương ứng.
</Note>

## Ví dụ thu thập khách cần tư vấn sản phẩm

Một cửa hàng thời trang muốn lưu khách đang quan tâm đến sản phẩm và phân loại theo nhu cầu.

<Steps>
  <Step title="Thu thập thông tin khách">
    Dùng Get User Data để hỏi email, số điện thoại và loại sản phẩm khách quan tâm.
  </Step>

  <Step title="Thêm Person vào Drip">
    Chạy **Add Contact to Drip**, chọn đúng Account, trường **Email** và trường **Phone**.
  </Step>

  <Step title="Đồng bộ nhu cầu của khách">
    Gắn Tag phù hợp và đồng bộ loại sản phẩm vào Custom Field trong Drip.
  </Step>

  <Step title="Xử lý kết quả">
    Nối **Success** với tin nhắn xác nhận. Nối **Error** với nhánh yêu cầu khách kiểm tra lại thông tin hoặc chuyển cho nhân viên.
  </Step>
</Steps>

## 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ở **People** trong đúng Drip Account và xác nhận Person xuất hiện.
* Kiểm tra email, số điện thoại, Tags và Custom Fields đã nhận đúng dữ liệu.
* Kiểm tra Flow đi qua nhánh **Success** khi email hợp lệ.
* Thử một email sai định dạng để kiểm tra nhánh **Error**.
* Nếu Account hoặc Tags không hiển thị, kiểm tra lại quyền user rồi kết nối lại.
* Nếu API Token không còn hợp lệ, sao chép token hiện tại và cập nhật kết nối trong ChatbotX.

<Warning>
  Chỉ gửi Contact sang Drip để tiếp thị khi khách đã đồng ý nhận thông tin. Việc tạo hoặc cập nhật Person không thay thế quy trình xin phép và xử lý yêu cầu hủy đăng ký.
</Warning>