Chat Thread - Get Chat Message

Referência

Serviço:: Communication

Versão da API:: 2024-03-07

Obtém uma mensagem por ID.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
chatMessageId	path	True	string	A ID da mensagem.
chatThreadId	path	True	string	A ID do thread para a qual a mensagem foi enviada.
endpoint	path	True	string	O ponto de extremidade do recurso de Comunicação do Azure.
api-version	query	True	string	Versão da API a ser invocada.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Authorization	True	string	Um token de acesso de usuário do ACS (Serviços de Comunicação do Azure).

Respostas

Nome	Tipo	Description
200 OK	ChatMessage	Solicitação bem-sucedida. A ação retorna um recurso de `Message`.
401 Unauthorized	CommunicationErrorResponse	Desautorizado.
403 Forbidden	CommunicationErrorResponse	Proibido.
429 Too Many Requests	CommunicationErrorResponse	Muitas solicitações.
Other Status Codes	CommunicationErrorResponse	Serviço indisponível.

Segurança

Authorization

Um token de acesso de usuário do ACS (Serviços de Comunicação do Azure).

Tipo: apiKey
Em: header

Exemplos

Get Message

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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"
  }
}

Código de status:: 401

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

Código de status:: 403

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

Código de status:: 429

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

Código de status:: 503

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

Definições

Nome	Description
ChatAttachment	Um anexo em uma mensagem de chat.
ChatAttachmentType	O tipo de anexo.
ChatMessage	Mensagem de chat.
ChatMessageContent	Conteúdo de uma mensagem de chat.
ChatMessageType	O tipo de mensagem de chat.
ChatParticipant	Um participante do thread de chat.

ChatAttachment

Um anexo em uma mensagem de chat.

Nome	Tipo	Description
attachmentType	ChatAttachmentType	O tipo de anexo.
id	string	ID do anexo
name	string	O nome do conteúdo do anexo.
previewUrl	string	A URL em que a visualização do anexo pode ser baixada
url	string	A URL em que o anexo pode ser baixado

ChatAttachmentType

O tipo de anexo.

Nome	Tipo	Description
file	string
image	string

ChatMessage

Mensagem de chat.

Nome	Tipo	Description
content	ChatMessageContent	Conteúdo de uma mensagem de chat.
createdOn	string	O carimbo de data/hora quando a mensagem de chat chegou ao servidor. O carimbo de data/hora está no formato RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
deletedOn	string	O carimbo de data/hora (se aplicável) quando a mensagem foi excluída. O carimbo de data/hora está no formato RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
editedOn	string	O último carimbo de data/hora (se aplicável) quando a mensagem foi editada. O carimbo de data/hora está no formato RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.
id	string	A ID da mensagem de chat. Essa ID é gerada pelo servidor.
metadata	object	Metadados de mensagem.
senderCommunicationIdentifier	CommunicationIdentifierModel
senderDisplayName	string	O nome de exibição do remetente da mensagem de chat. Essa propriedade é usada para preencher o nome do remetente para notificações por push.
sequenceId	string	Sequência da mensagem de chat na conversa.
type	ChatMessageType	O tipo de mensagem de chat.
version	string	Versão da mensagem de chat.

ChatMessageContent

Conteúdo de uma mensagem de chat.

Nome	Tipo	Description
attachments	ChatAttachment[]	Lista de anexos para esta mensagem
initiatorCommunicationIdentifier	CommunicationIdentifierModel
message	string	Conteúdo da mensagem de chat para mensagens de tipos de texto ou html.
participants	ChatParticipant[]	Conteúdo da mensagem de chat para mensagens dos tipos de participante Adicionados ou participanteRemoved.
topic	string	Conteúdo da mensagem de chat para mensagens do tipo topicUpdated.

ChatMessageType

O tipo de mensagem de chat.

Nome	Tipo	Description
html	string
participantAdded	string
participantRemoved	string
text	string
topicUpdated	string

ChatParticipant

Um participante do thread de chat.

Nome	Tipo	Description
communicationIdentifier	CommunicationIdentifierModel
displayName	string	Nome de exibição para o participante do chat.
shareHistoryTime	string	Hora da qual o histórico de chat é compartilhado com o participante. O carimbo de data/hora está no formato RFC3339: `yyyy-MM-ddTHH:mm:ssZ`.

Compartilhar via