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

> Kết nối MailerLite với ChatbotX để tạo hoặc cập nhật subscriber, chọn Group, trạng thái và đồng bộ Custom Fields từ Flow.

Tích hợp **MailerLite** giúp bạn tạo hoặc cập nhật subscriber từ ChatbotX ngay trong Flow. Bạn có thể thêm khách vào Group, chọn trạng thái đăng ký và đồng bộ dữ liệu vào các Custom Fields của MailerLite.

Ví dụ: sau khi khách nhập email để nhận ưu đãi, ChatbotX thêm subscriber vào Group phù hợp và gửi kèm tên, số điện thoại, công ty hoặc thành phố.

## Chuẩn bị API Token

Bạn cần tạo một **API Token** trong MailerLite trước khi kết nối. Token này cho phép ChatbotX truy cập dữ liệu subscriber, Group và Custom Fields trong tài khoản của bạn.

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

  <Step title="Mở Integrations">
    Chọn **Integrations** từ menu bên trái, sau đó mở phần **API**
  </Step>

  <Step title="Tạo API Token">
    Trong trang **Developer API**, nhấn **Generate new token**. Nhập tên giúp bạn nhận biết token và xác nhận tạo mới.
  </Step>

  <Step title="Sao chép API Token">
    Sao chép token và lưu ở nơi an toàn để dùng trong ChatbotX.

    Xem hướng dẫn chính thức tại [MailerLite API Getting Started](https://developers.mailerlite.com/getting-started).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/09pBGR5XzsfJCSLZ/images/mailerlite_developer_api_token_settings.png?fit=max&auto=format&n=09pBGR5XzsfJCSLZ&q=85&s=8b4cbc0a829d6bc1110c5e41b03e77a2" alt="Mailerlite Developer Api Token Settings" width="2961" height="1879" data-path="images/mailerlite_developer_api_token_settings.png" />
    </Frame>
  </Step>
</Steps>

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

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

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

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

    <Frame>
      <img src="https://mintcdn.com/chatbotx/09pBGR5XzsfJCSLZ/images/connect_mailerlite_in_chatbotx_integrations.png?fit=max&auto=format&n=09pBGR5XzsfJCSLZ&q=85&s=600321858ec655aafab6ec5a18e4850f" alt="Connect Mailerlite In Chatbotx Integrations" width="3180" height="1572" data-path="images/connect_mailerlite_in_chatbotx_integrations.png" />
    </Frame>
  </Step>
</Steps>

Khi token hợp lệ, ChatbotX lưu kết nối và tải các Group cùng Custom Fields từ tài khoản MailerLite để sử dụng trong Flow.

## Thêm MailerLite vào Flow

Hãy đặt action MailerLite sau bước thu thập email và các dữ liệu cần đồng bộ. Action sẽ dùng email để tạo subscriber mới hoặc cập nhật subscriber đã tồn tại.

<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 subscriber.
  </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 MailerLite**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/09pBGR5XzsfJCSLZ/images/select_add_contact_to_mailerlite_action.png?fit=max&auto=format&n=09pBGR5XzsfJCSLZ&q=85&s=e4bc6f3e9e0ecfdf39509fa5d9cb2ebc" alt="Select Add Contact To Mailerlite Action" width="3182" height="1887" data-path="images/select_add_contact_to_mailerlite_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 Group, trạng thái và ánh xạ dữ liệu subscriber.
  </Step>
</Steps>

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

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

| Trường                          | Cách thiết lập                                                                                                    |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Group**                       | Chọn Group MailerLite sẽ nhận subscriber. Trường này không bắt buộc.                                              |
| **Email Field**                 | Chọn trường ChatbotX đang lưu email của khách. MailerLite dùng email để tạo hoặc xác định subscriber.             |
| **Type**                        | Chọn trạng thái đăng ký phù hợp cho subscriber. Chỉ chọn **Subscribed** khi khách đã đồng ý nhận Email Marketing. |
| **Custom Fields in MailerLite** | Chọn trường ChatbotX ở bên trái để ánh xạ với trường MailerLite tương ứng ở bên phải. Trường này không bắt buộc.  |
| **Add New**                     | Nhấn để thêm một hàng ánh xạ Custom Field khác.                                                                   |

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

<Note>
  Group và Custom Fields cần được tạo sẵn trong MailerLite trước khi cấu hình action. Việc bỏ trống Group không xóa subscriber khỏi các Group họ đã tham gia.
</Note>

## Ánh xạ Custom Fields

Ánh xạ giúp MailerLite nhận thêm dữ liệu để cá nhân hóa email hoặc phân nhóm subscriber.

| Trường MailerLite | Dữ liệu ChatbotX phù hợp      |
| ----------------- | ----------------------------- |
| **Name**          | Trường lưu tên khách.         |
| **Phone**         | Trường lưu số điện thoại.     |
| **Company**       | Custom Field lưu tên công ty. |
| **City**          | Custom Field lưu thành phố.   |

Chọn đúng kiểu dữ liệu cho từng trường. Email phải đúng định dạng và giá trị Custom Field cần phù hợp với kiểu field đã thiết lập trong MailerLite.

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

Một cửa hàng thời trang muốn thu thập email của khách quan tâm và gửi nội dung giới thiệu bộ sưu tập mới.

<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 subscriber vào MailerLite">
    Chạy **Add Contact to MailerLite**, chọn trường **Email** và Group phù hợp nếu cần phân loại khách.
  </Step>

  <Step title="Đồng bộ dữ liệu bổ sung">
    Chọn trạng thái phù hợp, sau đó ánh xạ tên và số điện thoại vào Custom Fields của MailerLite.
  </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ở **Subscribers** trong MailerLite và xác nhận subscriber xuất hiện.
* Kiểm tra Group, trạng thái và các Custom Fields đã nhận đúng dữ liệu.
* Nếu Group hoặc Custom Fields không hiển thị, kiểm tra lại kết nối rồi mở lại action.
* Nếu API Token không còn hợp lệ, tạo token mới và kết nối lại trong ChatbotX.

<Warning>
  MailerLite hạn chế việc kích hoạt lại subscriber đã Unsubscribed, Bounced hoặc Junk để ngăn lạm dụng. Không dùng action này để thay đổi trạng thái khi khách chưa đồng ý nhận tin.
</Warning>