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ắt đầu
Bạn sẽ cần:
Mã truy cập Trang theo yêu cầu của một người, có thể thực hiện tác vụ MESSAGE
trên Trang đó
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 của bạn ngoài khoảng thời gian nhắn tin tiêu chuẩn 24 giờ
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.
Mẫu yêu cầu
Để nhắn tin cho một người, hãy gửi yêu cầu POST
đến điểm cuối /PAGE-ID/messsages
, trong đó có các thông số là messaging_type
và recipient
kèm theo nội dung tin nhắn.
Có định dạng dễ đọc.Sau đây là ví dụ về nội dung 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ỉ ở dạng văn bản.
curl -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
?recipient={'id':'PSID'}
&messaging_type=RESPONSE
&message={'text':'hello,world'}
&access_token=PAGE-ACCESS-TOKEN
Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON như sau:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
Thông số
Thông số | Mô tả | message object | Loại tin nhắn mà Trang của bạn đang gửi. Phải thiết lập text hoặc attachement khi dùng thông số này. |
messaging_type enumBắt buộc | Loại tin nhắn được gửi RESPONSE – Tin nhắn dùng để trả lời 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 quảng cáo được gửi trong khoảng thời gian nhắn tin tiêu chuẩn 24 giờ. Ví dụ: dùng thẻ này khi trả lời một người yêu cầu xác nhận đặt chỗ hoặc cập nhật trạng thái.
|
notification_type enum | Loại thông báo đẩy mà một người sẽ nhận được NO_PUSH – Không có thông báo
REGULAR (mặc định) – Có âm thanh hoặc rung khi một người nhận được tin nhắn
SILENT_PUSH – Chỉ có thông báo trên màn hình
|
recipient objectBắt buộc | Một người sẽ nhận được tin nhắn mà Trang của bạn đang gửi id – ID trong Trang cho một người và dùng để trả lời tin nhắn mà Trang của bạn nhận được trong vòng 24 giờ qua hoặc cho một người đã đồng ý nhận tin nhắn từ Trang của bạn ngoài khoảng thời gian nhắn tin tiêu chuẩn 24 giờ
user_ref – Thông tin tham chiếu cho một người, dùng để gửi tin nhắn phản hồi Ô để đánh dấu hoặc Plugin chat với khách hàng
comment_id – ID cho bình luận, dùng để gửi tin nhắn dưới dạng Tin trả lời riêng tư nhằm phản hồi Bình luận của khách truy cập về Bài viết trên Trang của bạn
post_id – ID cho Bài viết trên Trang, dùng để gửi tin nhắn dưới dạng Tin trả lời riêng tư nhằm phản hồi Bài viết của khách truy cập trên Trang của bạn
|
sender_action enum | Biểu tượng hành động hiển thị trong khoảng thời gian nhắn tin, cho biết hành động của Trang đối với tin nhắn mà Trang nhận được từ một người. typing_on – Hiển thị bong bóng nhập khi Trang đang chuẩn bị trả lời
typing_off – Không hiển thị bong bóng nhập
mark_seen – Hiển thị biểu tượng đã xem cho những tin nhắn mà Trang đã xem
Chỉ gửi kèm được với thông số recipient . Không gửi kèm được với thông số message mà phải gửi dưới dạng yêu cầu riêng. |
tag enum | Với thẻ này, Trang của bạn có thể gửi tin nhắn cho một người ngoài khoảng thời gian nhắn tin tiêu chuẩn 24 giờ. ACCOUNT_UPDATE – Gắn thẻ tin nhắn bạn đang gửi cho khách hàng là thông tin cập nhật không định kỳ về ứng dụng hoặc tài khoản của họ. Xem các trường hợp sử dụng hợp lệ. Không dành cho API Nhắn tin trên Instagram. CONFIRMED_EVENT_UPDATE – Gắn thẻ tin nhắn bạn đang gửi cho khách hàng là lời nhắc cho sự kiện sắp tới hoặc thông tin cập nhật về sự kiện đang diễn ra mà khách hàng đã đăng ký. Xem các trường hợp sử dụng hợp lệ. Không dành 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 bạn thêm thẻ này vào tin nhắn để gửi cho một người, nhân viên có thể trả lời tin nhắn của người đó. Bạn có thể gửi tin nhắn trong vòng 7 ngày kể từ khi nhận được tin nhắn của một người. Dịch vụ nhân viên hỗ trợ là biện pháp dành cho những vấn đề không thể giải quyết được trong khoảng thời gian nhắn tin tiêu chuẩn. Xem các trường hợp sử dụng hợp lệ. Quyền Human Agent không có ở chế độ phát triển hoặc truy cập tiêu chuẩn. Bạn cần hoàn tất quy trình xét duyệt ứng dụng thì mới có thể dùng thẻ nhân viên. 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à minh họa cách bạn định dùng thẻ nhân viên trong trải nghiệm của mình. POST_PURCHASE_UPDATE – Gắn thẻ tin nhắn bạn đang gửi cho khách hàng là thông tin cập nhật về giao dịch mua gần đây của khách hàng. Xem các trường hợp sử dụng hợp lệ. Không dành cho API Nhắn tin trên Instagram.
|
Cách sử dụng thẻ tin nhắn
Sau đây là bảng liệt kê các loại tin nhắn 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 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 ở khuyến mãi, ưu đã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) Lời nhắc về bất kỳ khảo sát, cuộc thăm dò ý kiến hoặc bài đánh giá nào không liên quan đến hoạt động tương tác trước đây trong Messenger
Không dành 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 Thông tin xác nhận đặt chỗ, tham dự sự kiện hoặc có mặt tại cuộc hẹn mà người dùng chấp nhận Thông báo về hoạt động di chuyển hoặc chuyến đi theo lịch của người dùng, chẳng hạn như thời gian đến, tình trạng hủy chuyến, hành lý đến chậm hay các thay đổi khác về trạng thái 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é tham dự sự kiện, nội dung bán chéo sự kiện khác, lịch trình tham quan, v.v.) Tin nhắn liên quan đến sự kiện đã qua Lời nhắc về bất kỳ khảo sát, cuộc thăm dò ý kiến hoặc bài đánh giá nào không liên quan đến hoạt động tương tác trước đây trong Messenger
Không dành 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ành 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ệThông tin 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 sản phẩm, chẳng hạn như đang vận chuyển, đã vận chuyển, đã giao hàng hoặc bị chậm Thông tin cập nhật trạng thái cho biết người dùng cần có biện pháp xử lý đối với đơn đặt hàng, chẳng hạn như thẻ tín dụng bị từ chối, mặt hàng đặt trước trong trường hợp thiếu nguồn cung hoặc các thông tin cập nhật khác về đơn đặt hàng cần người dùng xử lý
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 sản phẩm/dịch vụ Lời nhắc về bất kỳ khảo sát, cuộc thăm dò ý kiến hoặc bài đánh giá nào không liên quan đến hoạt động tương tác trước đây trong Messenger
Không dành cho API Nhắn tin trên Instagram. |