---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/nhom-chat-gmf/tin-nhan/file_message
title: Gửi tin nhắn nhóm dạng File
---
# Gửi tin nhắn nhóm dạng File

:::warning Lưu ý
Ứng dụng cần được cấp quyền quản lý thông tin nhóm.
:::

## HTTP request

- **URL:** [https://openapi.zalo.me/v3.0/oa/group/message](//openapi.zalo.me/v3.0/oa/group/message)
- **Method:** POST
- **Content Type:** application/json
- **Response Type:** text/json

## Example request

```bash
curl --location --request POST 'https://openapi.zalo.me/v3.0/oa/group/message' \
--header 'access_token: <your_access_token>' \
--header 'Content-Type: application/json' \
--data '{
    "recipient": {
        "group_id": "f414c8f76fa586fbdfb4"
    },
    "message": {
        "attachment": {
            "type": "file",
            "payload": {
                "token": "12i8LV3BcmmDS4iLfyoU3qKxHXNtpu077ZjA7xRHmmi8EXrEjuR50LHjJXJWWvTQ17OJ7R2Oc5q4SHSJjPoPKmDq5X2tyS4MI78oKexCna1CUJnQyiMvUKmfG7UOX8PYVW5FJAckbWbi1tWbj8BnCNOyTGMBr8mrG5XZ4epkfbD4HczzjUs3FM0QL1ZM"
            }
        }
   }
}
'
```

### 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 | json object | yes | Thông tin người nhận |
| message | json object | yes | Nội dung tin nhắn |


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

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| group_id | string | yes | ID của nhóm |


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

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


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

| Tham số | Kiểu dữ liệu | 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`=file |
| payload | json object | yes | Chứa payload của attachment muốn gửi. Xem cấu trúc payload tại mục bên dưới. |


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

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| token | string | yes | Chuỗi token được trả về khi sử dụng API upload file. |


## Example respond

```json
{
    "data": {
        "message_id": "81d74a9cd71d6f473608",
        "group_id": "f414c8f76fa586fbdfb4"
    },
    "error": 0,
    "message": "Success"
}
```

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

| Tham số | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| message_id | string | ID của tin nhắn mới được gửi |
| group_id | string | ID của nhóm |

####