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

# Tổng quan về Messages API

> Gửi và nhận tin nhắn trực tiếp trên Facebook, Instagram và X/Twitter

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["business"]} maxPackRequired={false} />

Messaging API cho phép bạn quản lý các tin nhắn trực tiếp (DM) đến những người liên lạc với User Profiles của bạn.
Correspondent (người liên lạc) là người mà người dùng của bạn (User Profile) đang giao tiếp cùng.
Conversation (cuộc trò chuyện) là một chuỗi các tin nhắn giữa người dùng của bạn (User Profile) và người liên lạc của họ.

<ul class="custom-bullets">
  <li>
    Messaging API được bao gồm trong tất cả các Ayrshare Business Plans và như một tiện ích bổ sung
    trả phí cho các gói Premium.
  </li>

  <li>
    Đối với cả gói Business và Premium, bạn phải kích hoạt Messaging trong
    trang Account của Ayrshare dashboard.
  </li>

  <li>
    Messaging có sẵn cho Facebook Messenger, Instagram Direct Messenger,
    và X Direct Messages.
  </li>
</ul>

<Card title="Tìm hiểu thêm về Messaging API" icon="link" href="https://www.ayrshare.com/ayrshare-messaging-api-for-facebook-instagram-and-x-twitter/" horizontal />

## Các tính năng Messaging chính

<ul class="custom-bullets">
  <li>Quản lý các cuộc trò chuyện của người dùng của bạn với người liên lạc.</li>

  <li>
    Gửi tin nhắn văn bản, hình ảnh, video và emoji thay mặt cho người dùng của bạn.
  </li>

  <li>Truy xuất lịch sử cuộc trò chuyện đầy đủ.</li>
  <li>Thiết lập các phản hồi tin nhắn tự động.</li>

  <li>
    Nhận cập nhật thời gian thực thông qua webhooks cho các tin nhắn nhận được, phản ứng tin nhắn,
    biên lai đã đọc.
  </li>
</ul>

## Kích hoạt Messaging

### Kích hoạt Tài khoản Ayrshare và User Profiles của bạn

