Chat Thread - Get Chat Message

Başvuru

Hizmet:: Communication

API Sürümü:: 2024-03-07

Kimliğine göre bir ileti alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
chatMessageId	path	True	string	İleti kimliği.
chatThreadId	path	True	string	İletinin gönderildiği iş parçacığı kimliği.
endpoint	path	True	string	Azure İletişim kaynağının uç noktası.
api-version	query	True	string	Çağrılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Authorization	True	string	ACS (Azure İletişim Hizmetleri) kullanıcı erişim belirteci.

Yanıtlar

Name	Tür	Description
200 OK	ChatMessage	İstek başarılı oldu. Eylem bir `Message` kaynağı döndürür.
401 Unauthorized	CommunicationErrorResponse	Yetkisiz.
403 Forbidden	CommunicationErrorResponse	Yasak.
429 Too Many Requests	CommunicationErrorResponse	Çok fazla istek var.
Other Status Codes	CommunicationErrorResponse	Hizmet kullanılamıyor.

Güvenlik

Authorization

ACS (Azure İletişim Hizmetleri) kullanıcı erişim belirteci.

Tür: apiKey
İçinde: header

Örnekler

Get Message

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 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"
  }
}

Durum kodu:: 401

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

Durum kodu:: 403

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

Durum kodu:: 429

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

Durum kodu:: 503

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

Tanımlar

Name	Description
ChatAttachment	Sohbet iletisindeki bir ek.
ChatAttachmentType	Ekin türü.
ChatMessage	Sohbet iletisi.
ChatMessageContent	Sohbet iletisinin içeriği.
ChatMessageType	Sohbet iletisi türü.
ChatParticipant	Sohbet yazışmasının katılımcısı.

ChatAttachment

Sohbet iletisindeki bir ek.

Name	Tür	Description
attachmentType	ChatAttachmentType	Ekin türü.
id	string	Ekin kimliği
name	string	Ek içeriğinin adı.
previewUrl	string	Ekin önizlemesinin indirilebildiği URL
url	string	Ekin indirilebildiği URL

ChatAttachmentType

Ekin türü.

Name	Tür	Description
file	string
image	string

ChatMessage

Sohbet iletisi.

Name	Tür	Description
content	ChatMessageContent	Sohbet iletisinin içeriği.
createdOn	string	Sohbet iletisinin sunucuya ulaştığı zaman damgası. Zaman damgası RFC3339 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.
deletedOn	string	İletinin silindiği zaman damgası (varsa). Zaman damgası RFC3339 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.
editedOn	string	İletinin düzenlendiği son zaman damgası (varsa). Zaman damgası RFC3339 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.
id	string	Sohbet iletisinin kimliği. Bu kimlik, sunucu tarafından oluşturulur.
metadata	object	İleti meta verileri.
senderCommunicationIdentifier	CommunicationIdentifierModel
senderDisplayName	string	Sohbet iletisini gönderenin görünen adı. Bu özellik, anında iletme bildirimleri için gönderen adını doldurmak için kullanılır.
sequenceId	string	Konuşmadaki sohbet iletisinin sırası.
type	ChatMessageType	Sohbet iletisi türü.
version	string	Sohbet iletisinin sürümü.

ChatMessageContent

Sohbet iletisinin içeriği.

Name	Tür	Description
attachments	ChatAttachment[]	Bu iletiye ilişkin eklerin listesi
initiatorCommunicationIdentifier	CommunicationIdentifierModel
message	string	Metin veya html türünde iletiler için sohbet iletisi içeriği.
participants	ChatParticipant[]	participantAdded veya participantRemoved türlerinde iletiler için sohbet iletisi içeriği.
topic	string	Konu başlığı türünde iletiler için sohbet iletisi içeriğiGüncelleştirilmiş.

ChatMessageType

Sohbet iletisi türü.

Name	Tür	Description
html	string
participantAdded	string
participantRemoved	string
text	string
topicUpdated	string

ChatParticipant

Sohbet yazışmasının katılımcısı.

Name	Tür	Description
communicationIdentifier	CommunicationIdentifierModel
displayName	string	Sohbet katılımcısının görünen adı.
shareHistoryTime	string	Sohbet geçmişinin katılımcıyla paylaşıldığı zaman. Zaman damgası RFC3339 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.

Aracılığıyla paylaş