MaarkssDN/Birthub-360 / .agents/skills/baileys-whatsapp-resilience
baileys-whatsapp-resilience
VerifiedGovernança e estabilidade para a integração WhatsApp via @whiskeysockets/baileys. Documenta riscos de conformidade da biblioteca não-oficial, reconexão de sessão, delays anti-ban e aderência ao model WhatsAppMessage.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.4 KB |
SKILL.md
View on GitHub---
name: baileys-whatsapp-resilience
description: Governança e estabilidade para a integração WhatsApp via @whiskeysockets/baileys. Documenta riscos de conformidade da biblioteca não-oficial, reconexão de sessão, delays anti-ban e aderência ao model WhatsAppMessage.
---
# Baileys WhatsApp Resilience — Birth Hub 360
## Objetivo
Operar com resiliência a integração WhatsApp baseada em `@whiskeysockets/baileys`, registrando explicitamente suas restrições operacionais e respeitando o schema atual (`WhatsAppMessage` em `prisma/schema.prisma`).
## Risco Operacional e de Conformidade (Importante)
- `@whiskeysockets/baileys` **não é uma API oficial da Meta**; opera via engenharia reversa do protocolo WebSocket do WhatsApp Web.
- Antes de qualquer ativação comercial em escala, avalie o risco de bloqueio/banimento de números e quebras de protocolo, mantendo os serviços desacoplados atrás de interface de provedor para facilitar uso da WhatsApp Business Cloud API oficial.
## Diretrizes Técnicas
### 1. Persistência de Sessão e Reconexão
- Credenciais de sessão nunca devem ficar em texto puro sem proteção (bloqueador **B-04**).
- No evento `connection.update`:
- `DisconnectReason.loggedOut` (401) exige invalidação da sessão e novo pareamento QR Code.
- Desconexões transitórias devem acionar reconexão com backoff exponencial e jitter.
### 2. Políticas de Cadência e Opt-Out (LGPD)
- Adicione intervalos humanizados (2 a 5 segundos) e atualização de presença (`sendPresenceUpdate('composing')`) antes do envio.
- Comandos de opt-out do titular devem registrar revogação de consentimento imediatamente (bloqueador **B-13**).
### 3. Aderência ao Schema (`WhatsAppMessage` em `prisma/schema.prisma`)
- O model `WhatsAppMessage` atual possui as colunas: `id`, `organizationId`, `waMessageId`, `direction`, `phoneE164`, `body`, `contactId`, `leadId`, `receivedAt`.
- **Não assuma** colunas inexistentes de status de recibo (`status`) ou metadados de mídia (`mediaUrl`, `mimeType`) sem antes abrir handoff formal ao **Agente 01** para evolução de `prisma/schema.prisma`.
## Checklist de Saúde do WhatsApp
- [ ] Números são normalizados em formato `phoneE164` antes de persistir em `WhatsAppMessage`?
- [ ] Toda leitura e escrita em `WhatsAppMessage` respeita o isolamento por `organizationId` (testado em `tests/integration/whatsapp-message-tenant-isolation.test.ts`)?
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |