Skip to content

MaarkssDN/Birthub-360 / .agents/skills/baileys-whatsapp-resilience

baileys-whatsapp-resilience

Verified

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)?
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall