Gửi tin nhắn

Quý khách hàng - đối tác có thể dùng API này để tương tác với khách hàng trên fanpage ( gửi tin nhắn, hình ảnh...)

Sau khi nhận thông tin từ webook gửi về, xem cấu hình nhận tin nhắn - thông báo trên Fanpage mục Webhook tin nhắn , Quý khách hàng sẽ có các thông tin cần thiết như id hội thoại, id fanpage, pagescopeid, text message từ Fanpage gửi về. Để tương tác và reply lại khách , Quý khách hàng - đối tác cần tạo Access Token để tương cấp quyền xác thực trên mỗi request đến API của Abitmes, Xem mục Khởi tạo Access Token để lấy quyền truy cập và tương tác.

URL API: https://api.abitmes.vn

POST /api/partner/{ma_shop}/{access_token}/send-message?page_id={id_page}

Trong đó:

Name	Value
{ma_shop}	tương ứng là Tên khách hàng khi khởi tạo Access Token, Xem tại đây
{access_token}	Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo Access Token
{id_page}	Là ID Fanpage , giá trị này có thể trả về trên boby webhook của tin nhắn

Url example: https://api.abitmes.vn/api/partner/Abit/NWUxMzU5ZmZjZjc5YzAyYTY1YTcyNWE0ZTQ2OTdmM2Q=/send-message?page_id=2013792605578989

API này Abit mô phỏng và giữ nguyên định dạng body chuẩn của Facebook theo tài liệu của Facebook https://developers.facebook.com/docs/messenger-platform/send-messages

Thử nghiệm với Postman:

https://api.postman.com/collections/2953703-42320021-a4aa-4b8d-a9d0-1029d557ebb7?access_key=PMAT-01K5QWGH0NYSG2B7CPY3Q0WFBV

Headers

Name	Value
Content-Type	application/json

Gửi tin nhắn Text cơ bản cho khách

Body

Name	Type	Description
recipient		Thông tin người nhận tin nhắn phản hồi
id	string	ID của khách chat trên fanpage, giá trị này tương ứng là page_scopeid trong boby json của webhook bắn về
message		Nội dung tin nhắn phản hồi khách hàng
text	string	Loại tin nhắn phản hồi khách hàng, trong ví dụ là tin nhắn text phản hồi khách

Body

{
    "recipient": {
        "id": "2298104106936206"
    },
    "message": {
        "text": "hello 3"
    }
}

Response

{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m__NF_55z0NiqkoAzzxL02eKUlmN3hacJV4y1OXCAslPGGvgnfIGU_MAzV-6qDkpZhcaqwDiaETWUW2xsyFFKPaQ"
    }
}

Gửi 1 ảnh

Body

{
   "recipient":{
      "id":"2298104106936206"
   },
   "message":{
      "attachment":{
         "type":"image",
         "payload":{
            "url":"https://blog.abitstore.vn/frontend/assets/img/trangchu/banner-abitstore.jpg",
            "is_reusable":true
         }
      }
   }
}

Response

{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m_WXfwQr2F7t4wX8K8Ji-No6UlmN3hacJV4y1OXCAslPHqAIctqob-3KyogDm8szEHqUufZLl3WnmQEIfi7zesRg",
        "attachment_id": "839896582031502"
    }
}

Gửi nhiều ảnh

Body

{
   "recipient":{
      "id":"2298104106936206"
   },
   "message":{
      "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "https://blog.abitstore.vn/frontend/assets/img/trangchu/banner-abitstore.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "https://blog.abitstore.vn/photos/MrChinh.SEO/1.jpg"
        }
      }
    ]
   }
}

Response

{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m_5ZzmrZn7NnvZNcqp26yuR6UlmN3hacJV4y1OXCAslPElfD5czAvpuwDdp6loR3tzGFy22OQUeizANneF5ebmwg"
    }
}