> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Messenger

> Kết nối trang Facebook của bạn với AI agent để tự động trả lời tin nhắn khách hàng, và cho phép nhân viên tiếp nhận bất kỳ lúc nào.

Khi kết nối trang Facebook với một agent, mọi tin nhắn khách gửi đến trang sẽ được AI trả lời tự động bằng dữ liệu bạn đã huấn luyện. Nhân viên của bạn có thể tiếp nhận bất kỳ cuộc trò chuyện nào — AI sẽ tự động im lặng để không nói chồng lên nhân viên.

<Info>
  Kênh Messenger yêu cầu gói **Standard** trở lên. Trên gói Free, nút kết nối
  sẽ hiện hộp thoại nâng cấp.
</Info>

## Trước khi bắt đầu

Bạn cần:

* Một **trang Facebook** (Facebook Page) mà bạn có quyền quản trị
* Trang nằm trong một **Danh mục doanh nghiệp** (Business Portfolio) — hầu hết cửa hàng có chạy quảng cáo đều đã có
* Một agent đã được huấn luyện dữ liệu

<Warning>
  Mỗi trang Facebook chỉ kết nối được với **một** agent. Nếu trang đã được
  kết nối ở nơi khác, bạn cần ngắt kết nối trước.
</Warning>

## Kết nối trang Facebook

<Steps>
  <Step title="Mở trang Messenger">
    Vào agent → **Triển khai** → chọn thẻ **Messenger**.
  </Step>

  <Step title="Nhấn Kết nối">
    Nhấn **"Kết nối trang Facebook"**. Bạn sẽ được chuyển sang Facebook để
    cấp quyền.
  </Step>

  <Step title="Cấp quyền trên Facebook">
    Facebook sẽ hỏi bạn chọn **Danh mục doanh nghiệp** và **trang** muốn kết
    nối. Hãy giữ nguyên tất cả quyền được yêu cầu — nếu bỏ bớt, danh sách
    trang có thể trống và không kết nối được.
  </Step>

  <Step title="Chọn trang">
    Sau khi quay lại AgentBase, hộp thoại **"Chọn trang Facebook"** hiện
    danh sách các trang bạn quản lý. Tích chọn trang rồi nhấn **"Kết nối"**.

    Những trang đã thuộc về agent khác sẽ hiển thị mờ và không chọn được.
  </Step>

  <Step title="Kiểm tra">
    Nhắn thử một tin vào trang từ một tài khoản Facebook khác. Bạn sẽ thấy
    dấu hiệu "đang soạn tin", sau đó là câu trả lời của agent.
  </Step>
</Steps>

## Quản lý trang đã kết nối

| Thao tác               | Cách làm                              | Kết quả                                                                     |
| ---------------------- | ------------------------------------- | --------------------------------------------------------------------------- |
| **Tạm dừng trang**     | Tắt công tắc bên cạnh tên trang       | AI ngừng trả lời, nhưng tin nhắn khách **vẫn được ghi lại** trong Hoạt động |
| **Đổi agent**          | Menu **"..."** → **"Gán cho agent"**  | Chuyển trang sang một agent khác trong cùng workspace                       |
| **Ngắt kết nối**       | Menu **"..."** → **"Ngắt kết nối"**   | Ngừng nhận tin nhắn từ trang. Lịch sử trò chuyện được giữ nguyên            |
| **Kết nối trang khác** | Nút **"Kết nối trang Facebook khác"** | Thêm trang thứ hai vào cùng agent                                           |

<Info>
  Tạm dừng khác với ngắt kết nối: khi tạm dừng, bạn vẫn thấy tin nhắn khách
  trong Chat logs và vẫn trả lời thủ công được.
</Info>

### Khi hiện "Cần kết nối lại"

Nếu quyền truy cập hết hạn — thường do bạn gỡ ứng dụng AgentBase khỏi tài khoản
Facebook, hoặc đổi quyền quản trị trang — trang sẽ hiện biểu ngữ đỏ. Nhấn
**"Kết nối lại"** và thực hiện lại các bước cấp quyền.

## Nhân viên tiếp nhận cuộc trò chuyện

Có **ba cách** để nhân viên tiếp quản một cuộc trò chuyện. Cách nào cũng khiến
AI ngừng trả lời cuộc đó.

