CRM WhatsApp Grupo 3 completo + Marco A/B (Asaas) + admin SaaS + refactors polimórficos

Sessão 11+: fechamento do CRM de WhatsApp com dois providers (Evolution/Twilio),
sistema de créditos com Asaas/PIX, polimorfismo de telefones/emails, e integração
admin SaaS no /saas/addons existente.

═══════════════════════════════════════════════════════════════════════════
GRUPO 3 — WORKFLOW / CRM (completo)
═══════════════════════════════════════════════════════════════════════════

3.1 Tags · migration conversation_tags + seed de 5 system tags · composable
useConversationTags.js · popover + pills no drawer e nos cards do Kanban.

3.2 Atribuição de conversa a terapeuta · migration 20260421000012 com PK
(tenant_id, thread_key), UPSERT, RLS que valida assignee como membro ativo
do mesmo tenant · view conversation_threads expandida com assigned_to +
assigned_at · composable useConversationAssignment.js · drawer com Select
filtrável + botão "Assumir" · inbox com filtro aside (Todas/Minhas/Não
atribuídas) e chip do responsável em cada card (destaca "Eu" em azul).

3.3 Notas internas · migration conversation_notes · composable + seção
colapsável no drawer · apenas o criador pode editar/apagar (RLS).

3.5 Converter desconhecido em paciente · botão + dialog quick-cadastro ·
"Vincular existente" com Select filter de até 500 pacientes · cria
telefone WhatsApp (vinculado) via upsertWhatsappForExisting.

3.6 Histórico de conversa no prontuário · nova aba "Conversas" em
PatientProntuario.vue · PatientConversationsTab.vue com stats (total /
recebidas / enviadas / primeira / última), SelectButton de filtro, timeline
com bolhas por direção, mídia inline (imagem/áudio/vídeo/doc via signed
URL), indicadores ✓ ✓✓ de delivery, botão "Abrir no CRM".

═══════════════════════════════════════════════════════════════════════════
MARCO A — UNIFICAÇÃO WHATSAPP (dois providers mutuamente exclusivos)
═══════════════════════════════════════════════════════════════════════════

- Página chooser ConfiguracoesWhatsappChooserPage.vue com 2 cards (Pessoal/
  Oficial), deactivate via edge function deactivate-notification-channel
- send-whatsapp-message refatorada com roteamento por provider; Twilio deduz
  1 crédito antes do envio e refunda em falha
- Paridade Twilio (novo): módulo compartilhado supabase/functions/_shared/
  whatsapp-hooks.ts com lógica provider-agnóstica (opt-in, opt-out, auto-
  reply, schedule helpers em TZ São Paulo, makeTwilioCreditedSendFn que
  envolve envio em dedução atômica + rollback). Consumido por Evolution E
  Twilio inbound. Evolution refatorado (~290 linhas duplicadas removidas).
- Bucket privado whatsapp-media · decrypt via Evolution getBase64From
  MediaMessage · upload com path tenant/yyyy/mm · signed URLs on-demand

═══════════════════════════════════════════════════════════════════════════
MARCO B — SISTEMA DE CRÉDITOS WHATSAPP + ASAAS
═══════════════════════════════════════════════════════════════════════════

Banco:
- Migration 20260421000007_whatsapp_credits (4 tabelas: balance,
  transactions, packages, purchases) + RPCs add_whatsapp_credits e
  deduct_whatsapp_credits (atômicas com SELECT FOR UPDATE)
- Migration 20260421000013_tenant_cpf_cnpj (coluna em tenants com CHECK
  de 11 ou 14 dígitos)

Edge functions:
- create-whatsapp-credit-charge · Asaas v3 (sandbox + prod) · PIX com
  QR code · getOrCreateAsaasCustomer patcha customer existente com CPF
  quando está faltando
- asaas-webhook · recebe PAYMENT_RECEIVED/CONFIRMED e credita balance

