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

> Kết nối Moosend với ChatbotX để tạo hoặc cập nhật subscriber trong mailing list đã chọn khi Contact đi đến action trong Flow.

Tích hợp **Moosend** giúp bạn thêm liên hệ từ ChatbotX vào một mailing list ngay trong Flow. Action sử dụng email để tạo subscriber mới hoặc cập nhật subscriber đã tồn tại trong danh sách được chọn.

Ví dụ: sau khi khách nhập email để nhận thông tin sản phẩm, ChatbotX thêm địa chỉ đó vào mailing list phù hợp để Moosend tiếp tục gửi chiến dịch Email Marketing.

## Chuẩn bị API Key

Bạn cần lấy **API Key** trong Moosend trước khi kết nối. Khóa này cho phép ChatbotX truy cập mailing lists và gửi dữ liệu subscriber vào tài khoản của bạn.

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

  <Step title="Mở Settings">
    Trên thanh điều hướng phía trên, chọn **More > Settings**.
  </Step>

  <Step title="Chọn API key">
    Trong menu cài đặt bên trái, chọn **API key** để mở phần thông tin khóa của tài khoản.
  </Step>

  <Step title="Sao chép API Key">
    Nhấn **Copy** để sao chép khóa hiện tại. Nếu cần thay khóa, nhấn **Generate new API Key** và lưu khóa mới ở nơi an toàn.

    Xem hướng dẫn chính thức tại [Get the API key](https://docs.moosend.com/users/moosend/en/use-the-api-key-to-connect-to-the-moosend-web-api.html).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/cb1-ekIarD9eBHxf/images/moosend_api_key_settings.png?fit=max&auto=format&n=cb1-ekIarD9eBHxf&q=85&s=4908c33520524a68fe83263baf25634a" alt="Moosend Api Key Settings" width="2993" height="1416" data-path="images/moosend_api_key_settings.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  API Key có toàn quyền truy cập API của tài khoản Moosend. Không chia sẻ khóa 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 Moosend 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 **Moosend**.
  </Step>

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

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

    <Frame>
      <img src="https://mintcdn.com/chatbotx/cb1-ekIarD9eBHxf/images/connect_moosend_in_chatbotx_integrations.png?fit=max&auto=format&n=cb1-ekIarD9eBHxf&q=85&s=223ff496cbc0b6fbd576097f41d6abb6" alt="Connect Moosend In Chatbotx Integrations" width="3183" height="1549" data-path="images/connect_moosend_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 mailing lists từ tài khoản Moosend để sử dụng trong Flow.

## Thêm Moosend vào Flow

Hãy đặt action Moosend sau bước thu thập email. Action cần một địa chỉ email hợp lệ trước khi có thể thêm subscriber vào mailing list.

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

    <Frame>
      <img src="https://mintcdn.com/chatbotx/cb1-ekIarD9eBHxf/images/select_add_contact_to_moosend_action.png?fit=max&auto=format&n=cb1-ekIarD9eBHxf&q=85&s=cd0b5688fc182b6f9092fdc2fcb4c174" alt="Select Add Contact to Moosend Action" width="3184" height="1884" data-path="images/select_add_contact_to_moosend_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 mailing list và trường email.
  </Step>
</Steps>

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

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

| Trường           | Cách thiết lập                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Moosend list** | Chọn mailing list Moosend sẽ nhận subscriber. Danh sách cần được tạo sẵn trong Moosend.                            |
| **Email Field**  | Chọn trường ChatbotX đang lưu email của khách. Moosend dùng email để tạo hoặc xác định subscriber trong danh sách. |

<Frame>
  <img src="https://mintcdn.com/chatbotx/cb1-ekIarD9eBHxf/images/configure_add_contact_to_moosend.png?fit=max&auto=format&n=cb1-ekIarD9eBHxf&q=85&s=81cd127b1916afdc4cdab6af66958314" alt="Configure Add Contact to Moosend" width="3181" height="1886" data-path="images/configure_add_contact_to_moosend.png" />
</Frame>

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

* **Success**: Moosend đã xử lý yêu cầu thêm hoặc cập nhật subscriber.
* **Error**: Yêu cầu thất bại do email, API Key, mailing list hoặc kết nối 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 phù hợp.

## Ví dụ thu thập subscriber nhận thông tin sản phẩm

Một cửa hàng thời trang muốn gửi thông tin bộ sưu tập mới cho khách đã đăng ký qua chatbot.

<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 subscriber vào Moosend">
    Chạy **Add Contact to Moosend**, chọn mailing list cần nhận subscriber và trường **Email**.
  </Step>

  <Step title="Xử lý kết quả">
    Nối **Success** với tin nhắn xác nhận đăng ký. Nối **Error** với nhánh yêu cầu khách kiểm tra lại email hoặc chuyển cho nhân viên hỗ trợ.
  </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ở mailing list đã chọn trong Moosend và xác nhận subscriber xuất hiện.
* 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 mailing list không hiển thị, kiểm tra lại kết nối rồi mở lại action.
* Nếu API Key không còn hợp lệ, tạo khóa mới và kết nối lại trong ChatbotX.

<Warning>
  Moosend API có thể thêm lại subscriber từng Unsubscribed khi action chạy. Chỉ sử dụng action này khi khách đã đồng ý nhận Email Marketing và không dùng nó để bỏ qua yêu cầu hủy đăng ký.
</Warning>