Trước tiên bạn phải kích hoạt messaging cho tài khoản Ayrshare tổng thể của mình để quản lý DM. Trong Ayrshare dashboard, đi đến [trang Account](https://app.ayrshare.com/account) và nhấp vào nút "Learn More" và sau đó "Enable". Tại thời điểm này bạn đã kích hoạt messaging cho tài khoản tổng thể của mình, *nhưng chưa kích hoạt messaging cho các User Profiles riêng lẻ*.

Bạn có thể kích hoạt messaging cho các User Profiles riêng lẻ trong [trang User Profiles](https://app.ayrshare.com/manage-profiles) bằng cách nhấp vào ô kiểm "Messaging Active" cho mỗi profile hoặc sử dụng endpoint tạo hoặc cập nhật [profiles](/apis/profiles/overview).

Sau khi kích hoạt messaging cho một User Profile, bạn phải liên kết lại tài khoản mạng xã hội (Facebook và Instagram) trong trang Social Accounts/Social Linking.
Sau khi kích hoạt, bạn sẽ thấy huy hiệu "Messaging" trên tài khoản mạng xã hội đã liên kết.

<img src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/messaging/messaging-badge.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=cee009857e195b2835e913eb36c3b83f" width="60%" alt="Messaging badge" class="center" data-path="images/apis/messaging/messaging-badge.webp" />

### Kích hoạt Messaging trong Ứng dụng Instagram

Bạn có thể cần kích hoạt messaging cho tài khoản Instagram của mình:

<ul class="custom-bullets">
  <li>
    Đi đến hồ sơ của bạn trong ứng dụng di động Instagram và nhấn biểu tượng menu ≡ ở
    góc trên bên phải để đi đến trang **Settings and activity**.
  </li>

  <li>Cuộn xuống phần **How others can interact with you**.</li>
  <li>Nhấp **Messages and story replies**.</li>
  <li>Nhấn **Message requests**.</li>

  <li>
    Dưới **Connected tool** bật công tắc **Allow access to messages**.
  </li>
</ul>

## Thông tin Quan trọng về Messaging

<Note>
  **Cuộc trò chuyện phải được người liên lạc khởi tạo.** Khi một cuộc trò chuyện
  đã được thiết lập, sau đó bạn có thể tự do gửi tin nhắn, nhận tin nhắn, nhận
  phản ứng (ví dụ thumbs ups), hoặc nhận biên lai đã đọc thay mặt cho người dùng của bạn.
</Note>

<Note>
  **Người dùng của bạn phải phản hồi cuộc trò chuyện Instagram trong vòng 7 ngày kể từ tin nhắn cuối cùng
  mà người liên lạc đã gửi.** Nếu người liên lạc không gửi tin nhắn trong
  7 ngày, cuộc trò chuyện được coi là không hoạt động và không thể phản hồi.
</Note>

### Truy xuất Lịch sử Tin nhắn cho Facebook và Instagram

Khi bạn lần đầu kích hoạt messaging cho một user profile với Facebook hoặc
Instagram đã liên kết, có những giới hạn quan trọng về việc truy cập lịch sử cuộc trò chuyện:

#### Giới hạn Kết nối Ban đầu

<ul class="custom-bullets">
  <li>
    Facebook và Instagram chỉ cho phép truy xuất **20 tin nhắn cuối cùng** từ
    các cuộc trò chuyện hiện có khi bạn lần đầu liên kết một tài khoản cho messaging
  </li>

  <li>
    Nếu một cuộc trò chuyện có hơn 20 tin nhắn, chỉ có 20 tin nhắn gần nhất mới có thể
    truy cập ban đầu
  </li>
</ul>

#### Sau khi Thiết lập Ban đầu

<ul class="custom-bullets">
  <li>
    Sau khi messaging được kích hoạt, **tất cả tin nhắn mới** được gửi và nhận sẽ được
    truy cập đầy đủ
  </li>

  <li>
    Ayrshare duy trì lịch sử cuộc trò chuyện đầy đủ về sau
  </li>

  <li>
    Ví dụ: Nếu ban đầu bạn truy xuất 20 tin nhắn, sau đó 100 tin nhắn mới
    được trao đổi, bạn sẽ có thể truy cập tất cả 120 tin nhắn tổng cộng
  </li>
</ul>

Giới hạn này chỉ áp dụng cho các tin nhắn lịch sử tồn tại trước khi kích hoạt
messaging - tất cả hoạt động cuộc trò chuyện trong tương lai cho Facebook và Instagram sẽ được
bảo toàn và có thể truy cập đầy đủ.

### Giới hạn Cuộc trò chuyện & Định giá

<ul class="custom-bullets">
  <li>
    Mỗi Ayrshare User Profile có thể có tối đa **1.000 cuộc trò chuyện đang hoạt động mỗi
    chu kỳ thanh toán**. Số lượng cuộc trò chuyện đang hoạt động là tổng trên tất cả các mạng xã hội.
  </li>

  <li>
    **Gói Premium**: Messaging là tiện ích bổ sung phí cố định **\$49 mỗi tháng** cho mỗi tài khoản.
  </li>

  <li>
    **Gói Launch và Business**: Messaging được tính phí **\$0,09 cho mỗi cuộc trò chuyện
    đang hoạt động** thông qua Stripe metered billing. Có các mức chiết khấu dựa trên khối lượng;
    liên hệ với đại diện tài khoản Ayrshare của bạn để biết chi tiết.
  </li>

  <li>
    Một cuộc trò chuyện được tính là đang hoạt động cho chu kỳ thanh toán khi bạn gửi một
    tin nhắn cho người nhận. Các tin nhắn đến từ người nhận, tự nó, không
    đánh dấu cuộc trò chuyện là đang hoạt động.
  </li>

  <li>
    Nếu đã đạt đến giới hạn 1.000 cuộc trò chuyện, bạn vẫn có thể nhận
    tin nhắn, nhưng bạn sẽ không thể phản hồi cho đến khi bắt đầu chu kỳ thanh toán tiếp theo.
  </li>

  <li>
    Số lượng tin nhắn, được gửi hoặc nhận, trong một cuộc trò chuyện đang hoạt động là
    không giới hạn.
  </li>

  <li>
    Nếu bạn cần tăng giới hạn cuộc trò chuyện, vui lòng liên hệ với
    đại diện tài khoản Ayrshare của bạn.
  </li>
</ul>

Bạn có thể xem số lượng cuộc trò chuyện hiện tại bằng [endpoint user](/apis/user/overview).

### Vấn đề Kiểm soát Messaging trên Facebook và Instagram

Meta (Facebook và Instagram) sử dụng hệ thống "thread control" cho các cuộc trò chuyện messaging. Điều này có nghĩa là chỉ một ứng dụng có thể gửi tin nhắn trong một cuộc trò chuyện tại một thời điểm, trong khi các ứng dụng khác chỉ có thể nhận tin nhắn.

#### Điều này có nghĩa là gì?

Nếu bạn thấy lỗi **"Message failed to send because another app is controlling this thread now"**, có nghĩa là:

* Một ứng dụng bên thứ ba khác đang kiểm soát cuộc trò chuyện đó
* Ayrshare chỉ có thể nhận tin nhắn trong cuộc trò chuyện đó
* Ayrshare không thể gửi tin nhắn cho đến khi nó lấy lại quyền kiểm soát

#### Cách Khắc phục Sự cố này

Để cho phép Ayrshare gửi tin nhắn trở lại, bạn cần xóa ứng dụng bên thứ ba đang kiểm soát cuộc trò chuyện.
Xin lưu ý rằng Meta (Facebook và Instagram) có thể cập nhật quy trình xóa các ứng dụng bên thứ ba, vì vậy hãy sử dụng các bước sau như một hướng dẫn chung.

**Đối với Facebook Pages:**

1. Đi đến [Facebook.com](https://facebook.com) và đăng nhập vào tài khoản của bạn
2. Nhấp menu (☰) ở góc trên bên phải → **Settings & Privacy** → **Settings**
3. Trong thanh bên trái, nhấp **Apps and Websites**
4. Tìm ứng dụng bên thứ ba đang kiểm soát messaging của bạn
5. Nhấp **Remove** bên cạnh ứng dụng đó
6. Xác nhận việc xóa

**Đối với Tài khoản Instagram Business:**

1. Mở ứng dụng Instagram trên điện thoại
2. Đi đến **Profile** → nhấn menu (☰) → **Settings and Privacy**
3. Nhấn **Apps and Websites**
4. Tìm và xóa ứng dụng bên thứ ba

**Thay thế cho Instagram:**

1. Đi đến [business.facebook.com](https://business.facebook.com)
2. Điều hướng đến **Business Settings**
3. Dưới **Accounts**, nhấp **Instagram Accounts**
4. Chọn tài khoản Instagram của bạn
5. Kiểm tra các ứng dụng đã kết nối và xóa ứng dụng có vấn đề

#### Sau khi Xóa

Khi bạn đã xóa ứng dụng bên thứ ba:

<ul class="custom-bullets">
  <li>Thread control sẽ tự động trở về Ayrshare</li>
  <li>Bạn sẽ có thể gửi tin nhắn bình thường trở lại</li>
  <li>Không cần thực hiện thêm bất kỳ hành động nào từ phía bạn</li>
</ul>

Nếu bạn vẫn tiếp tục gặp sự cố sau khi xóa ứng dụng, vui lòng liên hệ với đội hỗ trợ của chúng tôi.

## Message WebHooks

Xem [Messages Webhooks](/apis/webhooks/actions#messages-action) để tự động nhận tin nhắn, biên lai đã đọc hoặc phản ứng.