Frontend (tenant):
- Página /configuracoes/creditos-whatsapp com saldo + loja + histórico
- Dialog de confirmação com CPF/CNPJ (validação via isValidCPF/CNPJ de
  utils/validators, formatação on-blur, pré-fill de tenants.cpf_cnpj,
  persiste no primeiro uso) · fallback sandbox 24971563792 REMOVIDO
- Composable useWhatsappCredits extrai erros amigáveis via
  error.context.json()

Frontend (SaaS admin):
- Em /saas/addons (reuso do pattern existente, não criou página paralela):
  - Aba 4 "Pacotes WhatsApp" — CRUD whatsapp_credit_packages com DataTable,
    toggle is_active inline, dialog de edição com validação
  - Aba 5 "Topup WhatsApp" — tenant Select com saldo ao vivo · RPC
    add_whatsapp_credits com p_admin_id = auth.uid() (auditoria) · histórico
    das últimas 20 transações topup/adjustment/refund

═══════════════════════════════════════════════════════════════════════════
GRUPO 2 — AUTOMAÇÃO
═══════════════════════════════════════════════════════════════════════════

2.3 Auto-reply · conversation_autoreply_settings + conversation_autoreply_
log · 3 modos de schedule (agenda das regras semanais, business_hours
custom, custom_window) · cooldown por thread · respeita opt-out · agora
funciona em Evolution E Twilio (hooks compartilhados)

2.4 Lembretes de sessão · conversation_session_reminders_settings +
_logs · edge send-session-reminders (cron) · janelas 24h e 2h antes ·
Twilio deduz crédito com rollback em falha

═══════════════════════════════════════════════════════════════════════════
GRUPO 5 — COMPLIANCE (LGPD Art. 18 §2)
═══════════════════════════════════════════════════════════════════════════

5.2 Opt-out · conversation_optouts + conversation_optout_keywords (10 system
seed + custom por tenant) · detecção por regex word-boundary e normalização
(lowercase + strip acentos + pontuação) · ack automático (deduz crédito em
Twilio) · opt-in via "voltar", "retornar", "reativar", "restart" ·
página /configuracoes/conversas-optouts com CRUD de keywords

═══════════════════════════════════════════════════════════════════════════
REFACTOR POLIMÓRFICO — TELEFONES + EMAILS
═══════════════════════════════════════════════════════════════════════════

- contact_types + contact_phones (entity_type + entity_id) — migration
  20260421000008 · contact_email_types + contact_emails — 20260421000011
- Componentes ContactPhonesEditor.vue e ContactEmailsEditor.vue (add/edit/
  remove com confirm, primary selector, WhatsApp linked badge)
- Composables useContactPhones.js + useContactEmails.js com
  unsetOtherPrimaries() e validação
- Trocado em PatientsCadastroPage.vue e MedicosPage.vue (removidos campos
  legados telefone/telefone_alternativo e email_principal/email_alternativo)
- Migration retroativa v2 (20260421000010) detecta conversation_messages
  e cria/atualiza phone como WhatsApp vinculado

═══════════════════════════════════════════════════════════════════════════
POLIMENTO VISUAL + INFRA
═══════════════════════════════════════════════════════════════════════════

- Skeletons simplificados no dashboard do terapeuta
- Animações fade-up com stagger via [--delay:Xms] (fix specificity sobre
  .dash-card box-shadow transition)
- ConfirmDialog com group="conversation-drawer" (evita montagem duplicada)
- Image preview PrimeVue com botão de download injetado via MutationObserver
  (fetch + blob para funcionar cross-origin)
- Áudio/vídeo com preload="metadata" e controles de velocidade do browser
- friendlySendError() mapeia códigos do edge pra mensagens pt-BR via
  error.context.json()
- Teleport #cfg-page-actions para ações globais de Configurações
- Brotli/Gzip + auto-import Vue/PrimeVue + bundle analyzer
- AppLayout consolidado (removidas duplicatas por área) + RouterPassthrough
- Removido console.trace debug que estava em watch de router e queries
  Supabase (degradava perf pra todos)
- Realtime em conversation_messages via publication supabase_realtime
- Notifier global flutuante com beep + toggle mute (4 camadas: badge +
  sino + popup + browser notification)

