Channels

Los Channels son las conversaciones del workspace de Copera. La API de Channels permite a las integraciones listar canales y enviar mensajes — tanto a un canal como directamente a un miembro — lo que la hace ideal para notificaciones, respuestas de bots, actualizaciones de flujos de trabajo y alertas.

Inicio 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

Documentación completa del SDK y código fuente

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

Configuración del CLI y referencia completa de comandos

GitHub Action

Envía notificaciones de Copera directamente desde tus 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"

Entrada	Obligatorio	Descripción
api_token	Sí	Tu token de API de Copera (guárdalo en GitHub Secrets)
channel_id	Sí	ID del canal de destino
message	Sí	Contenido del mensaje (1–10,000 caracteres)
sender_name	No	Nombre del remitente personalizado
debug	No	Habilita el registro detallado (true / false)

Copera Action

Ficha en GitHub Marketplace y documentación completa

Disponible en

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

El CLI y el servidor MCP alojado cubren el listado de canales y el envío de mensajes a canales y mensajes directos. Channels no está expuesto al asistente Copera AI integrado en la app.

Siguiente

• Mensajería en canales de texto — el listado de canales y sus filtros, publicar en un canal vs enviar un mensaje directo, el formato markdown soportado, los permisos de los participantes y la semántica de las respuestas.
• Channels en la referencia de la API — list channels, send channel message y send direct message con sus esquemas completos.