Tạo
Tạo và gửi tin nhắn cho khách hàng hoặc những người quan tâm đến Trang Facebook của bạn.
Trước khi bạn bắt đầu
Bạn sẽ cần:
Mã truy cập Trang do một người có thể thực hiện tác vụ MESSAGE trên Trang đó yêu cầu
Quyền pages_messaging
Người nhận tin nhắn phải gửi tin nhắn cho Trang của bạn trong vòng 24 giờ qua hoặc đồng ý nhận tin nhắn từ Trang đó ngoài khoảng thời gian nhắn tin 24 giờ tiêu chuẩn
Giới hạn
Lưu ý rằng API Gửi không bao gồm recipient_id trong phản hồi cho các tin nhắn gửi bằng recipient.user_ref hoặc recipient.phone_number để xác định người nhận tin nhắn.
Yêu cầu mẫu
Để gửi tin nhắn cho một người, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messsages kèm theo nội dung tin nhắn. Ngoài ra, bạn phải đặt các thông số messaging_type và recipient.
Được định dạng để dễ đọc.Ví dụ dưới đây minh họa tin nhắn trả lời tin nhắn của một người. Trong đó, tin nhắn mà Trang của bạn đang gửi chỉ chứa văn bản.
curl -X POST "https://graph.facebook.com/v21.0/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
Sau khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Thông số
| Thông số | Mô tả | message
đối tượng | Loại tin nhắn mà Trang của bạn đang gửi. Bạn phải đặt text hoặc attachement khi sử dụng thông số này. |
messaging_type
enumBắt buộc | Loại tin nhắn đang gửi RESPONSE - Tin nhắn trả lời một tin nhắn đã nhận. Loại này bao gồm tin nhắn quảng cáo và tin nhắn không mang tính quảng cáo được gửi trong khoảng thời gian nhắn tin 24 giờ tiêu chuẩn. Ví dụ: Hãy dùng thẻ này để trả lời nếu một người yêu cầu xác nhận thông tin đặt chỗ hoặc cập nhật trạng thái. UPDATE - Tin nhắn được chủ động gửi đi và không phải là tin nhắn trả lời một tin nhắn đã nhận. Loại này bao gồm tin nhắn quảng cáo và tin nhắn không mang tính quảng cáo được gửi trong khoảng thời gian nhắn tin 24 giờ tiêu chuẩn.
|
notification_type
enum | Loại thông báo đẩy mà một người sẽ nhận NO_PUSH - Không có thông báo
REGULAR (mặc định) - Âm báo hoặc rung khi người dùng nhận được tin nhắn
SILENT_PUSH - Chỉ thông báo trên màn hình
|
recipient
đối tượngBắt buộc | Người sẽ nhận tin nhắn mà Trang của bạn đang gửi id - ID trong Trang của người dùng được sử dụng để gửi tin nhắn trả lời tin nhắn mà Trang của bạn nhận được trong vòng 24 giờ qua hoặc ID trong Trang của người dùng đã đồng ý nhận tin nhắn từ Trang đó ngoài khoảng thời gian nhắn tin 24 giờ tiêu chuẩn
user_ref - Mã tham chiếu của người dùng được sử dụng để gửi tin nhắn trả lời Ô để đánh dấu hoặc Plugin chat với khách hàng
comment_id - ID bình luận được dùng để gửi tin nhắn dưới dạng Tin trả lời riêng phản hồi Bình luận của khách truy cập về Bài viết trên trang
post_id - ID Bài viết trên trang được dùng để gửi tin nhắn dưới dạng Tin trả lời riêng phản hồi Bài viết của khách truy cập trên Trang
|
sender_action
enum | Biểu tượng hành động hiển thị trong khoảng thời gian nhắn tin biểu thị hành động do Trang thực hiện đối với tin nhắn mà Trang nhận được từ một người. typing_on - Hiển thị bong bóng đang nhập khi Trang đang soạn câu trả lời
typing_off - Không hiển thị bong bóng đang nhập
mark_seen - Hiển thị biểu tượng đã xem cho tin nhắn mà Trang đã xem
Chỉ được gửi bằng thông số recipient. Không thể gửi bằng thông số message. Bạn phải gửi qua yêu cầu riêng. |
tag
enum | Thẻ cho phép Trang gửi tin nhắn đến một người ngoài khoảng thời gian nhắn tin 24 giờ tiêu chuẩn. ACCOUNT_UPDATE - Gắn thẻ tin nhắn mà bạn đang gửi đến khách hàng dưới dạng thông tin cập nhật không định kỳ cho ứng dụng hoặc tài khoản của họ. Xem các trường hợp sử dụng được phép.  Không dùng được cho API Nhắn tin trên Instagram. CONFIRMED_EVENT_UPDATE - Gắn thẻ tin nhắn bạn đang gửi đến khách hàng dưới dạng lời nhắc cho sự kiện sắp diễn ra hoặc thông tin cập nhật về một sự kiện đang diễn ra mà khách hàng đã đăng ký. Xem các trường hợp sử dụng được phép. Không dùng được cho API Nhắn tin trên Instagram. HUMAN_AGENT - Bắt buộc đối với API Nhắn tin trên Instagram. Khi được thêm vào tin nhắn gửi đến một người, thẻ này sẽ cho phép nhân viên trả lời tin nhắn của người đó. Có thể gửi tin nhắn trong vòng 7 ngày sau khi người đó nhắn tin. Nhân viên sẽ hỗ trợ các vấn đề không thể giải quyết trong khoảng thời gian nhắn tin tiêu chuẩn. Xem các trường hợp sử dụng được phép. Quyền Human Agent không dùng được ở chế độ phát triển hoặc quyền truy cập tiêu chuẩn. Bạn sẽ cần hoàn tất quy trình xét duyệt ứng dụng thì mới có thể tận dụng thẻ human agent. Trong khi gửi ứng dụng đi xét duyệt, vui lòng cung cấp hướng dẫn rõ ràng và nội dung minh họa cách bạn định tận dụng thẻ human agent trong trải nghiệm của mình. POST_PURCHASE_UPDATE - Gắn thẻ tin nhắn bạn đang gửi đến khách hàng dưới dạng thông tin cập nhật về giao dịch mua gần đây mà khách hàng thực hiện. Xem các trường hợp sử dụng được phép. Không dùng được cho API Nhắn tin trên Instagram.
|
Cách sử dụng thẻ tin nhắn
Bảng dưới đây liệt kê các loại nhắn tin cho từng thẻ tin nhắn.
| Thẻ tin nhắn | Cách sử dụng | ACCOUNT_UPDATE
| Cách sử dụng hợp lệThông báo về sự thay đổi của trạng thái đăng ký, chẳng hạn như đối với thẻ tín dụng hoặc đơn ứng tuyển Thông báo về hoạt động đáng ngờ, chẳng hạn như cảnh báo hành vi gian lận
Cách sử dụng không hợp lệ (chưa đầy đủ)Nội dung quảng cáo, bao gồm nhưng không giới hạn ở ưu đãi, khuyến mãi, phiếu và mã giảm giá. Nội dung định kỳ (ví dụ: đã có bản sao kê, hóa đơn đến hạn thanh toán, tin tuyển dụng mới) Gợi ý tham gia bất kỳ cuộc khảo sát, cuộc thăm dò ý kiến hoặc bản đánh giá nào không liên quan đến sự tương tác trước đó trên Messenger
Không dùng được cho API Nhắn tin trên Instagram. |
CONFIRMED_EVENT_UPDATE
| Cách sử dụng hợp lệLời nhắc về lớp học, cuộc hẹn hoặc sự kiện sắp tới mà người dùng đã lên lịch Xác nhận việc người dùng đặt trước hoặc tham gia một cuộc hẹn/sự kiện đã chấp nhận Thông báo về việc di chuyển hoặc chuyến đi đã lên lịch của người dùng, chẳng hạn như việc đến nơi, hủy bỏ, hoãn nhận hành lý hoặc các thay đổi khác về tình trạng di chuyển
Cách sử dụng không hợp lệ (chưa đầy đủ)Nội dung quảng cáo, bao gồm nhưng không giới hạn ở khuyến mãi, ưu đãi, phiếu và mã giảm giá Nội dung liên quan đến sự kiện mà người dùng chưa đăng ký (ví dụ: lời nhắc mua vé sự kiện, bán chéo các sự kiện khác, lịch trình tham quan, v.v.) Tin nhắn liên quan đến các sự kiện trước đây Gợi ý tham gia bất kỳ cuộc khảo sát, cuộc thăm dò ý kiến hoặc bản đánh giá nào không liên quan đến sự tương tác trước đó trên Messenger
Không dùng được cho API Nhắn tin trên Instagram. |
CUSTOMER_FEEDBACK
| Cách sử dụng hợp lệCách sử dụng không hợp lệ (chưa đầy đủ)Không dùng được cho API Nhắn tin trên Instagram. |
HUMAN_AGENT
| Cách sử dụng hợp lệCách sử dụng không hợp lệ (chưa đầy đủ)Bắt buộc đối với API Nhắn tin trên Instagram. |
POST_PURCHASE_UPDATE
| Cách sử dụng hợp lệXác nhận giao dịch, chẳng hạn như hóa đơn hoặc biên lai Thông tin cập nhật trạng thái vận chuyển, chẳng hạn như đang vận chuyển, đã vận chuyển, đã giao sản phẩm hoặc trì hoãn giao hàng Thông tin cập nhật trạng thái yêu cầu người dùng hành động cho đơn đặt hàng mà họ đã đặt, chẳng hạn như thẻ tín dụng bị từ chối, đặt hàng dự trữ hoặc các thông tin cập nhật khác liên quan đến đơn đặt hàng mà người dùng cần hành động
Cách sử dụng không hợp lệ (chưa đầy đủ)Nội dung quảng cáo, bao gồm nhưng không giới hạn ở khuyến mãi, ưu đãi, phiếu và mã giảm giá Tin nhắn bán chéo hoặc bán nâng cấp các sản phẩm/dịch vụ Gợi ý tham gia bất kỳ cuộc khảo sát, cuộc thăm dò ý kiến hoặc bản đánh giá nào không liên quan đến sự tương tác trước đó trên Messenger
Không dùng được cho API Nhắn tin trên Instagram. |
