convez.ai
AgenteAutomaçãoIntermediário
ezemartinfidi

Agente de Coleta de Feedback de Clientes

ezemartinfidi/agent-customer-feedback

Centraliza feedback de clientes de 4 fontes em um resumo inteligente no Slack

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent que coleta automaticamente feedback de clientes a partir de múltiplas fontes (Slack Connect, Granola, Gmail, Notion), analisa e envia um resumo organizado via DM no Slack. Classifica os dados em bugs, feature requests e perguntas frequentes por cliente.

Instalação

$npx convez-ai ezemartinfidi/agent-customer-feedback

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Centralizar feedback de clientes de múltiplos canais em um único lugar
  • Priorizar bugs e features baseado em padrões recorrentes entre clientes
  • Monitorar perguntas frequentes para melhorias na documentação

Veredito

Agent bem estruturado que resolve um problema real de times que atendem múltiplos clientes. Setup é claro e integrações com ferramentas populares funcionam bem, embora exija múltiplas dependências externas (Granola, Slack, Gmail, Notion configurados).

README

A tradução para o português deste README ainda está na fila.

agent-customer-feedback

Un agente de Claude Code que recopila feedback de todos tus clientes desde cuatro fuentes (Slack Connect, Granola, Gmail, Notion), lo analiza y te envía un DM en Slack con bugs, feature requests y preguntas frecuentes clasificados por cliente.

¿Qué hace?

Ejecutás un comando en Claude Code y recibís automáticamente en tu Slack:

🔍 Feedback Clientes — últimos 7 días
_3 clientes · 4 fuentes · 12 señales totales_

━━━━━━━━━━━━━━━
*Cliente A*
🐛 Bugs
• Corregir error 500 en endpoint /payments al enviar monto con decimales

✨ Feature requests
• Implementar webhook de confirmación de pago con retry automático (Slack + reunión)

━━━━━━━━━━━━━━━
*Cliente B*
❓ Preguntas frecuentes
• Documentar en la API el comportamiento del campo `reference_id` cuando es nulo

Los clientes se descubren automáticamente desde los canales Slack Connect de tu workspace.

Prerequisitos

  • Claude Code instalado
  • Granola instalado (para transcripciones de reuniones)
  • jq instalado (brew install jq)
  • Cuenta Claude.ai con las siguientes integraciones activas:
    • Slack
    • Gmail
    • Google Drive
    • Notion

Instalación

git clone https://github.com/ezemartinfidi/agent-customer-feedback.git
cd agent-customer-feedback
bash setup.sh

El script te va a pedir:

  • Company name: el nombre de tu empresa tal como aparece en los canales Slack Connect (ej. acme, fidi)
  • Tu email de Slack: para identificarte como destinatario del DM
  • Tu Slack user ID: se encuentra en Slack → tu foto de perfil → Ver perfil → Más (•••) → Copiar ID de miembro

Para activar las integraciones de Claude.ai que no estén configuradas:

  1. Abrí Claude.ai → Settings → Integrations
  2. Conectá Slack, Gmail, Google Drive y Notion
  3. Volvé a correr bash setup.sh para verificar

Uso

En ambos casos necesitás clonar el repo y abrirlo en Claude Code para que el comando /feedback-clientes esté disponible. La diferencia está en si corrés setup.sh o no.

Opción A — Con setup.sh (recomendado)

git clone https://github.com/ezemartinfidi/agent-customer-feedback.git
cd agent-customer-feedback
bash setup.sh

Abrí Claude Code en ese directorio y ejecutá:

/feedback-clientes

La configuración se lee automáticamente. setup.sh también agrega el MCP de Granola.

Opción B — Sin setup.sh

Cloná el repo, abrilo en Claude Code (desktop, CLI o web en claude.ai/code) y ejecutá /feedback-clientes directamente. El agente te va a pedir los datos de configuración en el chat:

  • Company name (ej. acme)
  • Slack user ID (empieza con U, lo encontrás en tu perfil → Más → Copiar ID de miembro)
  • Slack email

En este modo Granola no está configurado como MCP, así que las reuniones no se incluyen. Para activar Granola corré bash setup.sh.

Argumentos opcionales

ArgumentoDescripciónEjemplo
[días]Analiza solo los últimos N días/feedback-clientes 7
--max-clients NLimita el análisis a N clientes/feedback-clientes --max-clients 5
CombinadosN días + límite de clientes/feedback-clientes 7 --max-clients 3

Sin argumentos analiza todo el historial disponible.

Primera vez (Opción A): verificar conexiones

Después de bash setup.sh, abrí Claude Code y ejecutá:

/fidi-setup

setup.sh configura los archivos en tu sistema. /fidi-setup verifica que cada integración responde correctamente desde Claude Code — es el paso de validación antes de tu primer análisis.

Fuentes de datos

Por cada cliente (canal Slack Connect detectado automáticamente):

FuenteQué captura
SlackMensajes del canal del cliente, archivos adjuntos, canvases
GranolaTranscripciones de reuniones donde participó el cliente
GmailThreads de email con el cliente
NotionPáginas de notas, requerimientos, feedback explícito

Estructura del proyecto

.
├── setup.sh                          # Instalador (configura MCPs + identidad)
├── tests/
│   └── setup.bats                    # Tests del instalador
└── .claude/
    └── skills/
        ├── feedback-clientes/
        │   └── SKILL.md              # Skill principal del agente
        └── fidi-setup/
            └── SKILL.md              # Wizard de configuración

Tests

brew install bats-core
bats tests/setup.bats

Configuración

El agente guarda tu identidad en ~/.fidi-feedback/config.json:

{
  "slack_email": "tu@empresa.com",
  "slack_user_id": "U0XXXXXXX",
  "company_name": "acme"
}

Podés editarlo directamente o volver a correr bash setup.sh.

Licencia

MIT

Ver o original no GitHub

Bom para

Relacionados