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

> Kết nối Mailchimp với ChatbotX để thêm liên hệ vào Audience, thiết lập Double Opt-In, gắn Tag và đồng bộ Custom Fields từ Flow.

Tích hợp **Mailchimp** giúp bạn thêm liên hệ từ ChatbotX vào một Audience ngay trong Flow. Bạn có thể chọn trường email, bật Double Opt-In, gắn Tags và đồng bộ thông tin vào các Custom Fields của Mailchimp.

Ví dụ: sau khi khách đăng ký nhận ưu đãi, ChatbotX thêm email vào Audience, gắn Tags để phân loại và gửi tên, số điện thoại hoặc ngày sinh sang Mailchimp.

## Chuẩn bị API Key

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

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

  <Step title="Mở trang API keys">
    Chọn biểu tượng hồ sơ, mở **Profile**, sau đó chọn **Extras > API keys**.
  </Step>

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

  <Step title="Sao chép API Key">
    Nhấn **Copy Key to Clipboard** và lưu khóa ở nơi an toàn. Mailchimp chỉ hiển thị đầy đủ khóa ngay sau khi tạo.

    Xem hướng dẫn chính thức tại [About API Keys](https://mailchimp.com/help/about-api-keys/).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/k1AYTFOrrOcuJT67/images/mailchimp_api_keys_settings.png?fit=max&auto=format&n=k1AYTFOrrOcuJT67&q=85&s=d31a61fd537d35b3dc09abfd8a5b174b" alt="Mailchimp API Keys Settings" width="2993" height="1757" data-path="images/mailchimp_api_keys_settings.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Không chia sẻ API Key trong email, tin nhắn, ảnh chụp công khai hoặc tài liệu dành cho khách hàng. Nếu khóa bị lộ, hãy Revoke khóa đó và tạo khóa mới.
</Warning>

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

  <Step title="Mở cửa sổ kết nối">
    Nhấn **Connect** để mở cửa sổ **Connect Mailchimp**.
  </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/k1AYTFOrrOcuJT67/images/connect_mailchimp_in_chatbotx_integrations.png?fit=max&auto=format&n=k1AYTFOrrOcuJT67&q=85&s=0a99d3810a14b379053474165bb53dce" alt="Connect Mailchimp in ChatbotX Integrations" width="3184" height="1571" data-path="images/connect_mailchimp_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 Audience, Tags cùng Custom Fields từ tài khoản Mailchimp để sử dụng trong Flow.

## Thêm Mailchimp vào Flow

Hãy đặt action Mailchimp sau bước thu thập email và các dữ liệu cần đồng bộ. Điều này giúp action luôn nhận được thông tin trước khi gửi liên hệ sang Mailchimp.

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

    <Frame>
      <img src="https://mintcdn.com/chatbotx/k1AYTFOrrOcuJT67/images/select_add_contact_to_mailchimp_action.png?fit=max&auto=format&n=k1AYTFOrrOcuJT67&q=85&s=1bbdd155f8d79b9438897d342d9ea569" alt="Select Add Contact to Mailchimp Action" width="3185" height="1885" data-path="images/select_add_contact_to_mailchimp_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 Audience và ánh xạ dữ liệu liên hệ.
  </Step>
</Steps>

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

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

| Trường                         | Cách thiết lập                                                                                                                                        |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Audience**                   | Chọn Audience Mailchimp sẽ nhận liên hệ.                                                                                                              |
| **Email field**                | Chọn trường ChatbotX đang lưu email của khách. Mailchimp dùng email để xác định liên hệ trong Audience.                                               |
| **Double Opt-In**              | Bật để Mailchimp gửi email xác nhận trước khi đăng ký liên hệ. Tắt nếu quy trình của bạn đã thu thập sự đồng ý hợp lệ và muốn thêm liên hệ trực tiếp. |
| **Tags**                       | Chọn một hoặc nhiều Tags cần gắn cho liên hệ. Trường này không bắt buộc.                                                                              |
| **Custom Fields in MailChimp** | Chọn trường ChatbotX ở bên trái để ánh xạ với trường Mailchimp tương ứng ở bên phải. Trường này không bắt buộc.                                       |

<Frame>
  <img src="https://mintcdn.com/chatbotx/k1AYTFOrrOcuJT67/images/configure_add_contact_to_mailchimp.png?fit=max&auto=format&n=k1AYTFOrrOcuJT67&q=85&s=e3f15cf1ab6bf35a01b9e944ef0faa47" alt="Configure Add Contact to Mailchimp" width="3187" height="1891" data-path="images/configure_add_contact_to_mailchimp.png" />
</Frame>

<Note>
  Các Custom Fields phải tồn tại trong Audience đã chọn trước khi bạn ánh xạ. Mailchimp còn gọi các trường này là Audience fields hoặc Merge fields.
</Note>

## Ánh xạ Custom Fields

Ánh xạ giúp Mailchimp nhận thêm dữ liệu ngoài email để cá nhân hóa chiến dịch hoặc phân nhóm liên hệ.

| Trường Mailchimp | Dữ liệu ChatbotX phù hợp              |
| ---------------- | ------------------------------------- |
| **Birthday**     | Custom Field lưu ngày sinh của khách. |
| **Company**      | Custom Field lưu tên công ty.         |
| **First Name**   | Trường lưu tên của khách.             |
| **Last Name**    | Trường lưu họ của khách.              |
| **Phone Number** | Trường lưu số điện thoại.             |

Chọn đúng kiểu dữ liệu cho từng trường. Nếu Audience yêu cầu một Merge field nhưng Flow không gửi giá trị hợp lệ, Mailchimp có thể từ chối thêm liên hệ.

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

Một cửa hàng thời trang muốn thu thập khách quan tâm đến bộ sưu tập mới và gửi mã giảm giá qua Mailchimp.

<Steps>
  <Step title="Thu thập thông tin khách">
    Dùng Get User Data để hỏi email, tên và số điện thoại, sau đó lưu câu trả lời vào các trường tương ứng.
  </Step>

  <Step title="Thêm khách vào Audience">
    Chạy **Add Contact to MailChimp**, chọn Audience cần nhận liên hệ và trường **Email**.
  </Step>

  <Step title="Phân loại liên hệ">
    Gắn Tags phù hợp với nhóm khách, sau đó ánh xạ tên cùng số điện thoại vào Custom Fields của Mailchimp.
  </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ở Audience đã chọn trong Mailchimp và xác nhận liên hệ xuất hiện.
* Kiểm tra Tags và các Custom Fields đã nhận đúng dữ liệu.
* Nếu bật Double Opt-In, kiểm tra hộp thư và hoàn tất email xác nhận.
* Nếu Audience hoặc Tags không hiển thị, kiểm tra lại kết nối rồi mở lại action.
* Nếu API Key bị Revoke, tạo khóa mới và kết nối lại trong ChatbotX.

<Warning>
  Chỉ thêm khách vào Email Marketing khi bạn đã có sự đồng ý phù hợp. Double Opt-In giúp xác nhận địa chỉ email và yêu cầu đăng ký trước khi Mailchimp đánh dấu liên hệ là đã đăng ký.
</Warning>