═══════════════════════════════════════════════════════════════════════════
MIGRATIONS NOVAS (13)
═══════════════════════════════════════════════════════════════════════════

20260420000001_patient_intake_invite_info_rpc
20260420000002_audit_logs_lgpd
20260420000003_audit_logs_unified_view
20260420000004_lgpd_export_patient_rpc
20260420000005_conversation_messages
20260420000005_search_global_rpc
20260420000006_conv_messages_notifications
20260420000007_notif_channels_saas_admin_insert
20260420000008_conv_messages_realtime
20260420000009_conv_messages_delivery_status
20260421000001_whatsapp_media_bucket
20260421000002_conversation_notes
20260421000003_conversation_tags
20260421000004_conversation_autoreply
20260421000005_conversation_optouts
20260421000006_session_reminders
20260421000007_whatsapp_credits
20260421000008_contact_phones
20260421000009_retroactive_whatsapp_link
20260421000010_retroactive_whatsapp_link_v2
20260421000011_contact_emails
20260421000012_conversation_assignments
20260421000013_tenant_cpf_cnpj

═══════════════════════════════════════════════════════════════════════════
EDGE FUNCTIONS NOVAS / MODIFICADAS
═══════════════════════════════════════════════════════════════════════════

Novas:
- _shared/whatsapp-hooks.ts (módulo compartilhado)
- asaas-webhook
- create-whatsapp-credit-charge
- deactivate-notification-channel
- evolution-webhook-provision
- evolution-whatsapp-inbound
- get-intake-invite-info
- notification-webhook
- send-session-reminders
- send-whatsapp-message
- submit-patient-intake
- twilio-whatsapp-inbound

═══════════════════════════════════════════════════════════════════════════
FRONTEND — RESUMO
═══════════════════════════════════════════════════════════════════════════

Composables novos: useAddonExtrato, useAuditoria, useAutoReplySettings,
useClinicKPIs, useContactEmails, useContactPhones, useConversationAssignment,
useConversationNotes, useConversationOptouts, useConversationTags,
useConversations, useLgpdExport, useSessionReminders, useWhatsappCredits

Stores: conversationDrawerStore

Componentes novos: ConversationDrawer, GlobalInboundNotifier, GlobalSearch,
ContactEmailsEditor, ContactPhonesEditor

Páginas novas: CRMConversasPage, PatientConversationsTab, AddonsExtratoPage,
AuditoriaPage, NotificationsHistoryPage, ConfiguracoesWhatsappChooserPage,
ConfiguracoesConversasAutoreplyPage, ConfiguracoesConversasOptoutsPage,
ConfiguracoesConversasTagsPage, ConfiguracoesCreditosWhatsappPage,
ConfiguracoesLembretesSessaoPage

Utils novos: addonExtratoExport, auditoriaExport, excelExport,
lgpdExportFormats

Páginas existentes alteradas: ClinicDashboard, PatientsCadastroPage,
PatientCadastroDialog, PatientsListPage, MedicosPage, PatientProntuario,
ConfiguracoesWhatsappPage, SaasWhatsappPage, ConfiguracoesRecursosExtrasPage,
ConfiguracoesPage, AgendaTerapeutaPage, AgendaClinicaPage, NotificationItem,
NotificationDrawer, AppLayout, AppTopbar, useMenuBadges,
patientsRepository, SaasAddonsPage (aba 4 + 5 WhatsApp)

Routes: routes.clinic, routes.configs, routes.therapist atualizados
Menus: clinic.menu, therapist.menu, saas.menu atualizados

═══════════════════════════════════════════════════════════════════════════
NOTAS

- Após subir, rodar supabase functions serve --no-verify-jwt
  --env-file supabase/functions/.env pra carregar o módulo _shared
- WHATSAPP_SETUP.md reescrito (~400 linhas) com setup completo dos 3
  providers + troubleshooting + LGPD
- HANDOFF.md atualizado com estado atual e próximos passos

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

supabase/functions/twilio-whatsapp-inbound/index.ts

