Channels

I Channels sono le conversazioni del workspace di Copera. La Channels API consente alle integrazioni di elencare i channel e inviare messaggi — sia a un channel sia direttamente a un membro — il che la rende ideale per notifiche, risposte di bot, aggiornamenti di workflow e alert.

Quick Start

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

Documentazione completa dell'SDK e codice sorgente

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

Configurazione CLI e riferimento completo ai comandi

GitHub Action

Invia notifiche Copera direttamente dalle pipeline 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	Required	Description
api_token	Yes	Your Copera API token (store it in GitHub Secrets)
channel_id	Yes	Target channel ID
message	Yes	Message content (1–10,000 characters)
sender_name	No	Custom sender display name
debug	No	Enable detailed logging (true / false)

Copera Action

Listing sul GitHub Marketplace e documentazione completa

Disponibile in

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

La CLI e l'MCP server hostato coprono l'elenco dei channel e l'invio di messaggi di channel e diretti. I Channels non sono esposti all'assistente Copera AI in-app.

Successivi

• Messaggistica text channel — elencare channel e filtri, pubblicare su un channel vs inviare un messaggio diretto, il formato markdown supportato, i permessi participant e la semantica delle response.
• Channels nell'API Reference — list channels, send channel message e send direct message con schemi completi.