다음을 통해 공유

Chat Thread - Send Chat Read Receipt

  • 참조
서비스:
Communication
API 버전:
2024-03-07

사용자를 대신하여 스레드에 읽음 확인 이벤트를 보냅니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
chatThreadId
 path True

string

읽기 확인 이벤트를 보낼 스레드 ID입니다.
endpoint
 path True

string

Azure Communication 리소스의 엔드포인트입니다.
api-version
 query True

string

호출할 API의 버전입니다.

요청 헤더

Name 필수 형식 Description
Authorization True

string

ACS(Azure Communication Services) 사용자 액세스 토큰입니다.

요청 본문

Name 필수 형식 Description
chatMessageId True

string

사용자가 읽은 최신 채팅 메시지의 ID입니다.

응답

Name 형식 Description
200 OK

요청이 성공했습니다.
401 Unauthorized

CommunicationErrorResponse

무단.
403 Forbidden

CommunicationErrorResponse

금지된.
429 Too Many Requests

CommunicationErrorResponse

요청이 너무 많습니다.
Other Status Codes

CommunicationErrorResponse

서비스를 사용할 수 없습니다.

보안

Authorization

ACS(Azure Communication Services) 사용자 액세스 토큰입니다.

형식: apiKey
In(다음 안에): 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"
}

샘플 응답

상태 코드:
200
상태 코드:
401 
{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}
상태 코드:
403 
{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}
상태 코드:
429 
{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}
상태 코드:
503 
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

정의

SendReadReceiptRequest

읽음 확인을 보내기 위한 페이로드를 요청합니다.

Name 형식 Description
chatMessageId

string

사용자가 읽은 최신 채팅 메시지의 ID입니다.