# 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.

- Skill: `majiayu000/sr-cardoso-whatsapp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/sr-cardoso-whatsapp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/sr-cardoso-whatsapp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/sr-cardoso-whatsapp

---


# 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.