---

name: ba-integracoes description: Conecta um cliente Bora Automatizar (via Eter) a ferramentas que ele já usa — Sheets, ClickUp, Notion, Trello, Stripe, Shopify, Calendly, RD Station, Pipedrive, webhook genérico — e orquestra fluxos entre elas. Use quando o briefing do cliente apontar um CRM/ERP/planilha existente para conectar, quando pedir "manda um alerta no Slack/Discord/Telegram quando X acontecer", "cria task automática", "consolida pedido/pagamento em um lugar só", ou "isso precisa rodar 24/7 num servidor". Não cobre WhatsApp — isso é o sistema próprio do Bora Automatizar. allowed-tools: Read Write Bash user-invocable: true

/ba-integracoes — Conectar sistemas existentes do cliente

Você está agora em modo integração. O cliente do Eter já tem alguma ferramenta rodando (CRM, planilha, e-commerce, agenda) e o trabalho é conectar essa ferramenta ao fluxo automatizado — não substituí-la.

WhatsApp fica fora deste pacote. O Bora Automatizar já tem sistema próprio para isso — não reconstrua aqui. Alertas internos (time, sócios) usam notificacoes/ (Slack/Discord/Telegram).

Como decidir o que usar

| Cenário do briefing | Use | |---|---| | "Registra lead em algum lugar" e não tem CRM | google-sheets/ | | "Já uso RD Station" (CRM mais comum em PME BR) | rd-station/ | | "Já uso Pipedrive" | pipedrive/ | | "Organizar tasks do time" | clickup/ (completo) ou trello/ (simples) | | "Wiki / base de conhecimento" | notion/ | | "Cobrança / assinatura mensal" | stripe/ | | "Loja online" | shopify/ | | "Agendamento de reunião pública" | calendly/ | | "Ferramenta que não está na lista" | webhook-generico/ | | "Notificar time/sócios de evento" (não é o cliente final) | notificacoes/ (Slack/Discord/Telegram) | | "Precisa combinar 2+ integrações num pipeline" | orquestrador/ — YAML com etapas, retry, condição | | "Isso precisa rodar sozinho, sempre" | deploy/ — Docker Compose + Coolify |

Como trabalhar

1. Leia o briefing do cliente — qual ferramenta ele já usa hoje (se usa).
2. Abra o README.md da subpasta correspondente — cada integração MCP (Sheets/ClickUp/Notion/Trello) tem mcp-config.json pronto pra colar; cada integração via API (Stripe/Shopify/Calendly/RD/Pipedrive) tem cliente Python + exemplos.md/funcoes-prontas.md.
3. Se o fluxo cruza 2+ integrações (ex: Shopify → Slack → alerta se pedido grande), monte ou adapte um YAML em orquestrador/fluxos/ — tem 4 prontos pra usar de referência.
4. Antes de considerar pronto, rode python orquestrador/smoke_test.py com as credenciais do cliente configuradas — valida que cada integração habilitada responde.
5. Se o cliente quer isso rodando 24/7 (não só sob demanda no Claude Code), suba com deploy/ — INSTALACAO-COOLIFY.md tem o passo a passo guiado.

Segurança

• Tokens só em ~/.credentials/ (fora do git). Nunca hardcoded.
• Webhook sempre com secret HMAC validado — sem assinatura válida, 401.
• HTTPS em qualquer endpoint público.
• Escopo mínimo por integração (ex: Stripe Restricted Key, não Secret Key).