Channel Talk icon

Channel Talk

Send messages to Channel Talk

Team Chat → Create Message (Blocks, by Name)

AI-generated

Summary

Send a blocks message to a team chat group identified by its name (without @ prefix).

Inputs

  • Group Name (required) — The name of the group (without @ prefix) to send the message to.
  • Bot Name — Name of the bot sending the message, sent as a query parameter.
  • Blocks (JSON) (required) — A JSON array representing the message blocks to include in the message body.
  • Buttons (JSON) — Optional JSON array of message buttons to include.
  • Files (JSON) — Optional JSON array of message files to attach.
  • Options — Optional message options to apply such as 'doNotPost', 'doNotSearch', 'immutable', 'silent'.
  • Request ID — Optional idempotency key for the message request to prevent duplicate messages.

Output shape

a single record representing the created message response from the Channel Talk API

The operation sends a POST request to the URL '/open/v5/groups/@{groupName}/messages' with required and optional properties in the request body and query. Includes support for batching and HTTP client options via node-level settings. If supplied, the 'Bot Name' is sent as a query parameter; message blocks JSON is required; buttons and files JSON are optional and sent in the body if provided. Options are filtered to exclude empty strings and sent as an array if present. The response contains details of the created message.

Examples

Example 1: Send a blocks message

Specify the target team chat group name, provide the blocks JSON describing the message structure, optionally define buttons, files, message options, a bot name, and a request id for idempotency.

Links

Discussion