<AccordionGroup>
  <Accordion title="Trả lời từ Chat logs">
    Vào **Hoạt động** → **Chat logs**, chọn cuộc trò chuyện, rồi nhập vào ô
    **"Trả lời với tư cách nhân viên hỗ trợ"** ở cuối trang. Tin nhắn được
    gửi thẳng tới khách trên Messenger.

    Lần trả lời đầu tiên sẽ tự động tạm dừng AI.
  </Accordion>

  <Accordion title="Nhấn Tạm dừng AI">
    Nhấn **"Tạm dừng AI"** ở góc trên bên phải cuộc trò chuyện. Dùng khi bạn
    muốn đọc kỹ trước khi trả lời, hoặc muốn chắc chắn AI không xen vào.
  </Accordion>

  <Accordion title="Trả lời từ hộp thư Facebook">
    Nếu bạn trả lời khách trực tiếp trong hộp thư của trang (Meta Business
    Suite hoặc ứng dụng trên điện thoại), AgentBase nhận biết và tự động tạm
    dừng AI. Tin nhắn đó cũng xuất hiện trong Chat logs với nhãn **"Nhân viên
    hỗ trợ"**, nên lịch sử không bị chia đôi.
  </Accordion>
</AccordionGroup>

### AI tự hoạt động lại sau 30 phút

Việc tạm dừng chỉ kéo dài **30 phút**, sau đó AI tự trả lời trở lại. Điều này
tránh trường hợp nhân viên quên bật lại và khách bị bỏ quên.

Nhấn **"Tiếp tục AI"** nếu bạn muốn giao lại ngay cho agent.

<Info>
  Riêng khi khách **chủ động yêu cầu gặp người thật**, AI sẽ dừng vô thời hạn
  cho tới khi bạn nhấn **"Giải quyết"** — người đang xếp hàng chờ nhân viên
  không nên bị bot cắt ngang.
</Info>

## Giới hạn 24 giờ của Facebook

Facebook chỉ cho phép ứng dụng gửi tin nhắn trong vòng **24 giờ** kể từ tin
nhắn gần nhất của khách. Nếu bạn trả lời một cuộc trò chuyện cũ hơn, AgentBase
sẽ báo lỗi về thời gian cho phép.

<Warning>
  Đây là quy định của Facebook, không phải giới hạn của AgentBase.
</Warning>

**Cách xử lý:** trả lời trực tiếp trong **hộp thư của trang** trên Meta Business
Suite. Cách này không bị giới hạn 24 giờ, và tin nhắn vẫn tự động đồng bộ về
Chat logs như mô tả ở trên.

## Tin nhắn và tín dụng

* Mỗi câu trả lời của AI tiêu tốn **một tín dụng**
* Nếu khách gửi liên tiếp nhiều tin, AgentBase **gộp lại thành một câu trả lời**
  và chỉ tính một tín dụng
* Tin nhắn do nhân viên trả lời **không tốn tín dụng**
* Khi hết tín dụng, AI ngừng trả lời nhưng tin nhắn khách vẫn được ghi lại

## Xử lý sự cố

<AccordionGroup>
  <Accordion title="Facebook báo tài khoản không quản lý trang nào">
    Thường do bỏ bớt quyền ở màn hình cấp quyền, hoặc trang nằm trong một
    Danh mục doanh nghiệp mà bạn chưa chọn. Hãy kết nối lại và giữ nguyên
    toàn bộ quyền được yêu cầu.
  </Accordion>

  <Accordion title="Đã kết nối nhưng agent không trả lời">
    Kiểm tra theo thứ tự: công tắc của trang có đang bật không, gói dịch vụ
    có còn hiệu lực không, workspace có còn tín dụng không, và cuộc trò
    chuyện có đang ở trạng thái tạm dừng AI không.
  </Accordion>

  <Accordion title="Trang đã được kết nối với tài khoản khác">
    Mỗi trang chỉ thuộc về một agent trên toàn hệ thống. Hãy ngắt kết nối ở
    nơi cũ trước khi kết nối lại.
  </Accordion>

  <Accordion title="Tin nhắn hiện trong Chat logs nhưng khách không nhận được">
    Xảy ra khi quyền truy cập trang đã hết hạn. Kiểm tra biểu ngữ "Cần kết
    nối lại" ở trang Messenger.
  </Accordion>
</AccordionGroup>