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 GitHubAgent 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-feedback1 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
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)
jqinstalado (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:
- Abrí Claude.ai → Settings → Integrations
- Conectá Slack, Gmail, Google Drive y Notion
- Volvé a correr
bash setup.shpara 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
| Argumento | Descripción | Ejemplo |
|---|---|---|
[días] | Analiza solo los últimos N días | /feedback-clientes 7 |
--max-clients N | Limita el análisis a N clientes | /feedback-clientes --max-clients 5 |
| Combinados | N 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):
| Fuente | Qué captura |
|---|---|
| Slack | Mensajes del canal del cliente, archivos adjuntos, canvases |
| Granola | Transcripciones de reuniones donde participó el cliente |
| Gmail | Threads de email con el cliente |
| Notion | Pá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