Skip to main content

​
Introduction

Text channels in Copera allow integrations to send and receive text-only messages inside workspace conversations. They are commonly used for notifications, workflow updates, bot responses, and other automated text-based interactions. This unified document describes message capabilities, formatting rules, permissions, rate limits, and Developer Mode features.

​
Message Sending

To send a message, an integration must submit a request to the chat messaging endpoint, including the channelId of the target text channel. Example:
  • Endpoint: POST https://api.copera.ai/public/v1/chat/channel/{channelId}/send-message
  • Request body includes the channel identifier

​
Message Formatting

Text channels support a subset of Markdown formatting. Integrations can use:
  • Headings (H1–H6)
  • Bold and italic
  • Ordered and unordered lists
  • Inline and multiline code blocks
  • Blockquotes
  • Horizontal rules
  • Links

​
Permissions

To send a message to a text channel, an integration must:
  1. Have the required permission scope for chat messaging.
  2. Be explicitly added as a participant of the target text channel.
Integrations can only send messages to channels where they are active participants.

​
Developer Mode

A Developer Mode will be available in Copera to help users locate resource IDs, including text channel IDs. This simplifies integration setup by enabling quick access to identifiers.

​
Rate Limits

Chat messaging is rate-limited to ensure platform stability. Limit: 100 requests per minute per integration.

​
Summary

  • Text-only messages are supported.
  • Markdown formatting and custom color tags are available.
  • Messages are sent through the chat send-message endpoint.
  • The request body must include the channel ID.
  • Integrations must be participants of a channel to send messages.
  • Rate limit: 100 requests/minute.
  • Developer Mode helps locate channel IDs.