Skip to main content

viva engage message add

Posts a Viva Engage network message on behalf of the current user

Usage​

m365 viva engage message add [options]

Options​

-b, --body <body>

The text of the message body

--groupId [groupId]

Post the message to this group, specified by ID. If this is set then the networkId is inferred from it. You must either specify groupId, repliedToId, or directToUserIds to send the message

-r, --repliedToId [repliedToId]

The message ID this message is in reply to. If this is set then groupId and networkId are inferred from it. You must either specify groupId, repliedToId, or directToUserIds to send the message

-d, --directToUserIds [directToUserIds]

Send a private message to one or more users, specified by ID. Alternatively, you can use the Viva Engage network e-mail addresses instead of the IDs. You must either specify groupId, repliedToId, or directToUserIds to send the message

--networkId [networkId]

Specify the network to post a message

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

warning

In order to use this command, you need to grant the Microsoft Entra application used by the CLI for Microsoft 365 the permission to the Viva Engage API. To do this, execute the cli consent --service VivaEngage command.

Examples​

Replies to a message with the ID 1231231231

m365 viva engage message add --body "Hello everyone!" --repliedToId 1231231231

Sends a private conversation to the user with the ID 1231231231

m365 viva engage message add --body "Hello everyone!" --directToUserIds 1231231231

Sends a private conversation to multiple users by ID

m365 viva engage message add --body "Hello everyone!" --directToUserIds "1231231231,1121312"

Sends a private conversation to the user with several e-mail addresses

m365 viva engage message add --body "Hello everyone!" --directToUserIds "pl@nubo.eu,sc@nubo.eu"

Posts a message to the group with the ID 12312312312

m365 viva engage message add --body "Hello everyone!" --groupId 12312312312

Posts a message to the group with the ID 12312312312 in the network 11112312

m365 viva engage message add --body "Hello everyone!" --groupId 12312312312 --networkId 11112312

Response​

{
  "id": 2000337346863105,
  "sender_id": 36425097217,
  "delegate_id": null,
  "replied_to_id": null,
  "created_at": "2022/11/11 20:59:56 +0000",
  "network_id": 5897756673,
  "message_type": "update",
  "sender_type": "user",
  "url": "https://www.yammer.com/api/v1/messages/2000337346863105",
  "web_url": "https://www.yammer.com/contoso.onmicrosoft.com/messages/2000337346863105",
  "group_id": 31158067201,
  "body": {
    "parsed": "Hello everyone!",
    "plain": "Hello everyone!",
    "rich": "Hello everyone!"
  },
  "thread_id": 2000337346863105,
  "client_type": "O365 Api Auth",
  "client_url": "https://api.yammer.com",
  "system_message": false,
  "direct_message": false,
  "chat_client_sequence": null,
  "language": null,
  "notified_user_ids": [],
  "privacy": "public",
  "attachments": [],
  "liked_by": {
    "count": 0,
    "names": []
  },
  "supplemental_reply": false,
  "content_excerpt": "Hello everyone!",
  "group_created_id": 31158067201
}
CTRL + M