Tổng quan về Messages API

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

• 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.
• Đố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.
• Messaging có sẵn cho Facebook Messenger, Instagram Direct Messenger, X Direct Messages, và WhatsApp (Private Beta).

​

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

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

​

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

​

Kích hoạt Messaging cho WhatsApp

Liên kết một WhatsApp Business account thông qua luồng embedded signup của Meta trực tiếp từ Ayrshare dashboard:

• Bạn cần một tài khoản Meta Business Manager, một WhatsApp Business Account (WABA), và một số điện thoại đủ điều kiện. Meta xác minh tài khoản và số điện thoại trong quá trình embedded signup.
• Trên trang Social Accounts, nhấp Link trên ô WhatsApp. Ayrshare khởi chạy pop-up embedded signup của Meta để hướng dẫn khách hàng chọn/tạo Business Manager, WABA, và số điện thoại của họ, và chấp nhận các điều khoản của Meta.
• Khi signup hoàn tất, Ayrshare xác minh quyền sở hữu WABA và số điện thoại đã chọn, hoàn tất đăng ký, và đăng ký tài khoản vào webhooks của WhatsApp. Bạn không cần nhập một PIN đăng ký riêng biệt trong Ayrshare dashboard.

​

Hành vi Quan trọng Riêng của WhatsApp

• Người nhận là số điện thoại, không phải ID. WhatsApp xác định người liên lạc bằng số điện thoại E.164 (chỉ chữ số, không có +). ID cuộc trò chuyện trả về từ Ayrshare cũng là số điện thoại của người liên lạc — không có ID cuộc trò chuyện mờ (opaque) như cách Facebook và Instagram sử dụng.
• Cửa sổ chăm sóc khách hàng 24 giờ. WhatsApp Business chỉ cho phép các tin nhắn đi dạng free-form trong vòng 24 giờ kể từ tin nhắn gần nhất của người liên lạc. Ngoài cửa sổ đó, Meta sẽ từ chối lần gửi. Các tin nhắn templated ngoài cửa sổ 24 giờ hiện chưa được hỗ trợ thông qua Ayrshare.
• Gửi trực tiếp cho người nhận bằng API. Truyền số điện thoại của người nhận vào Send Message. Meta chỉ chuyển một tin nhắn free-form khi người nhận đó đang trong cửa sổ chăm sóc khách hàng 24 giờ. Các template được duyệt là bắt buộc cho cold outreach, và Ayrshare hiện chưa cung cấp việc gửi template.
• Trạng thái chuyển tin dùng một trường duy nhất. Khi có sẵn trên một tin nhắn đi đã lưu, Get Messages trả về status là sent, delivered, read, hoặc failed. Các cập nhật trạng thái chuyển tin và reactions WhatsApp hiện chưa được đẩy tới URL webhook đã đăng ký của bạn.
• Loại và kích thước media tuân theo các giới hạn WhatsApp Cloud API do Meta công bố — hình ảnh lên tới 5 MB, audio và video lên tới 16 MB, và tài liệu lên tới 100 MB tại thời điểm viết bài.

​

Media WhatsApp được hỗ trợ

• Image: .jpg, .jpeg, .png
• Video: .mp4, .3gp
• Audio: .aac, .amr, .mp3, .m4a, .ogg
• Document: .txt, .pdf, .ppt, .pptx, .doc, .docx, .xls, .xlsx

​

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:

• Đ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.
• Cuộn xuống phần How others can interact with you.
• Nhấp Messages and story replies.
• Nhấn Message requests.
• Dưới Connected tool bật công tắc Allow access to messages.

​

Thông tin Quan trọng về Messaging

​

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

• 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
• 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

​

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

• 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 đủ
• Ayrshare duy trì lịch sử cuộc trò chuyện đầy đủ về sau
• 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

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á

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

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

​

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 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
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:

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

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 để tự động nhận tin nhắn, biên lai đã đọc hoặc phản ứng.