Chat Thread - Get Chat Message

Odwołanie

Usługa:: Communication

Wersja interfejsu API:: 2024-03-15-preview

Pobiera komunikat według identyfikatora.

GET {endpoint}/chat/threads/{chatThreadId}/messages/{chatMessageId}?api-version=2024-03-15-preview

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
chatMessageId	path	True	string	Identyfikator wiadomości.
chatThreadId	path	True	string	Identyfikator wątku, do którego wysłano wiadomość.
endpoint	path	True	string	Punkt końcowy zasobu usługi Azure Communication.
api-version	query	True	string	Wersja interfejsu API do wywołania.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Authorization	True	string	Token dostępu użytkownika usługi ACS (Azure Communication Services).

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ChatMessage	Żądanie powiodło się. Akcja zwraca `Message` zasób.
401 Unauthorized	CommunicationErrorResponse	Brak autoryzacji.
403 Forbidden	CommunicationErrorResponse	Zakazane.
429 Too Many Requests	CommunicationErrorResponse	Zbyt wiele żądań.
Other Status Codes	CommunicationErrorResponse	Usługa niedostępna.

Zabezpieczenia

Authorization

Token dostępu użytkownika usługi ACS (Azure Communication Services).

Typ: apiKey
W: header

Przykłady

Get Message

Przykładowe żądanie

HTTP

GET https://contoso.westus.communications.azure.com/chat/threads/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/messages/1591768249318?api-version=2024-03-15-preview

Przykładowa odpowiedź

Kod stanu:: 200

{
  "id": "1591768249318",
  "sequenceId": "1",
  "type": "text",
  "version": "1599016601134",
  "content": {
    "message": "Let's head out for lunch in 15 minutes."
  },
  "senderDisplayName": "Jane",
  "createdOn": "2020-06-10T05:50:49.3180000Z",
  "senderCommunicationIdentifier": {
    "rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
    "communicationUser": {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
    }
  },
  "metadata": {
    "someKey1": "someValue1",
    "someKey2": "someValue2"
  }
}

Kod stanu:: 401

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

Kod stanu:: 403

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

Kod stanu:: 429

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

Kod stanu:: 503

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

Definicje

Nazwa	Opis
ChatAttachment	Załącznik w wiadomości czatu. Obecnie obsługiwane tylko w scenariuszach międzyoperacyjności usługi Teams.
ChatAttachmentType	Typ załącznika.
ChatMessage	Wiadomość na czacie.
ChatMessageContent	Zawartość wiadomości na czacie.
ChatMessageType	Typ wiadomości czatu.
ChatParticipant	Uczestnik wątku czatu.

ChatAttachment

Załącznik w wiadomości czatu. Obecnie obsługiwane tylko w scenariuszach międzyoperacyjności usługi Teams.

Nazwa	Typ	Opis
attachmentType	ChatAttachmentType	Typ załącznika.
id	string	Identyfikator załącznika
name	string	Nazwa zawartości załącznika.
previewUrl	string	Adres URL, pod którym można pobrać podgląd załącznika
url	string	Adres URL, pod którym można pobrać załącznik

ChatAttachmentType

Typ załącznika.

Nazwa	Typ	Opis
file	string
image	string

ChatMessage

Wiadomość na czacie.

Nazwa	Typ	Opis
content	ChatMessageContent	Zawartość wiadomości na czacie.
createdOn	string	Sygnatura czasowa, gdy wiadomość czatu dotarła na serwer. Znacznik czasu ma format RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
deletedOn	string	Sygnatura czasowa (jeśli ma zastosowanie) po usunięciu wiadomości. Znacznik czasu ma format RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
editedOn	string	Znacznik czasu ostatniego (jeśli dotyczy) podczas edycji wiadomości. Znacznik czasu ma format RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
id	string	Identyfikator wiadomości czatu. Ten identyfikator jest generowany przez serwer.
metadata	object	Metadane komunikatu.
senderCommunicationIdentifier	CommunicationIdentifierModel
senderDisplayName	string	Nazwa wyświetlana nadawcy wiadomości czatu. Ta właściwość służy do wypełniania nazwy nadawcy dla powiadomień wypychanych.
sequenceId	string	Sekwencja wiadomości czatu w konwersacji.
type	ChatMessageType	Typ wiadomości czatu.
version	string	Wersja wiadomości czatu.

ChatMessageContent

Zawartość wiadomości na czacie.

Nazwa	Typ	Opis
attachments	ChatAttachment[]	Lista załączników dla tej wiadomości
initiatorCommunicationIdentifier	CommunicationIdentifierModel
message	string	Zawartość wiadomości czatu dla wiadomości o typach tekstowych lub HTML.
participants	ChatParticipant[]	Zawartość wiadomości czatu dla wiadomości o typach uczestnikaDodaj lub uczestnikaRemoved.
topic	string	Zawartość wiadomości czatu dla wiadomości o typie topicUpdated.

ChatMessageType

Typ wiadomości czatu.

Nazwa	Typ	Opis
html	string
participantAdded	string
participantRemoved	string
text	string
topicUpdated	string

ChatParticipant

Uczestnik wątku czatu.

Nazwa	Typ	Opis
communicationIdentifier	CommunicationIdentifierModel
displayName	string	Nazwa wyświetlana uczestnika czatu.
metadata	object	Kontekstowe metadane uczestnika czatu. Metadane składają się z par nazwa/wartość. Całkowity rozmiar wszystkich par metadanych może wynosić do 1 KB.
shareHistoryTime	string	Czas, z którego historia czatu jest udostępniana uczestnikowi. Znacznik czasu ma format RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.

Udostępnij za pośrednictwem