Поделиться через


Chat Thread - Send Chat Read Receipt

Отправляет событие получения на чтение потоку от имени пользователя.

POST {endpoint}/chat/threads/{chatThreadId}/readReceipts?api-version=2024-03-07

Параметры URI

Имя В Обязательно Тип Описание
chatThreadId
path True

string

Идентификатор потока для отправки события получения сведений.

endpoint
path True

string

Конечная точка ресурса связи Azure.

api-version
query True

string

Версия API для вызова.

Заголовок запроса

Имя Обязательно Тип Описание
Authorization True

string

Маркер доступа пользователей ACS (Службы коммуникации Azure).

Текст запроса

Имя Обязательно Тип Описание
chatMessageId True

string

Идентификатор последнего сообщения чата, прочитанного пользователем.

Ответы

Имя Тип Описание
200 OK

Запрос успешно выполнен.

401 Unauthorized

CommunicationErrorResponse

Несанкционированный.

403 Forbidden

CommunicationErrorResponse

Запретный.

429 Too Many Requests

CommunicationErrorResponse

Слишком много запросов.

Other Status Codes

CommunicationErrorResponse

Служба недоступна.

Безопасность

Authorization

Маркер доступа пользователей ACS (Службы коммуникации Azure).

Тип: apiKey
В: header

Примеры

Send read receipt

Образец запроса

POST https://contoso.westus.communications.azure.com/chat/threads/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/readReceipts?api-version=2024-03-07

{
  "chatMessageId": "1591137790240"
}

Пример ответа

{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}
{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}
{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

Определения

SendReadReceiptRequest

Запрос полезных данных для отправки квитанции на чтение.

Имя Тип Описание
chatMessageId

string

Идентификатор последнего сообщения чата, прочитанного пользователем.