Chat Thread - Send Chat Read Receipt

Riferimento

Servizio:: Communication

Versione API:: 2024-03-07

Invia un evento di ricezione di lettura a un thread, per conto di un utente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
chatThreadId	path	True	string	ID thread a cui inviare l'evento di ricezione di lettura.
endpoint	path	True	string	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
chatMessageId	True	string	ID del messaggio di chat più recente letto dall'utente.

Risposte

Nome	Tipo	Descrizione
200 OK		Richiesta riuscita.
401 Unauthorized	CommunicationErrorResponse	Non autorizzato.
403 Forbidden	CommunicationErrorResponse	Vietato.
429 Too Many Requests	CommunicationErrorResponse	Troppe richieste.
Other Status Codes	CommunicationErrorResponse	Servizio non disponibile.

Sicurezza

Authorization

Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Tipo: apiKey
In: header

Esempio

Send read receipt

Esempio di richiesta

HTTP

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

{
  "chatMessageId": "1591137790240"
}

Risposta di esempio

Codice di stato:: 200

Codice di stato:: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}

Codice di stato:: 403

{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}

Codice di stato:: 429

{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}

Codice di stato:: 503

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

Definizioni

SendReadReceiptRequest

Object

Richiedere il payload per l'invio di una ricevuta di lettura.

Nome	Tipo	Descrizione
chatMessageId	string	ID del messaggio di chat più recente letto dall'utente.

Condividi tramite