@@ -0,0 +1,221 @@
+/*
+|--------------------------------------------------------------------------
+| Agência PSI — Edge Function: twilio-whatsapp-inbound
+|--------------------------------------------------------------------------
+| Recebe mensagens WhatsApp RECEBIDAS pelos tenants via Twilio.
+| Diferente do twilio-whatsapp-webhook (que trata apenas status de mensagens
+| enviadas), este recebe o conteudo de respostas dos pacientes.
+|
+| URL configurada no numero da subconta de cada tenant, campo "WHEN A
+| MESSAGE COMES IN":
+|   https://<project>.supabase.co/functions/v1/twilio-whatsapp-inbound?tenant_id=<uuid>
+|
+| Hooks aplicados (provider-agnostico via _shared/whatsapp-hooks):
+|   1) Opt-IN detection (keywords "voltar", "retornar", ...)
+|   2) Opt-OUT detection (keywords do tenant + system) com ack automatico
+|   3) Auto-reply fora do horario (se nao houve opt-out) com credit deduction
+|
+| Custos: cada envio (ack de opt-out + auto-reply) DEDUZ 1 credito do tenant.
+| Se o saldo estiver zerado, o hook falha silenciosamente (nao envia).
+|--------------------------------------------------------------------------
+*/
+
+import { createClient } from 'https://esm.sh/@supabase/supabase-js@2'
+import {
+    buildThreadKey,
+    detectOptoutKeyword,
+    maybeOptIn,
+    maybeSendAutoReply,
+    makeTwilioCreditedSendFn,
+    registerOptout,
+    type TwilioChannel
+} from '../_shared/whatsapp-hooks.ts'
+
+const corsHeaders = {
+    'Access-Control-Allow-Origin':  '*',
+    'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
+    'Access-Control-Allow-Methods': 'POST, GET, OPTIONS',
+}
+
+const EMPTY_TWIML = '<?xml version="1.0" encoding="UTF-8"?><Response></Response>'
+
+function stripWhatsappPrefix(raw: string | null | undefined): string | null {
+    if (!raw) return null
+    return raw.replace(/^whatsapp:/i, '').trim()
+}
+
+Deno.serve(async (req: Request) => {
+    if (req.method === 'OPTIONS') {
+        return new Response('ok', { headers: corsHeaders })
+    }
+
+    if (req.method !== 'POST') {
+        return new Response(EMPTY_TWIML, {
+            status: 200,
+            headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+        })
+    }
+
+    try {
+        const url = new URL(req.url)
+        const tenantId = url.searchParams.get('tenant_id')
+
+        if (!tenantId) {
+            console.error('[twilio-whatsapp-inbound] tenant_id ausente na URL')
+            return new Response(EMPTY_TWIML, {
+                status: 200,
+                headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+            })
+        }
+
+        const supabase = createClient(
+            Deno.env.get('SUPABASE_URL')!,
+            Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!
+        )
+
+        const formData = await req.formData()
+        const from        = stripWhatsappPrefix(formData.get('From') as string)
+        const to          = stripWhatsappPrefix(formData.get('To') as string)
+        const body        = (formData.get('Body') as string) ?? null
+        const messageSid  = formData.get('MessageSid') as string
+        const numMedia    = parseInt((formData.get('NumMedia') as string) ?? '0', 10)
+        const mediaUrl    = numMedia > 0 ? (formData.get('MediaUrl0') as string) : null
+        const mediaMime   = numMedia > 0 ? (formData.get('MediaContentType0') as string) : null
+
+        if (!from || !messageSid) {
+            console.warn('[twilio-whatsapp-inbound] payload incompleto')
+            return new Response(EMPTY_TWIML, {
+                status: 200,
+                headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+            })
+        }
+
+        const cleanBody = body
+            ? String(body).replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '').slice(0, 4000)
+            : null
+
+        const { data: matchData } = await supabase.rpc('match_patient_by_phone', {
+            p_tenant_id: tenantId,
+            p_phone: from
+        })
+        const patientId = matchData as string | null
+
+        const raw: Record<string, unknown> = {
+            MessageSid: messageSid,
+            AccountSid: formData.get('AccountSid') ?? null,
+            From: from,
+            To: to,
+            NumMedia: numMedia,
+            ProfileName: formData.get('ProfileName') ?? null,
+            WaId: formData.get('WaId') ?? null,
+        }
+
+        const { error: insErr } = await supabase.from('conversation_messages').insert({
+            tenant_id: tenantId,
+            patient_id: patientId,
+            channel: 'whatsapp',
+            direction: 'inbound',
+            from_number: from,
+            to_number: to,
+            body: cleanBody,
+            media_url: mediaUrl,
+            media_mime: mediaMime,
+            provider: 'twilio',
+            provider_message_id: messageSid,
+            provider_raw: raw,
+            kanban_status: 'awaiting_us',
+            received_at: new Date().toISOString()
+        })
+
+        if (insErr) {
+            console.error('[twilio-whatsapp-inbound] insert error:', insErr)
+            return new Response(EMPTY_TWIML, {
+                status: 200,
+                headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+            })
+        }
+
+        // ─────────────────────────────────────────────────────
+        // Hooks: opt-in, opt-out, auto-reply
+        // ─────────────────────────────────────────────────────
+        let optoutAction: 'in' | 'out' | null = null
+        let autoReplyResult: { sent: boolean; reason?: string } | null = null
+
+        try {
+            // Busca canal Twilio (uma vez) — reutilizado por registerOptout/autoReply
+            const { data: channel } = await supabase
+                .from('notification_channels')
+                .select('credentials, provider, twilio_subaccount_sid, twilio_phone_number, is_active')
+                .eq('tenant_id', tenantId)
+                .eq('channel', 'whatsapp')
+                .is('deleted_at', null)
+                .maybeSingle()
+
+            if (channel && channel.is_active && channel.provider === 'twilio') {
+                // 1) Opt-IN (voltar) tem prioridade
+                if (await maybeOptIn(supabase, tenantId, from, cleanBody)) {
+                    optoutAction = 'in'
+                }
+
+                // 2) Opt-OUT por keyword — envia ack via Twilio (deduz 1 credito)
+                if (!optoutAction) {
+                    const keyword = await detectOptoutKeyword(supabase, tenantId, cleanBody)
+                    if (keyword) {
+                        const optoutSendFn = makeTwilioCreditedSendFn(
+                            supabase,
+                            tenantId,
+                            channel as unknown as TwilioChannel,
+                            'Opt-out ack WhatsApp'
+                        )
+                        await registerOptout(
+                            supabase,
+                            tenantId,
+                            from,
+                            patientId,
+                            cleanBody,
+                            keyword,
+                            'twilio',
+                            optoutSendFn
+                        )
+                        optoutAction = 'out'
+                    }
+                }
+
+                // 3) Auto-reply fora do horario (so se nao foi opt-out)
+                if (optoutAction !== 'out') {
+                    const threadKey = buildThreadKey(patientId, from)
+                    const arSendFn = makeTwilioCreditedSendFn(
+                        supabase,
+                        tenantId,
+                        channel as unknown as TwilioChannel,
+                        'Auto-reply WhatsApp'
+                    )
+                    autoReplyResult = await maybeSendAutoReply(
+                        supabase,
+                        tenantId,
+                        threadKey,
+                        from,
+                        'twilio',
+                        arSendFn
+                    )
+                }
+            }
+        } catch (err) {
+            console.error('[twilio-whatsapp-inbound] hooks error:', err)
+        }
+
+        // Twilio espera TwiML vazio (nao reenvia); logs no console
+        console.log('[twilio-whatsapp-inbound] processed', { tenantId, from, optoutAction, autoReplyResult })
+
+        return new Response(EMPTY_TWIML, {
+            status: 200,
+            headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+        })
+    } catch (err) {
+        console.error('[twilio-whatsapp-inbound] fatal:', err)
+        return new Response(EMPTY_TWIML, {
+            status: 200,
+            headers: { ...corsHeaders, 'Content-Type': 'text/xml' }
+        })
+    }
+})