Gửi tin nhắn

Tài liệu này trình bày các yêu cầu về việc gửi tin nhắn ở dạng tự do từ tài khoản Công việc trên Instagram đến khách hàng hoặc những người quan tâm đến tài khoản của bạn thông qua Nền tảng Messenger từ Meta.

Bạn có thể gửi tin nhắn dạng tự do chứa:

• hình ảnh, video, file gif hoặc âm thanh
• cảm xúc hoặc nhãn dán
• văn bản, kể cả liên kết

Trước khi bắt đầu

Hướng dẫn này giả định rằng bạn đã đọc phần Tổng quan về Nền tảng Messenger, đã triển khai các thành phần cần thiết - chẳng hạn như Trang Facebook liên kết với tài khoản Công việc trên Instagram (hoặc Trang thử nghiệm), đã đăng ký với vai trò nhà phát triển của Meta và đã tạo ID ứng dụng dành cho doanh nghiệp với Messenger > sản phẩm Nhắn tin trên Instagram trong Bảng điều khiển ứng dụng.

Bạn cũng nên kiểm tra trạng thái Nền tảng dành cho nhà phát triển của Meta để đảm bảo không có vấn đề gì.

Yêu cầu

• ID Trang Facebook liên kết với tài khoản Công việc trên Instagram
• ID trong Instagram của khách hàng đã gửi tin nhắn cho doanh nghiệp bạn
• Mã truy cập Trang do một người có thể thực hiện tác vụ MESSAGE trên Trang Facebook liên kết với tài khoản Công việc trên Instagram của bạn yêu cầu
• Quyền instagram_manage_messages

Giới hạn

• Các ứng dụng có Quyền truy cập tiêu chuẩn chỉ có thể gửi tin nhắn cho những người có vai trò trên ứng dụng
• File phương tiện đính kèm có thể là:

Để biết thêm thông tin về file phương tiện đính kèm, hãy xem bài biết Tải file phương tiện lên để nhắn tin trên Instagram.

Gửi tin nhắn cơ bản

Để gửi tin nhắn chứa văn bản hoặc liên kết, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thông số recipient chứa ID trong Instagram (IGSID) và thông số message chứa văn bản hoặc liên kết.

Nội dung tin nhắn phải ở dạng UTF-8 và không vượt quá 1.000 byte. Liên kết phải là URL có định dạng hợp lệ.

Yêu cầu mẫu

Được định dạng để dễ đọc.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

Phản hồi API mẫu

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": "IGSID",
  "message_id": "MESSAGE-ID"
}

Gửi bài viết đã đăng

Để gửi tin nhắn chứa bài viết bạn đã đăng lên Instagram, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thông số recipient chứa ID trong Instagram (IGSID) và thông số message chứa đối tượng attachment có type được đặt thành MEDIA_SHARE và payload chứa ID bài viết trên Meta.

Doanh nghiệp bạn phải sở hữu file phương tiện sẽ được dùng trong tin nhắn.

Yêu cầu mẫu

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

Phản hồi API mẫu

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": "IGSID",
  "message_id": "MESSAGE-ID"
}

Gửi nhãn dán

Để gửi nhãn dán trái tim, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thông số recipient chứa ID trong Instagram (IGSID) và thông số message chứa đối tượng attachment có type được đặt thành like_heart.

Yêu cầu mẫu

Được định dạng để dễ đọc.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

Phản hồi API mẫu

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": "IGSID",
  "message_id": "MESSAGE-ID"
}

Bày tỏ cảm xúc về tin nhắn

Để gửi cảm xúc, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thông số recipient chứa ID trong Instagram (IGSID) và thông số sender_action được đặt thành react có payload chứa message_id là ID của tin nhắn được bày tỏ cảm xúc và reaction là love.

Yêu cầu mẫu

Được định dạng để dễ đọc.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

Để gỡ cảm xúc khỏi tin nhắn, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với thông số recipient chứa ID trong Instagram (IGSID) và thông số sender_action được đặt thành unreact có payload chứa message_id là ID của tin nhắn sẽ được gỡ cảm xúc.

Yêu cầu mẫu

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

Phản hồi mẫu

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây cho yêu cầu bày tỏ cảm xúc và hủy bày tỏ cảm xúc:

{
  "recipient_id": "IGSID"
}

Bước tiếp theo

• Tải file phương tiện như âm thanh hoặc hình ảnh lên máy chủ của Meta để sử dụng trong nhiều tin nhắn.

• Gửi tin nhắn có cấu trúc, chẳng hạn như mẫu chung, mẫu sản phẩm hoặc menu cố định.

Xem thêm

• Mã lỗi
• Giới hạn tốc độ của tính năng Nhắn tin trên Instagram
• Lấy ID file phương tiện cho tài sản phương tiện