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

# Messenger Actions

> Hướng dẫn chi tiết các hành động tự động dành riêng cho kênh Facebook Messenger trong ChatbotX.

**Messenger Actions** là nhóm các hành động tự động được thiết kế tối ưu riêng cho kênh Facebook Messenger trong ChatbotX. Các hành động này hoạt động ngầm phía sau để điều chỉnh giao diện chat (bàn phím, menu cố định) hoặc cá nhân hóa danh tính của chatbot.

Messenger Actions bao gồm 4 tính năng chính:

<CardGroup cols={2}>
  <Card title="Set User Persistent Menu" icon="bars">
    Cài đặt Menu cố định cá nhân hóa cho từng khách hàng.
  </Card>

  <Card title="Enable Messenger Composer" icon="keyboard">
    Kích hoạt lại ô nhập văn bản (bàn phím) của khách hàng.
  </Card>

  <Card title="Disable Messenger Composer" icon="keyboard-brightness">
    Tạm thời ẩn bàn phím để dẫn dắt khách đi theo nút bấm kịch bản.
  </Card>

  <Card title="Set Persona" icon="user-astronaut">
    Thay đổi linh hoạt tên hiển thị và ảnh đại diện của chatbot.
  </Card>
</CardGroup>

## Cách truy cập Messenger Actions

Trong màn hình chỉnh sửa kịch bản (Flow Builder), nhấp vào nút **+** $\rightarrow$ chọn **Actions** $\rightarrow$ chọn **Messenger** để truy cập danh sách hành động.

<Frame>
  <img src="https://mintcdn.com/chatbotx/J9nT3gWGcUpBw27k/images/messenger_actions_menu.png?fit=max&auto=format&n=J9nT3gWGcUpBw27k&q=85&s=17a3ec06fb69cadffd25b8938227fdcc" alt="Messenger Actions Menu" width="1674" height="1101" data-path="images/messenger_actions_menu.png" />
</Frame>

## Set User Persistent Menu

Hành động này cho phép bạn thiết lập một Menu cố định (Persistent Menu - nút menu hamburger nằm góc dưới màn hình chat) riêng biệt cho từng khách hàng, ghi đè lên thiết lập menu mặc định của trang.

### Hướng dẫn cấu hình

<Steps>
  <Step title="Thêm hành động vào Flow">
    Trong Flow Builder, thêm khối hành động **Set User Persistent Menu**.
  </Step>

  <Step title="Nhấn tạo mới Menu">
    Trong cửa sổ cấu hình hành động, nhấn vào liên kết **Add new** phía trên góc phải của ô chọn. Giao diện thiết lập menu động sẽ xuất hiện ngay lập tức để bạn thiết kế các nút bấm.
  </Step>

  <Step title="Thiết kế và lưu Menu">
    Đặt tên nhận diện cho menu động và cấu hình các nút chức năng mong muốn bằng nút **+ Add Persistent Menu**, sau đó nhấn **Save** để lưu lại.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/SSYnumS4bWS1_7rJ/images/settings_create_user_persistent_menu_form.png?fit=max&auto=format&n=SSYnumS4bWS1_7rJ&q=85&s=4d3218a20f8612110a90eccbe9f9dbd6" alt="Settings Create User Persistent Menu Form" width="2043" height="1427" data-path="images/settings_create_user_persistent_menu_form.png" />
    </Frame>
  </Step>

  <Step title="Áp dụng Menu cho khách hàng">
    Chọn tên menu động bạn vừa tạo trong ô chọn của khối hành động.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/SSYnumS4bWS1_7rJ/images/messenger_set_user_persistent_menu_modal.png?fit=max&auto=format&n=SSYnumS4bWS1_7rJ&q=85&s=22023c0545dfa355ef6d05de46994b0e" alt="Messenger Set User Persistent Menu Modal" width="2638" height="1808" data-path="images/messenger_set_user_persistent_menu_modal.png" />
    </Frame>
  </Step>

  <Step title="Kết quả">
    <Frame>
      <img src="https://mintcdn.com/chatbotx/SSYnumS4bWS1_7rJ/images/persistent_menu_on_messenger.png?fit=max&auto=format&n=SSYnumS4bWS1_7rJ&q=85&s=f44108a96f0d09776a901a0e10b1563b" alt="Persistent Menu On Messenger" width="1635" height="530" data-path="images/persistent_menu_on_messenger.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  Để gỡ bỏ Menu động cá nhân hóa và quay trở lại sử dụng menu mặc định của trang, bạn chỉ cần chọn giá trị **Default** trong dropdown cấu hình của khối hành động.
</Note>

## Disable Messenger Composer

Hành động này tạm thời khóa và ẩn ô nhập liệu (bàn phím) của khách hàng trên Messenger, buộc khách hàng phải tương tác qua các nút bấm hoặc câu trả lời nhanh trong kịch bản. Điều này giúp dẫn dắt khách hàng đi đúng luồng tư vấn và hạn chế tối đa việc khách gõ tin nhắn tự do gây lệch hướng kịch bản.

## Enable Messenger Composer

Hành động này kích hoạt lại khung soạn thảo văn bản (bàn phím nhập liệu) cho khách hàng trong Messenger, cho phép họ tự do gõ chữ và gửi tin nhắn bình thường.

<Warning>
  Việc ẩn bàn phím có thể gây bất tiện nếu khách hàng có câu hỏi phát sinh. Hãy luôn đảm bảo cung cấp các nút bấm hỗ trợ (như "Gặp nhân viên" hoặc nút kích hoạt lại bàn phím) trong các bước kịch bản liên quan.
</Warning>

## Set Persona

Hành động này cho phép bạn thay đổi danh tính (tên hiển thị và ảnh đại diện) của chatbot ngay trong cuộc trò chuyện Messenger. Khách hàng sẽ thấy tin nhắn được gửi từ một nhân vật mới thay vì từ tên Page Facebook mặc định, giúp cá nhân hóa trải nghiệm tư vấn (ví dụ: đổi thành Persona "Hỗ trợ viên Linh").

### Hướng dẫn cấu hình

<Steps>
  <Step title="Tạo Persona mới trong cài đặt">
    Truy cập **Settings → Channels → Messenger**, cuộn xuống phần **Personas** và nhấn nút **+ Add Persona** để tạo danh tính mới (nhập tên hiển thị và tải ảnh đại diện lên).

    <Frame>
      <img src="https://mintcdn.com/chatbotx/SSYnumS4bWS1_7rJ/images/messenger_personas_settings.png?fit=max&auto=format&n=SSYnumS4bWS1_7rJ&q=85&s=e6f754226f9d819218724346b79c70f2" alt="Messenger Personas Settings" width="2036" height="1262" data-path="images/messenger_personas_settings.png" />
    </Frame>
  </Step>

  <Step title="Áp dụng hành động trong Flow">
    Trong kịch bản chat, thêm khối hành động **Set Persona** và chọn đúng Persona bạn vừa tạo. Các khối nội dung phía sau hành động này sẽ gửi đi dưới diện mạo mới.
  </Step>
</Steps>