Skip to main content

Send a Chat Message

Find a chat, then send:

CHAT_ID=$(teams chat list --output json | jq -r '.data[0].id')
teams message send --chat "$CHAT_ID" --body "Status update complete." --output json

Send a pasted-style screenshot without text:

teams message send --chat "$CHAT_ID" --image ./screenshot.png --output json

Attach a file to a chat. Chat attachments upload to the sender's OneDrive Microsoft Teams Chat Files folder and require Files.ReadWrite.

teams message send --chat "$CHAT_ID" --body "Report attached" --attach ./report.pdf --output json

Inline images are capped at 3 MB each and 4 MB combined after base64 encoding. File attachments use Microsoft Graph's 250 MB simple-upload limit. See Message Attachments for storage, scope, and download details.

If a chat is visible but message read or send fails, check membership and meeting roster constraints.