Claude Code Plugins

Community-maintained marketplace

Feedback

sr-cardoso-whatsapp

@yurikrat/sr-cardoso-barbearia-app
0
0

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

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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

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.