Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Пересылайте сообщение чата, сообщение канала или ответ на сообщение канала в чат.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба |
Правительство США L4 |
Правительство США L5 (DOD) |
Китай управляется 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
| Тип разрешения |
Разрешения с наименьшими привилегиями |
Более высокие привилегированные разрешения |
| Делегированные (рабочая или учебная учетная запись) |
ChatMessage.Send |
Недоступно. |
| Делегированные (личная учетная запись Майкрософт) |
Не поддерживается. |
Не поддерживается. |
| Для приложений |
Не поддерживается. |
Не поддерживается. |
HTTP-запрос
Переадресация chatMessage в чате:
POST /chats/{chatId}/messages/forwardToChat
Переадресация chatMessage в канале в чат:
POST /teams/{teamId}/channels/{channelId}/messages/forwardToChat
POST /teams/{teamId}/channels/{channelId}/messages/{messageId}/replies/forwardToChat
Текст запроса
В тексте запроса укажите представление параметров в формате JSON.
В следующей таблице указаны параметры, которые можно использовать с этим действием.
| Параметр |
Тип |
Описание |
| additionalMessage |
chatMessage |
Текст пересылаемого сообщения. |
| messageIds |
Коллекция строк |
Список идентификаторов сообщений в чате или канале, которые перенаправляются. В настоящее время поддерживается только один идентификатор сообщения. |
| targetChatIds |
Коллекция строк |
Список идентификаторов целевого чата, куда можно пересылать сообщение. В настоящее время поддерживается только один идентификатор целевого чата. |
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов forwardToChatResult в тексте отклика.
Примечание.
Так как в полезных данных запроса поддерживается только один идентификатор целевого чата, ответ содержит только одно значение.
Примеры
Пример 1. Пересылка сообщения из чата в чат
В следующем примере показано, как пересылать сообщение из чата в чат.
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/chats/19:97641583cf154265a237da28ebbde27a@thread.v2/messages/forwardToChat
Content-Type: application/json
{
"targetChatIds": [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
],
"messageIds": [
"1728088338580"
],
"additionalMessage": {
"body": {
"content": "Hello World"
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Chats.Item.Messages.ForwardToChat;
using Microsoft.Graph.Beta.Models;
var requestBody = new ForwardToChatPostRequestBody
{
TargetChatIds = new List<string>
{
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
},
MessageIds = new List<string>
{
"1728088338580",
},
AdditionalMessage = new ChatMessage
{
Body = new ItemBody
{
Content = "Hello World",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Chats["{chat-id}"].Messages.ForwardToChat.PostAsForwardToChatPostResponseAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphchats "github.com/microsoftgraph/msgraph-beta-sdk-go/chats"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphchats.NewForwardToChatPostRequestBody()
targetChatIds := []string {
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
}
requestBody.SetTargetChatIds(targetChatIds)
messageIds := []string {
"1728088338580",
}
requestBody.SetMessageIds(messageIds)
additionalMessage := graphmodels.NewChatMessage()
body := graphmodels.NewItemBody()
content := "Hello World"
body.SetContent(&content)
additionalMessage.SetBody(body)
requestBody.SetAdditionalMessage(additionalMessage)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
forwardToChat, err := graphClient.Chats().ByChatId("chat-id").Messages().ForwardToChat().PostAsForwardToChatPostResponse(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.chats.item.messages.forwardtochat.ForwardToChatPostRequestBody forwardToChatPostRequestBody = new com.microsoft.graph.beta.chats.item.messages.forwardtochat.ForwardToChatPostRequestBody();
LinkedList<String> targetChatIds = new LinkedList<String>();
targetChatIds.add("19:e2ed97baac8e4bffbb91299a38996790@thread.v2");
forwardToChatPostRequestBody.setTargetChatIds(targetChatIds);
LinkedList<String> messageIds = new LinkedList<String>();
messageIds.add("1728088338580");
forwardToChatPostRequestBody.setMessageIds(messageIds);
ChatMessage additionalMessage = new ChatMessage();
ItemBody body = new ItemBody();
body.setContent("Hello World");
additionalMessage.setBody(body);
forwardToChatPostRequestBody.setAdditionalMessage(additionalMessage);
var result = graphClient.chats().byChatId("{chat-id}").messages().forwardToChat().post(forwardToChatPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const actionResultPart = {
targetChatIds: [
'19:e2ed97baac8e4bffbb91299a38996790@thread.v2'
],
messageIds: [
'1728088338580'
],
additionalMessage: {
body: {
content: 'Hello World'
}
}
};
await client.api('/chats/19:97641583cf154265a237da28ebbde27a@thread.v2/messages/forwardToChat')
.version('beta')
.post(actionResultPart);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Chats\Item\Messages\ForwardToChat\ForwardToChatPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\ChatMessage;
use Microsoft\Graph\Beta\Generated\Models\ItemBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForwardToChatPostRequestBody();
$requestBody->setTargetChatIds(['19:e2ed97baac8e4bffbb91299a38996790@thread.v2', ]);
$requestBody->setMessageIds(['1728088338580', ]);
$additionalMessage = new ChatMessage();
$additionalMessageBody = new ItemBody();
$additionalMessageBody->setContent('Hello World');
$additionalMessage->setBody($additionalMessageBody);
$requestBody->setAdditionalMessage($additionalMessage);
$result = $graphServiceClient->chats()->byChatId('chat-id')->messages()->forwardToChat()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Teams
$params = @{
targetChatIds = @(
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
)
messageIds = @(
"1728088338580"
)
additionalMessage = @{
body = @{
content = "Hello World"
}
}
}
Invoke-MgBetaForwardChatMessageToChat -ChatId $chatId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.chats.item.messages.forward_to_chat.forward_to_chat_post_request_body import ForwardToChatPostRequestBody
from msgraph_beta.generated.models.chat_message import ChatMessage
from msgraph_beta.generated.models.item_body import ItemBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ForwardToChatPostRequestBody(
target_chat_ids = [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
],
message_ids = [
"1728088338580",
],
additional_message = ChatMessage(
body = ItemBody(
content = "Hello World",
),
),
)
result = await graph_client.chats.by_chat_id('chat-id').messages.forward_to_chat.post(request_body)
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.forwardToChatResult)",
"value": [
{
"@odata.type": "#microsoft.graph.forwardToChatResult",
"targetChatId": "19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
"forwardedMessageId": "1730918320559",
"error": null
}
]
}
Пример 2. Пересылка сообщения из канала в чат
В следующем примере показано, как пересылать сообщение из канала в чат.
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:b6343216390d46cba965fe36bd877674@thread.tacv2/messages/forwardToChat
Content-Type: application/json
{
"targetChatIds": [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
],
"messageIds": [
"1728088338580"
],
"additionalMessage": {
"body": {
"content": "Hello World"
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Teams.Item.Channels.Item.Messages.ForwardToChat;
using Microsoft.Graph.Beta.Models;
var requestBody = new ForwardToChatPostRequestBody
{
TargetChatIds = new List<string>
{
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
},
MessageIds = new List<string>
{
"1728088338580",
},
AdditionalMessage = new ChatMessage
{
Body = new ItemBody
{
Content = "Hello World",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Channels["{channel-id}"].Messages.ForwardToChat.PostAsForwardToChatPostResponseAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphteams "github.com/microsoftgraph/msgraph-beta-sdk-go/teams"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphteams.NewForwardToChatPostRequestBody()
targetChatIds := []string {
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
}
requestBody.SetTargetChatIds(targetChatIds)
messageIds := []string {
"1728088338580",
}
requestBody.SetMessageIds(messageIds)
additionalMessage := graphmodels.NewChatMessage()
body := graphmodels.NewItemBody()
content := "Hello World"
body.SetContent(&content)
additionalMessage.SetBody(body)
requestBody.SetAdditionalMessage(additionalMessage)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
forwardToChat, err := graphClient.Teams().ByTeamId("team-id").Channels().ByChannelId("channel-id").Messages().ForwardToChat().PostAsForwardToChatPostResponse(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.teams.item.channels.item.messages.forwardtochat.ForwardToChatPostRequestBody forwardToChatPostRequestBody = new com.microsoft.graph.beta.teams.item.channels.item.messages.forwardtochat.ForwardToChatPostRequestBody();
LinkedList<String> targetChatIds = new LinkedList<String>();
targetChatIds.add("19:e2ed97baac8e4bffbb91299a38996790@thread.v2");
forwardToChatPostRequestBody.setTargetChatIds(targetChatIds);
LinkedList<String> messageIds = new LinkedList<String>();
messageIds.add("1728088338580");
forwardToChatPostRequestBody.setMessageIds(messageIds);
ChatMessage additionalMessage = new ChatMessage();
ItemBody body = new ItemBody();
body.setContent("Hello World");
additionalMessage.setBody(body);
forwardToChatPostRequestBody.setAdditionalMessage(additionalMessage);
var result = graphClient.teams().byTeamId("{team-id}").channels().byChannelId("{channel-id}").messages().forwardToChat().post(forwardToChatPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const actionResultPart = {
targetChatIds: [
'19:e2ed97baac8e4bffbb91299a38996790@thread.v2'
],
messageIds: [
'1728088338580'
],
additionalMessage: {
body: {
content: 'Hello World'
}
}
};
await client.api('/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:b6343216390d46cba965fe36bd877674@thread.tacv2/messages/forwardToChat')
.version('beta')
.post(actionResultPart);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Teams\Item\Channels\Item\Messages\ForwardToChat\ForwardToChatPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\ChatMessage;
use Microsoft\Graph\Beta\Generated\Models\ItemBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForwardToChatPostRequestBody();
$requestBody->setTargetChatIds(['19:e2ed97baac8e4bffbb91299a38996790@thread.v2', ]);
$requestBody->setMessageIds(['1728088338580', ]);
$additionalMessage = new ChatMessage();
$additionalMessageBody = new ItemBody();
$additionalMessageBody->setContent('Hello World');
$additionalMessage->setBody($additionalMessageBody);
$requestBody->setAdditionalMessage($additionalMessage);
$result = $graphServiceClient->teams()->byTeamId('team-id')->channels()->byChannelId('channel-id')->messages()->forwardToChat()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Teams
$params = @{
targetChatIds = @(
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
)
messageIds = @(
"1728088338580"
)
additionalMessage = @{
body = @{
content = "Hello World"
}
}
}
Invoke-MgBetaForwardTeamChannelMessageToChat -TeamId $teamId -ChannelId $channelId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.teams.item.channels.item.messages.forward_to_chat.forward_to_chat_post_request_body import ForwardToChatPostRequestBody
from msgraph_beta.generated.models.chat_message import ChatMessage
from msgraph_beta.generated.models.item_body import ItemBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ForwardToChatPostRequestBody(
target_chat_ids = [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
],
message_ids = [
"1728088338580",
],
additional_message = ChatMessage(
body = ItemBody(
content = "Hello World",
),
),
)
result = await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').messages.forward_to_chat.post(request_body)
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.forwardToChatResult)",
"value": [
{
"@odata.type": "#microsoft.graph.forwardToChatResult",
"targetChatId": "19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
"forwardedMessageId": "1730918320559",
"error": null
}
]
}
Пример 3. Пересылка ответного сообщения из канала в чат
В следующем примере показано, как пересылать ответное сообщение из канала в чат.
Запрос
Ниже показан пример запроса.
POST https://graph.microsoft.com/beta/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:b6343216390d46cba965fe36bd877674@thread.tacv2/messages/1727810802267/replies/forwardToChat
Content-Type: application/json
{
"targetChatIds": [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
],
"messageIds": [
"1728088338580"
],
"additionalMessage": {
"body": {
"content": "Hello World"
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Teams.Item.Channels.Item.Messages.Item.Replies.ForwardToChat;
using Microsoft.Graph.Beta.Models;
var requestBody = new ForwardToChatPostRequestBody
{
TargetChatIds = new List<string>
{
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
},
MessageIds = new List<string>
{
"1728088338580",
},
AdditionalMessage = new ChatMessage
{
Body = new ItemBody
{
Content = "Hello World",
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Channels["{channel-id}"].Messages["{chatMessage-id}"].Replies.ForwardToChat.PostAsForwardToChatPostResponseAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphteams "github.com/microsoftgraph/msgraph-beta-sdk-go/teams"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphteams.NewForwardToChatPostRequestBody()
targetChatIds := []string {
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
}
requestBody.SetTargetChatIds(targetChatIds)
messageIds := []string {
"1728088338580",
}
requestBody.SetMessageIds(messageIds)
additionalMessage := graphmodels.NewChatMessage()
body := graphmodels.NewItemBody()
content := "Hello World"
body.SetContent(&content)
additionalMessage.SetBody(body)
requestBody.SetAdditionalMessage(additionalMessage)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
forwardToChat, err := graphClient.Teams().ByTeamId("team-id").Channels().ByChannelId("channel-id").Messages().ByChatMessageId("chatMessage-id").Replies().ForwardToChat().PostAsForwardToChatPostResponse(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.teams.item.channels.item.messages.item.replies.forwardtochat.ForwardToChatPostRequestBody forwardToChatPostRequestBody = new com.microsoft.graph.beta.teams.item.channels.item.messages.item.replies.forwardtochat.ForwardToChatPostRequestBody();
LinkedList<String> targetChatIds = new LinkedList<String>();
targetChatIds.add("19:e2ed97baac8e4bffbb91299a38996790@thread.v2");
forwardToChatPostRequestBody.setTargetChatIds(targetChatIds);
LinkedList<String> messageIds = new LinkedList<String>();
messageIds.add("1728088338580");
forwardToChatPostRequestBody.setMessageIds(messageIds);
ChatMessage additionalMessage = new ChatMessage();
ItemBody body = new ItemBody();
body.setContent("Hello World");
additionalMessage.setBody(body);
forwardToChatPostRequestBody.setAdditionalMessage(additionalMessage);
var result = graphClient.teams().byTeamId("{team-id}").channels().byChannelId("{channel-id}").messages().byChatMessageId("{chatMessage-id}").replies().forwardToChat().post(forwardToChatPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const actionResultPart = {
targetChatIds: [
'19:e2ed97baac8e4bffbb91299a38996790@thread.v2'
],
messageIds: [
'1728088338580'
],
additionalMessage: {
body: {
content: 'Hello World'
}
}
};
await client.api('/teams/1e769eab-06a8-4b2e-ac42-1f040a4e52a1/channels/19:b6343216390d46cba965fe36bd877674@thread.tacv2/messages/1727810802267/replies/forwardToChat')
.version('beta')
.post(actionResultPart);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Teams\Item\Channels\Item\Messages\Item\Replies\ForwardToChat\ForwardToChatPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\ChatMessage;
use Microsoft\Graph\Beta\Generated\Models\ItemBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForwardToChatPostRequestBody();
$requestBody->setTargetChatIds(['19:e2ed97baac8e4bffbb91299a38996790@thread.v2', ]);
$requestBody->setMessageIds(['1728088338580', ]);
$additionalMessage = new ChatMessage();
$additionalMessageBody = new ItemBody();
$additionalMessageBody->setContent('Hello World');
$additionalMessage->setBody($additionalMessageBody);
$requestBody->setAdditionalMessage($additionalMessage);
$result = $graphServiceClient->teams()->byTeamId('team-id')->channels()->byChannelId('channel-id')->messages()->byChatMessageId('chatMessage-id')->replies()->forwardToChat()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Teams
$params = @{
targetChatIds = @(
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2"
)
messageIds = @(
"1728088338580"
)
additionalMessage = @{
body = @{
content = "Hello World"
}
}
}
Invoke-MgBetaForwardTeamChannelMessageReplyToChat -TeamId $teamId -ChannelId $channelId -ChatMessageId $chatMessageId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.teams.item.channels.item.messages.item.replies.forward_to_chat.forward_to_chat_post_request_body import ForwardToChatPostRequestBody
from msgraph_beta.generated.models.chat_message import ChatMessage
from msgraph_beta.generated.models.item_body import ItemBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ForwardToChatPostRequestBody(
target_chat_ids = [
"19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
],
message_ids = [
"1728088338580",
],
additional_message = ChatMessage(
body = ItemBody(
content = "Hello World",
),
),
)
result = await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').messages.by_chat_message_id('chatMessage-id').replies.forward_to_chat.post(request_body)
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.forwardToChatResult)",
"value": [
{
"@odata.type": "#microsoft.graph.forwardToChatResult",
"targetChatId": "19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
"forwardedMessageId": "1730918320559",
"error": null
}
]
}