Extiende Canalivo con API y MCP

1. 1Abre ConfiguraciónVe a la sección de API y MCP dentro de tu organización.
2. 2Crea o autorizaGenera una clave para integraciones directas o completa OAuth desde un cliente MCP compatible.
3. 3Selecciona permisosConcede únicamente los scopes y el rol necesarios para el caso de uso.
4. 4Guarda el secretoLa clave completa se muestra una sola vez; almacénala en un gestor seguro.

Puedes comunicarte con la API de Canalivo para enviar mensajes, consultar el estado de la conversación o consultar la lista de agentes disponibles.

curl -X POST "https://api.canalivo.com/api/conversations/send" \
  -H "Authorization: Bearer <tu_clave_api>" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "web_chat",
    "recipient": "user_123",
    "message": "Hola, necesito información sobre mi suscripción."
  }'

async function fetchAgents(apiKey: string) {
  const response = await fetch("https://api.canalivo.com/api/agents", {
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
  });
  if (!response.ok) throw new Error(`API Error: ${response.statusText}`);
  return await response.json();
}

Canalivo muestra el endpoint exacto y una configuración base en Configuración. Usa esos valores para evitar copiar una URL de otro entorno u organización.

{
  "mcpServers": {
    "canalivo": {
      "type": "http",
      "url": "<endpoint mostrado en Canalivo>",
      "headers": {
        "Authorization": "Bearer <tu clave o token>"
      }
    }
  }
}

• Confirma que el cliente descubre solo las capacidades esperadas.
• Ejecuta primero una operación de lectura.
• Revisa el registro de invocaciones y errores en Configuración.
• Revoca grants o claves que ya no estén en uso.

Cuando Canalivo notifica eventos mediante webhooks, cada solicitud incluye un encabezado con la firma HMAC-SHA256 para garantizar el origen legítimo.

• Obtén el secreto del webhook desde el panel de Configuración de Canalivo.
• Calcula la firma HMAC-SHA256 del cuerpo raw del mensaje.
• Compara en tiempo constante la firma calculada con el encabezado de la solicitud.
• Rechaza eventos con marcas de tiempo desfasadas para prevenir ataques de repetición.