sr-cardoso-whatsapp

Integracao WhatsApp via Evolution API no Sr Cardoso. Use quando configurar EVOLUTION_*, conectar instancias, ajustar notificacoes, cron jobs, filas de retry e mensagens automaticas.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/sr-cardoso-whatsapp-yurikrat-sr-cardoso-barbearia-72deef55

SKILL.md

Sr Cardoso WhatsApp

Overview

Operar e evoluir o fluxo de mensagens automaticas via Evolution API e painel admin.

Arquivos-chave

apps/server/src/services/whatsappNotifications.ts (logica de envios).
apps/server/src/lib/evolutionApi.ts (cliente HTTP para Evolution).
apps/server/src/routes/admin.ts (endpoints admin WhatsApp).
apps/server/src/routes/public.ts (cron endpoints).
packages/shared/src/schemas/whatsapp.schema.ts (schemas de payload).
apps/web/src/pages/admin/WhatsappPage.tsx (UI).

Env vars e infra

Usar EVOLUTION_BASE_URL, EVOLUTION_API_KEY, EVOLUTION_INSTANCE_NAME.
Usar CRON_SECRET para /api/cron/*.
Consultar documento.md e docs/WHATSAPP_INFRA_PLAN.md para rede/VM.

Dados no Firestore

Config em settings/whatsapp-notifications.
Fila em whatsappMessageQueue.
Logs/testes em whatsappOutbound.

Fluxos principais

Enviar confirmacao no POST /api/bookings.
Enviar lembrete via POST /api/cron/send-reminders.
Reprocessar fila via POST /api/cron/process-queue.
Enviar cancelamento via POST /api/public/cancel/:cancelCode.

Operacao da instacia

Checar status em GET /api/admin/whatsapp/status.
Conectar por QR ou pairing em POST /api/admin/whatsapp/connect.
Desconectar em POST /api/admin/whatsapp/disconnect.
Enviar teste em POST /api/admin/whatsapp/send-test.

Observacoes de negocio

Montar mensagens com nome do servico vindo de settings/finance.services[].label.
Manter textos em PT-BR e evitar PII desnecessaria.