---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/tin-nhan/cac-loai-tin-khac/gui-tin-nhan-dang-anh-den-nguoi-dung-an-danh
title: Gửi tin nhắn dạng ảnh đến người dùng ẩn danh
---
# Gửi tin nhắn dạng ảnh đến người dùng ẩn danh

:::warning Lưu ý
**Quyền cần có:** Quyền gửi tin và thông báo qua OA
:::

## HTTP request

- **URL:** https://openapi.zalo.me/v2.0/oa/message 
- **Method:** POST 
- **Content Type:** application/json 
- **Response Type:** text/json

## Example request

```bash
curl \
-X POST \
-H 'Content-Type: application/json' \
-H 'access_token: <your_access_token>' \
-d '{ 
  "recipient": {
    "anonymous_id": "1ffedc467f179649cf06",
    "conversation_id": "fa8f3f8701c2e89cb1d3"
  },
  "message": {
    "attachment": {
        "type": "template",
        "payload": {
            "template_type": "media",
            "elements": [{
                "media_type": "image",
                "attachment_id": "51586aa2e5a40cfa55b5"
            }[]
        }
    }
  }
}' "https://openapi.zalo.me/v2.0/oa/message"
```

### Tham số header


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token [tại đây](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


### Cấu trúc body của request


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| recipient | object | yes | Thông tin người nhận |
| message | object | yes | Nội dung cần gửi |


### Cấu trúc thuộc tính recipient


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| anonymous_id | string | yes | Id đại diện cho người dùng ẩn danh. |
| conversation_id | string | yes | Id của cuộc hội thoại. |


### Cấu trúc thuộc tính message


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| attachment | object | yes | Attachment cần gửi. |


### Cấu trúc thuộc tính message.attachment


| Tham số | Loại | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| type | string | yes | Loại attachment. Giá trị nhận vào bắt buộc: - `type` = template |
| payload | object | yes | Chứa payload của attachment muốn gửi. |


### Cấu trúc thuộc tính message.attachment.payload


| Tham số | Loại | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| template_type | string | yes | Loại template Với template gửi thông báo theo mẫu đính kèm ảnh, giá trị nhận vào là: - `template_type` = media |
| elements | array | yes | Các đối tượng của template. Lưu ý: Cấu trúc element thay đổi tùy theo loại template. Với template media, danh sách element bao gồm tối đa 1 phần tử. |


### Cấu trúc thuộc tính message.attachment.payload.element


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| media_type | string | yes | Loại media. Các giá trị nhận vào: image |
| url | string | yes | Đường dẫn đến ảnh Các định dạng ảnh hỗ trợ: jpg và png Dung lượng tối đa: 1MB |


## Example respond
```json
{
    "data": {
        "message_id": "92abd4e6156c8333da7c",
        "anonymous_id": "1ffedc467f179649cf06",
        "conversation_id": "fa8f3f8701c2e89cb1d3"
    },
    "error": 0,
    "message": "Success"
}
```

### Cấu trúc thuộc tính data 


| Thuộc tính | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| message_id | string | Id của tin nhắn. |
| anonymous_id | string | Id đại diện người dùng ẩn danh. |
| conversation_id | string | Id của cuôc hội thoại. |