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

> Kết nối GetResponse với ChatbotX để thêm liên hệ vào List, gắn Tag và chọn ngày bắt đầu trong chu kỳ Autoresponder từ Flow.

Tích hợp **GetResponse** giúp bạn gửi liên hệ từ ChatbotX sang một List trong GetResponse ngay khi khách đi đến action trong Flow. Bạn có thể chọn trường email, gắn Tag và đưa khách vào một ngày cụ thể trong chu kỳ Autoresponder.

Ví dụ: sau khi khách nhập email để nhận ưu đãi, ChatbotX thêm khách vào List `Contacts`, gắn Tag `NEW` và bắt đầu chuỗi email chào mừng từ ngày 0.

## Chuẩn bị API Key

Bạn cần tạo một **API Key** trong GetResponse trước khi kết nối. Khóa này cho phép ChatbotX gửi dữ liệu liên hệ vào tài khoản của bạn.

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

  <Step title="Mở Integrations and API">
    Chọn **Tools**, sau đó chọn **Integrations and API** và mở tab **API**.
  </Step>

  <Step title="Tạo API Key">
    Nhấn **Generate API key**, nhập tên giúp bạn nhận biết khóa, ví dụ `ChatbotX Integration`, rồi tạo khóa.
  </Step>

  <Step title="Sao chép API Key">
    Sao chép khóa và lưu ở nơi an toàn. GetResponse không hiển thị lại khóa sau khi bạn đóng cửa sổ.

    Xem hướng dẫn chính thức tại [Where to find the API key?](https://www.getresponse.com/help/where-do-i-find-the-api-key.html).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/getresponse_api_key_settings.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=191b358cc562d297ab473213974e2e36" alt="Getresponse Api Key Settings" width="2709" height="1425" data-path="images/getresponse_api_key_settings.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Không chia sẻ API Key trong tin nhắn, ảnh chụp công khai hoặc tài liệu dành cho khách hàng. GetResponse có thể làm khóa không sử dụng hết hạn sau 90 ngày; khi đó, bạn cần tạo khóa mới và kết nối lại.
</Warning>

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

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

  <Step title="Nhập API Key">
    Dán khóa vừa tạo vào trường **API Key**, sau đó nhấn **Confirm**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/connect_getresponse_in_chatbotx_integrations.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=abf1c79f8345608c5b4d65052d717886" alt="Connect Getresponse In Chatbotx Integrations" width="3180" height="1559" data-path="images/connect_getresponse_in_chatbotx_integrations.png" />
    </Frame>
  </Step>
</Steps>

Khi khóa hợp lệ, ChatbotX lưu kết nối và tải các List cùng Tag từ tài khoản GetResponse để sử dụng trong Flow.

## Thêm GetResponse vào Flow

Sau khi kết nối, thêm action GetResponse tại vị trí bạn muốn đồng bộ liên hệ. Hãy đặt action sau bước thu thập email để luôn có dữ liệu gửi sang GetResponse.

<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 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 GetResponse**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/select_add_contact_to_getresponse_action.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=43a5ebbfe76245e56c313296d9a87ba6" alt="Select Add Contact To Getresponse Action" width="3187" height="1884" data-path="images/select_add_contact_to_getresponse_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 List và ánh xạ dữ liệu liên hệ.
  </Step>
</Steps>

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

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

| Trường                         | Cách thiết lập                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| **List**                       | Chọn List GetResponse sẽ nhận liên hệ, ví dụ `Contacts`.                                                                              |
| **Email Field**                | Chọn trường ChatbotX đang lưu email của khách. Đây là thông tin dùng để tạo liên hệ trong GetResponse.                                |
| **Tags**                       | Chọn một hoặc nhiều Tag GetResponse cần gắn cho liên hệ, ví dụ `NEW`. Trường này không bắt buộc.                                      |
| **Day of Autoresponder Cycle** | Nhập ngày bắt đầu của khách trong chu kỳ Autoresponder. Dùng `0` cho ngày đăng ký, `1` cho ngày tiếp theo. Trường này không bắt buộc. |

<Frame>
  <img src="https://mintcdn.com/chatbotx/uJgqa_3ug_vDTaFk/images/configure_add_contact_to_getresponse.png?fit=max&auto=format&n=uJgqa_3ug_vDTaFk&q=85&s=e85a6b737c15288d9436267b7f5872a5" alt="Configure Add Contact To Getresponse" width="3184" height="1886" data-path="images/configure_add_contact_to_getresponse.png" />
</Frame>

<Note>
  List được chọn cần có Autoresponder tương ứng nếu bạn muốn gửi email tự động. Ngày nhập trong ChatbotX nên khớp với ngày của email đầu tiên trong chu kỳ GetResponse.
</Note>

## Ví dụ thu thập khách nhận ưu đãi

Một cửa hàng thời trang muốn gửi mã giảm giá và giới thiệu bộ sưu tập mới qua email.

<Steps>
  <Step title="Thu thập email">
    Dùng Get User Data để hỏi email và lưu câu trả lời vào trường **Email**.
  </Step>

  <Step title="Thêm khách vào GetResponse">
    Chạy action **Add Contact to GetResponse**, chọn List `Contacts`, trường **Email** và Tag `NEW`.
  </Step>

  <Step title="Bắt đầu Autoresponder">
    Đặt **Day of Autoresponder Cycle** là `0` để khách nhận email đầu tiên theo lịch của chu kỳ ngay từ ngày đăng ký.
  </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ở List đã chọn trong GetResponse và xác nhận liên hệ xuất hiện.
* Kiểm tra email, Tags và ngày trong chu kỳ Autoresponder.
* Nếu List hoặc Tag không hiển thị trong ChatbotX, mở lại action sau khi kiểm tra kết nối.
* Nếu kết nối thất bại, tạo API Key mới trong **Tools > Integrations and API > API** rồi kết nối lại.

<Warning>
  Khi bạn xóa hoặc thay API Key trong GetResponse, kết nối hiện tại có thể ngừng hoạt động. Hãy cập nhật khóa mới trong ChatbotX trước khi chạy Flow.
</Warning>