# Gửi tin tư vấn dạng hình ảnh {% hint style="info" %} **Lưu ý:** * Đối với các API sử dụng cho Shop thì API\_KEY: [``](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan#api-key).Thông tin base\_url của [Shop](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan) * Đối với các API sử dụng cho Partner thì API\_KEY: [``](https://docs.etelecom.vn/tich-hop-api/partner/su-dung#ket-noi-lan-thu-hai-tro-di).Thông tin base\_url của [Partner](https://docs.etelecom.vn/tich-hop-api/partner/tai-khoan) {% endhint %} ## POST $BASE\_URL.Zalo/OASendImage > OASendImage ```json {"openapi":"3.1.1","info":{"title":"API Document","version":"v1"},"tags":[{"name":"Zalo"}],"paths":{"$BASE_URL.Zalo/OASendImage":{"post":{"tags":["Zalo"],"summary":"OASendImage","operationId":"shop.Zalo-OASendImage","responses":{"200":{"description":"A successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/mrZlOAConversation"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/mrOASendImageRequest"}}},"required":true}}}},"components":{"schemas":{"mrZlOAConversation":{"type":"object","properties":{"direction":{"$ref":"#/components/schemas/nzMessageDirection"},"msg_id":{"type":"string"},"oa_id":{"type":"string","format":"int64"},"quota":{"$ref":"#/components/schemas/mrZlQuota"},"recipient_id":{"type":"string","format":"int64"},"sender_id":{"type":"string","format":"int64"},"shop_id":{"type":"string","format":"int64"},"type":{"$ref":"#/components/schemas/vqUIDType"},"user_id":{"type":"string","format":"int64"},"wl_partner_id":{"description":"ID dot.ID `json:\"id\"`\n","type":"string","format":"int64"},"zl_user_id":{"type":"string","format":"int64"}}},"nzMessageDirection":{"type":"string","enum":["in","out"]},"mrZlQuota":{"type":"object","properties":{"expired_date":{"type":"string"},"owner_id":{"type":"string"},"owner_type":{"type":"string"},"quota_type":{"type":"string"},"remain":{"type":"string"},"total":{"type":"string"}}},"vqUIDType":{"type":"string","enum":["unknown","text","audio","video","photo","GIF","link","file","sticker","location","business_card"]},"mrOASendImageRequest":{"type":"object","properties":{"message":{"$ref":"#/components/schemas/mrMessageImage"},"oa_id":{"type":"string","format":"int64"},"recipient":{"$ref":"#/components/schemas/mrRecipient"}}},"mrMessageImage":{"type":"object","properties":{"attachment_id":{"type":"string"},"buttons":{"type":"array","items":{"$ref":"#/components/schemas/mrButtonAttachment"}},"image_url":{"type":"string"},"text":{"type":"string"}}},"mrButtonAttachment":{"type":"object","properties":{"payload":{"$ref":"#/components/schemas/mrButtonPayload"},"title":{"type":"string"},"type":{"$ref":"#/components/schemas/aiTemplateTxnButtonType"}}},"mrButtonPayload":{"type":"object","properties":{"callback":{"type":"string"},"content":{"type":"string"},"phone_code":{"type":"string"},"url":{"type":"string"}}},"aiTemplateTxnButtonType":{"type":"string","enum":["unknown","oa.open.url","oa.query.show","oa.query.hide","oa.open.sms","oa.open.phone"]},"mrRecipient":{"type":"object","properties":{"user_id":{"type":"string","format":"int64"}}}}}} ``` \ **Request:** ```json curl --location 'BASE_URL.Zalo/OASendImage' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer $API_KEY' \ --data '{ "message": { "attachment_id": "string", "image_url": "string", "text": "string" "buttons": [ { "payload": { "callback": "string", "content": "string", "phone_code": "string", "url": "string" }, "title": "string", "type": "unknown" } ] }, "oa_id": "string", "recipient": { "user_id": "string" } } }' ``` **Response:** ```json { "direction": "in", "msg_id": "string", "oa_id": "string", "quota": { "expired_date": "string", "owner_id": "string", "owner_type": "string", "quota_type": "string", "remain": "string", "total": "string" }, "recipient_id": "string", "sender_id": "string", "shop_id": "string", "type": "unknown", "user_id": "string", "wl_partner_id": "string", "zl_user_id": "string" } ``` **Cấu trúc body của request**
Tham sốKiểu dữ liệuMô tả
attachment_idstringID hình ảnh, có được khi dùng API upload
image_urlstringURL hình ảnh
textstringTiêu đề của ảnh
Giới hạn tối đa là 2.000 ký tự
oa_idint64ID của OA
user_idstringID người dùng Zalo
typestringLoại action sẽ thực hiện khi người dùng bấm vào
titlestringNội dung chữ trên nút
payloadDữ liệu của action. Cấu trúc của payload phải phù hợp với từng loại action và được cho ở bảng bên dưới
**Cấu trúc cho các loại payload action được hỗ trợ**
Giá trị typeKiểu dữ liệuGiá trị payload và kết quả khi người dùng bấm vào
oa.open.urlstring

Data là một Url sẽ được mở trong ứng dụng Zalo khi người dùng bấm vào button. Ví dụ:
{
"title": "OPEN URL",
"payload" : {
"url": "https://developers.zalo.me/"
},
"type": "oa.open.url"
}

  • Chú ý: Giới hạn cho thuộc tính "title" là 100 kí tự.
oa.query.showstring

Data là một chuỗi ký tự ví dụ “#callback_data”. Khi người dùng bấm vào button, hệ thống sẽ gửi một tin nhắn có nội dung chứa trong data từ người dùng đến Official Account. Tin nhắn này sẽ hiện trên cửa sổ chat trên máy của người dùng. Ví dụ:
{
"title": "QUERY SHOW",
"type": "oa.query.show",
"payload": "#callback_data"
}

  • Chú ý:

    • Giới hạn cho thuộc tính "title" là 100 kí tự.
    • Giới hạn cho thuộc tính "payload" là 1000 kí tự.
oa.query.hidestring

Data là một chuỗi ký tự ví dụ “#callback_data”. Khi người dùng bấm vào button, hệ thống sẽ gửi một tin nhắn có nội dung chứa trong data từ người dùng đến Official Account. Tin nhắn này sẽ bị ẩn trên cửa sổ chat trên máy của người dùng. Ví dụ:
{
"title": "QUERY HIDE",
"type": "oa.query.hide",
"payload": "#callback_data"
}

  • Chú ý:

    • Giới hạn cho thuộc tính "title" là 100 kí tự.
    • Giới hạn cho thuộc tính "payload" là 1000 kí tự.
oa.open.smsjson object

Data đối tượng json chứa 2 thuộc tính “content” và “phoneCode”. Ví dụ:
{
"title": "OPEN SMS",
"type": "oa.open.sms",
"payload": {
"content":"alo",
"phone_code":""
}
}

Khi người dùng click vào button, cửa sổ sms trên điện thoại của người dùng sẽ được mở với 2 thông tin sẵn có là phone code và nội dung tin nhắn trong data.

  • Chú ý:

    • Giới hạn cho thuộc tính "title" là 100 kí tự.
    • Thuộc tính "content" có giới hạn là 160 kí tự.
oa.open.phonejson object

Data số điện thoại sẽ nhập vào khi bật ứng dụng gọi điện, ví dụ:
{
"title": "OPEN PHONE",
"type": "oa.open.phone",
"payload":{
"phone_code":""
}
}

Khi người dùng click vào button, cửa sổ call trên điện thoại của người dùng sẽ được mở với thông tin sẵn có là phone number trong data.

  • Chú ý: Giới hạn cho thuộc tính "title" là 100 kí tự.
**Cấu trúc thuộc tính dữ liệu trả về**
Tham sốKiểu dữ liệuMô tả
directionstring (nzMessageDirection)in
out
msg_idstringID của thông báo
oa_idstringID của OA
expired_datestringNgày hết hạn sử dụng tin Tư vấn miễn phí theo gói dịch vụ OA
remainstring
  • Số lượt gửi tin tin Tư vấn miễn phí trong hạn mức 8 tin 48 giờ còn lại (Tin gửi ra là tin trong khung 8 tin 48h - “reply”)
  • Số lượt gửi tin Tư vấn miễn phí theo gói dịch vụ OA còn lại (Tin gửi ra là tin nằm trong hạn mức miễn phí theo gói - “sub_quota”)
totalstringTổng số lượng gửi tin Tư vấn miễn phí theo gói dịch vụ OA
owner_idID thực thể sở hữu Quota Package
Giá trị: OA ID hoặc App ID
owner_typestringThực thể sở hữu Quota Package
Giá trị:
OA: Thực thể sở hữu là OA
App: Thực thể sở hữu là App
quota_typestringNguồn quota sử dụng Mang giá trị:
“reply”: Tin gửi ra là tin trong khung 8 tin 48h
“sub_quota”: Tin gửi ra là tin nằm trong hạn mức miễn phí theo gói
“purchase_quota”: Tin gửi ra là tin nằm trong hạn mức gói tính năng lẻ
“reward_quota”: Tin gửi ra là tin nằm trong hạn mức Redeem code
recipient_idstringID của người nhận
sender_idstringID người gửi
shop_idstringID của shop trên eTelecom
typestring (vqUIDType)"unknown" "text" "audio" "video" "photo" "GIF" "link" "file" "sticker" "location" "business_card"
user_idstringID user trên eTelecom
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.etelecom.vn/tich-hop-api/zalo-cloud/zalo-cloud-api/gui-tin-tu-van-dang-hinh-anh.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.