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.
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/baileysnã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
WhatsAppMessageatual 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 deprisma/schema.prisma.
Checklist de Saúde do WhatsApp
- Números são normalizados em formato
phoneE164antes de persistir emWhatsAppMessage? - Toda leitura e escrita em
WhatsAppMessagerespeita o isolamento pororganizationId(testado emtests/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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |