Carbon Voice icon

Carbon Voice

Send messages, voice memos, and manage Carbon Voice resources

Actions10

Conversation → Send Direct Message

AI-generated

Summary

Send a direct message to one or more users by creating or reusing a direct conversation within a specified workspace and posting a text message optionally with link attachments.

Inputs

  • Workspace Name or ID (required) — Select the workspace where the direct conversation will be created or reused.
  • Recipient Names or IDs — Choose one or more users from your contacts to send the message to, or specify their IDs using expressions.
  • Recipient Emails — Provide a comma-separated list of emails as an alternative to selecting users from contacts, useful for invitees not yet in your contacts.
  • Message Text (required) — Enter the text content of the direct message to send.
  • Link Attachments — Optionally provide a comma-separated list of URLs to attach to the message.

Output shape

a single object representing the created direct message, including details of the message and conversation.

Requires specifying a workspace and at least one recipient by user ID(s) or email(s). The message text is mandatory. Link attachments are optional. The API request posts to '/simplified/messages/direct' endpoint. Errors are thrown if required inputs are missing.

Examples

Example 1: Send a direct message with text and optional URL attachments to multiple users in a workspace.

Select workspace; specify user IDs or recipient emails; enter message text; optionally list URLs to attach.

Links

Discussion