Channels

Channels são as conversas do workspace no Copera. A API de Channels permite que integrações listem channels e enviem mensagens — tanto para um channel quanto diretamente para um membro — o que a torna ideal para notificações, respostas de bot, atualizações de workflow e alertas.

Início Rápido

REST API

# List channels
curl -X GET "https://api.copera.ai/public/v1/chat/channel/list?q=deploy" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Send a message to a channel
curl -X POST https://api.copera.ai/public/v1/chat/channel/CHANNEL_ID/send-message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Deploy to production finished ✅" }'

# Send a direct message to a member
curl -X POST https://api.copera.ai/public/v1/chat/direct-message/send-message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "userId": "USER_ID", "message": "Your report is ready." }'

Node.js SDK

npm install @copera.ai/sdk

import { CoperaAI } from '@copera.ai/sdk';

const copera = CoperaAI({ apiKey: 'YOUR_API_KEY' });

// Send a message to a channel
await copera.channel.sendMessage({
  channelId: 'CHANNEL_ID',
  message: 'Task completed successfully!',
  name: 'Automation Bot', // optional sender display name
});

@copera.ai/sdk

Documentação completa do SDK e código-fonte

CLI

curl -fsSL https://cli.copera.ai/install.sh | bash

# List channels
copera channels list
copera channels list --query "deploy"

# Send to a channel
copera channels message send "Hello from the CLI!" --channel <channel-id>

# Send a direct message to a member
copera channels message send "Your report is ready." --user <user-id>

copera-cli

Configuração da CLI e referência completa de comandos

GitHub Action

Envie notificações do Copera diretamente dos seus pipelines de CI/CD:

name: Deploy Notification

on:
  push:
    branches: [main]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - name: Send Copera Notification
        uses: copera-ai/copera-action@v3
        with:
          api_token: ${{ secrets.COPERA_GITHUB }}
          channel_id: ${{ vars.COPERA_GITHUB_CHANNEL }}
          message: "New deployment to production!"
          sender_name: "GitHub Actions"

Input	Obrigatório	Descrição
api_token	Sim	Seu token de API do Copera (guarde-o no GitHub Secrets)
channel_id	Sim	ID do channel de destino
message	Sim	Conteúdo da mensagem (1–10.000 caracteres)
sender_name	Não	Nome de exibição personalizado do remetente
debug	Não	Habilita logging detalhado (true / false)

Copera Action

Listagem no GitHub Marketplace e documentação completa

Disponível em

Public API	CLI	MCP	Copera AI
✅ Completo	✅ Completo	✅ Completo	—

A CLI e o servidor MCP hospedado cobrem a listagem de channels e o envio de mensagens em channels e diretas. Channels não são expostos ao assistente Copera AI dentro do app.

Próximo

• Mensagens em Text Channel — listagem de channels e filtros, postar em um channel vs enviar uma mensagem direta, o formato markdown suportado, permissões de participante e a semântica das responses.
• Channels na Referência da API — list channels, send channel message e send direct message com schemas completos.