Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Crie um novo plannerTaskChatMessage em um plannerTask.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
Tasks.ReadWrite |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Aplicativo |
Sem suporte. |
Sem suporte. |
Solicitação HTTP
POST /planner/tasks/{task-id}/messages
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON de um objeto plannerTaskChatMessage .
A tabela a seguir lista as propriedades que você pode definir ao criar um plannerTaskChatMessage.
| Propriedade |
Tipo |
Descrição |
| content |
Cadeia de caracteres |
O conteúdo da mensagem de chat. Esta propriedade suporta texto sem formatação e HTML higienizado. Obrigatório. |
| menções |
Coleção plannerTaskChatMention |
A lista de menções na mensagem. Opcional. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto plannerTaskChatMessage no corpo da resposta.
Este método pode retornar qualquer um dos códigos de status de HTTP. Os erros mais comuns que os aplicativos devem manipular para esse método são as respostas 400, 403 e 404. Saiba mais sobre esses erros em Condições de erro comuns do Planner.
Exemplos
Exemplo 1: Criar uma mensagem
Solicitação
O exemplo a seguir mostra uma solicitação para criar uma mensagem de chat.
POST https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages
Content-type: application/json
{
"content": "This is a new chat message"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new PlannerTaskChatMessage
{
Content = "This is a new chat message",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Planner.Tasks["{plannerTask-id}"].Messages.PostAsync(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"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewPlannerTaskChatMessage()
content := "This is a new chat message"
requestBody.SetContent(&content)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
messages, err := graphClient.Planner().Tasks().ByPlannerTaskId("plannerTask-id").Messages().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
PlannerTaskChatMessage plannerTaskChatMessage = new PlannerTaskChatMessage();
plannerTaskChatMessage.setContent("This is a new chat message");
PlannerTaskChatMessage result = graphClient.planner().tasks().byPlannerTaskId("{plannerTask-id}").messages().post(plannerTaskChatMessage);
const options = {
authProvider,
};
const client = Client.init(options);
const plannerTaskChatMessage = {
content: 'This is a new chat message'
};
await client.api('/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages')
.version('beta')
.post(plannerTaskChatMessage);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMessage;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new PlannerTaskChatMessage();
$requestBody->setContent('This is a new chat message');
$result = $graphServiceClient->planner()->tasks()->byPlannerTaskId('plannerTask-id')->messages()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Planner
$params = @{
content = "This is a new chat message"
}
New-MgBetaPlannerTaskMessage -PlannerTaskId $plannerTaskId -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.models.planner_task_chat_message import PlannerTaskChatMessage
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PlannerTaskChatMessage(
content = "This is a new chat message",
)
result = await graph_client.planner.tasks.by_planner_task_id('plannerTask-id').messages.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#planner/tasks('01gzSlKkIUSUl6DF_EilrmQAKDhh')/messages/$entity",
"id": "5bde7bc8-d998-4e8a-8159-93d4d7ccc3b5",
"messageType": "richTextHtml",
"content": "This is a new chat message",
"createdDateTime": "2025-12-05T17:49:39.593Z",
"parentEntityId": "01gzSlKkIUSUl6DF_EilrmQAKDhh",
"deletedTime": null,
"editedTime": null,
"mentions": [],
"reactions": [],
"createdBy": {
"user": {
"id": "6463a5ce-2119-4198-9f2a-628761df4a62"
}
}
}
Exemplo 2: criar uma mensagem com menções
Solicitação
O exemplo a seguir mostra uma solicitação para criar uma mensagem de chat com uma menção do usuário.
POST https://graph.microsoft.com/beta/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages
Content-type: application/json
{
"content": "<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>",
"mentions": [
{
"mentioned": "6463a5ce-2119-4198-9f2a-628761df4a62",
"position": 0,
"mentionType": "user"
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new PlannerTaskChatMessage
{
Content = "<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>",
Mentions = new List<PlannerTaskChatMention>
{
new PlannerTaskChatMention
{
Mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62",
Position = 0,
MentionType = PlannerTaskChatMentionType.User,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Planner.Tasks["{plannerTask-id}"].Messages.PostAsync(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"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewPlannerTaskChatMessage()
content := "<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>"
requestBody.SetContent(&content)
plannerTaskChatMention := graphmodels.NewPlannerTaskChatMention()
mentioned := "6463a5ce-2119-4198-9f2a-628761df4a62"
plannerTaskChatMention.SetMentioned(&mentioned)
position := int32(0)
plannerTaskChatMention.SetPosition(&position)
mentionType := graphmodels.USER_PLANNERTASKCHATMENTIONTYPE
plannerTaskChatMention.SetMentionType(&mentionType)
mentions := []graphmodels.PlannerTaskChatMentionable {
plannerTaskChatMention,
}
requestBody.SetMentions(mentions)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
messages, err := graphClient.Planner().Tasks().ByPlannerTaskId("plannerTask-id").Messages().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
PlannerTaskChatMessage plannerTaskChatMessage = new PlannerTaskChatMessage();
plannerTaskChatMessage.setContent("<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>");
LinkedList<PlannerTaskChatMention> mentions = new LinkedList<PlannerTaskChatMention>();
PlannerTaskChatMention plannerTaskChatMention = new PlannerTaskChatMention();
plannerTaskChatMention.setMentioned("6463a5ce-2119-4198-9f2a-628761df4a62");
plannerTaskChatMention.setPosition(0);
plannerTaskChatMention.setMentionType(PlannerTaskChatMentionType.User);
mentions.add(plannerTaskChatMention);
plannerTaskChatMessage.setMentions(mentions);
PlannerTaskChatMessage result = graphClient.planner().tasks().byPlannerTaskId("{plannerTask-id}").messages().post(plannerTaskChatMessage);
const options = {
authProvider,
};
const client = Client.init(options);
const plannerTaskChatMessage = {
content: '<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>',
mentions: [
{
mentioned: '6463a5ce-2119-4198-9f2a-628761df4a62',
position: 0,
mentionType: 'user'
}
]
};
await client.api('/planner/tasks/01gzSlKkIUSUl6DF_EilrmQAKDhh/messages')
.version('beta')
.post(plannerTaskChatMessage);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMessage;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMention;
use Microsoft\Graph\Beta\Generated\Models\PlannerTaskChatMentionType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new PlannerTaskChatMessage();
$requestBody->setContent('<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>');
$mentionsPlannerTaskChatMention1 = new PlannerTaskChatMention();
$mentionsPlannerTaskChatMention1->setMentioned('6463a5ce-2119-4198-9f2a-628761df4a62');
$mentionsPlannerTaskChatMention1->setPosition(0);
$mentionsPlannerTaskChatMention1->setMentionType(new PlannerTaskChatMentionType('user'));
$mentionsArray []= $mentionsPlannerTaskChatMention1;
$requestBody->setMentions($mentionsArray);
$result = $graphServiceClient->planner()->tasks()->byPlannerTaskId('plannerTask-id')->messages()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Planner
$params = @{
content = "<div><span itemid="0" itemtype="https://schema.skype.com/Mention/Person"></span> Please review this task</div>"
mentions = @(
@{
mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62"
position = 0
mentionType = "user"
}
)
}
New-MgBetaPlannerTaskMessage -PlannerTaskId $plannerTaskId -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.models.planner_task_chat_message import PlannerTaskChatMessage
from msgraph_beta.generated.models.planner_task_chat_mention import PlannerTaskChatMention
from msgraph_beta.generated.models.planner_task_chat_mention_type import PlannerTaskChatMentionType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = PlannerTaskChatMessage(
content = "<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>",
mentions = [
PlannerTaskChatMention(
mentioned = "6463a5ce-2119-4198-9f2a-628761df4a62",
position = 0,
mention_type = PlannerTaskChatMentionType.User,
),
],
)
result = await graph_client.planner.tasks.by_planner_task_id('plannerTask-id').messages.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#planner/tasks('01gzSlKkIUSUl6DF_EilrmQAKDhh')/messages/$entity",
"id": "7cde8bc9-e109-5f9b-9260-04e5e8ddc4c6",
"messageType": "richTextHtml",
"content": "<div><span itemid=\"0\" itemtype=\"https://schema.skype.com/Mention/Person\"></span> Please review this task</div>",
"createdDateTime": "2025-12-05T17:49:39.593Z",
"parentEntityId": "01gzSlKkIUSUl6DF_EilrmQAKDhh",
"deletedTime": null,
"editedTime": null,
"mentions": [
{
"mentioned": "6463a5ce-2119-4198-9f2a-628761df4a62",
"position": 0,
"mentionType": "user"
}
],
"reactions": [],
"createdBy": {
"user": {
"id": "6463a5ce-2119-4198-9f2a-628761df4a62"
}
}
}