---
title: "Написать в чат"
method: POST
path: "/api-v2/chats/{chatId}/messages"
tags: ["Сообщения чатов"]
---

# Написать в чат

`POST /api-v2/chats/{chatId}/messages`

## Request

- Base URL: `https://api-docs.yougile.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.yougile.com/api-v2/chats/{chatId}/messages`
- Auth: HTTP bearer

Чтобы упомянуть сотрудника, вставьте в поле text шорткод [!mention:<userId>!], где userId — ID сотрудника из GET /api-v2/users. Например: "[!mention:18a8bff2-f6b0-425a-9f89-3a003b8eb039!], посмотри задачу". Шорткод заменится на @Имя со ссылкой на профиль, сотрудник получит уведомление об упоминании, а в чате задачи станет подписчиком. Шорткод работает только в text и только без textHtml: textHtml сохраняется как есть. Шорткод с несуществующим userId остаётся в тексте без изменений.

## Path parameters

- `chatId` string, required

## Request body

- CreateChatMessageDto
  - `text` string, required: Текст сообщения
  - `textHtml` string, required: Текст сообщения в формате HTML
  - `label` string, required: Быстрая ссылка

## Response `201`

- ChatIdDto
  - `id` number, required: ID сообщения, также является временем создания

---

[API](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0.md) - [All operations](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/yougile/apis/yougile-rest-api-v2-0/revisions/9452cba35716?raw)