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>
2026-04-23 07:05:24 -03:00
parent 037ba3721f
commit 2644e60bb6
191 changed files with 38629 additions and 3756 deletions
@@ -0,0 +1,298 @@
+/*
+|--------------------------------------------------------------------------
+| Agência PSI — Edge Function: notification-webhook
+|--------------------------------------------------------------------------
+| Recebe webhooks de status dos provedores (Evolution API, Meta, etc.)
+| e atualiza notification_logs + processa opt-out (SAIR).
+|
+| Runtime: Deno (Supabase Edge Functions)
+| Linguagem: JavaScript puro
+|--------------------------------------------------------------------------
+*/
+
+import { createClient } from 'https://esm.sh/@supabase/supabase-js@2'
+
+const SUPABASE_URL = Deno.env.get('SUPABASE_URL')
+const SUPABASE_SERVICE_KEY = Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')
+const EVOLUTION_API_KEY = Deno.env.get('EVOLUTION_API_KEY') || ''
+const META_VERIFY_TOKEN = Deno.env.get('META_VERIFY_TOKEN') || ''
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_SERVICE_KEY)
+
+
+Deno.serve(async (req) => {
+  const url = new URL(req.url)
+  const provider = url.searchParams.get('provider') || 'unknown'
+
+  // Meta webhook verification (GET com challenge)
+  if (req.method === 'GET' && provider === 'meta') {
+    return handleMetaVerification(url)
+  }
+
+  if (req.method !== 'POST') {
+    return jsonResponse({ error: 'Method not allowed' }, 405)
+  }
+
+  try {
+    const body = await req.json()
+
+    switch (provider) {
+      case 'evolution':
+        return await handleEvolutionWebhook(req, body)
+      case 'meta':
+        return await handleMetaWebhook(body)
+      default:
+        return jsonResponse({ error: `Provider "${provider}" não suportado` }, 400)
+    }
+  } catch (err) {
+    console.error(`[webhook] Erro:`, err.message)
+    return jsonResponse({ error: err.message }, 500)
+  }
+})
+
+
+// ── Evolution API Webhook ───────────────────────────────────
+
+/**
+ * Processa webhooks da Evolution API.
+ * Eventos relevantes:
+ * - messages.update: status de entrega (enviado, entregue, lido)
+ * - messages.upsert: mensagem recebida (para detectar "SAIR")
+ */
+async function handleEvolutionWebhook (req, body) {
+  // Validação básica da API key
+  const apiKey = req.headers.get('apikey') || ''
+  if (EVOLUTION_API_KEY && apiKey !== EVOLUTION_API_KEY) {
+    return jsonResponse({ error: 'Invalid API key' }, 401)
+  }
+
+  const event = body.event
+  const instance = body.instance
+
+  console.log(`[evolution] Evento: ${event}, Instância: ${instance}`)
+
+  // ── Status de mensagem enviada ────
+  if (event === 'messages.update') {
+    const key = body.data?.key
+    const messageId = key?.id
+    const status = body.data?.update?.status
+
+    if (!messageId) {
+      return jsonResponse({ ok: true, skipped: 'no messageId' })
+    }
+
+    // Mapeia status numérico da Evolution
+    // 1 = pendente, 2 = enviado ao servidor, 3 = entregue, 4 = lido, 5 = erro
+    const statusMap = {
+      1: null,           // pendente — não atualiza
+      2: 'sent',         // enviado ao servidor WhatsApp
+      3: 'delivered',    // entregue ao dispositivo
+      4: 'read',         // lido
+      5: 'failed',       // erro
+    }
+
+    const mappedStatus = statusMap[status]
+    if (!mappedStatus) {
+      return jsonResponse({ ok: true, skipped: `status ${status} ignorado` })
+    }
+
+    await updateLogStatus(messageId, mappedStatus)
+    return jsonResponse({ ok: true, status: mappedStatus })
+  }
+
+  // ── Mensagem recebida (para opt-out) ────
+  if (event === 'messages.upsert') {
+    const message = body.data?.message
+    const text = (
+      message?.conversation ||
+      message?.extendedTextMessage?.text ||
+      ''
+    ).trim().toUpperCase()
+
+    const remoteJid = body.data?.key?.remoteJid || ''
+    const phone = remoteJid.replace('@s.whatsapp.net', '').replace('@c.us', '')
+
+    // Detecta opt-out
+    if (['SAIR', 'PARAR', 'STOP', 'CANCELAR MENSAGENS'].includes(text)) {
+      console.log(`[evolution] Opt-out detectado: ${phone}`)
+      await handleOptOut(phone, instance)
+      return jsonResponse({ ok: true, action: 'opt_out' })
+    }
+
+    // Detecta confirmação (futuro: atualizar status da sessão)
+    if (['OK', '✅', 'CONFIRMAR', 'CONFIRMO', 'SIM'].includes(text)) {
+      console.log(`[evolution] Confirmação detectada: ${phone}`)
+      // TODO: buscar sessão pendente mais próxima e confirmar
+      return jsonResponse({ ok: true, action: 'confirmation_detected' })
+    }
+
+    return jsonResponse({ ok: true, action: 'message_ignored' })
+  }
+
+  return jsonResponse({ ok: true, event_ignored: event })
+}
+
+
+// ── Meta WhatsApp Webhook ───────────────────────────────────
+
+/**
+ * Verificação de webhook da Meta (challenge handshake).
+ */
+function handleMetaVerification (url) {
+  const mode = url.searchParams.get('hub.mode')
+  const token = url.searchParams.get('hub.verify_token')
+  const challenge = url.searchParams.get('hub.challenge')
+
+  if (mode === 'subscribe' && token === META_VERIFY_TOKEN) {
+    return new Response(challenge, { status: 200 })
+  }
+
+  return jsonResponse({ error: 'Verification failed' }, 403)
+}
+
+/**
+ * Processa webhooks da Meta WhatsApp Business API.
+ */
+async function handleMetaWebhook (body) {
+  const entries = body.entry || []
+
+  for (const entry of entries) {
+    const changes = entry.changes || []
+
+    for (const change of changes) {
+      const value = change.value || {}
+
+      // ── Status de mensagem ────
+      if (value.statuses) {
+        for (const st of value.statuses) {
+          const messageId = st.id
+          const status = st.status // sent, delivered, read, failed
+          const errors = st.errors || []
+
+          if (messageId && status) {
+            const mappedStatus = status === 'failed' ? 'failed' : status
+            await updateLogStatus(messageId, mappedStatus, errors[0]?.message)
+          }
+        }
+      }
+
+      // ── Mensagens recebidas (opt-out) ────
+      if (value.messages) {
+        for (const msg of value.messages) {
+          const text = (msg.text?.body || '').trim().toUpperCase()
+          const phone = msg.from || ''
+
+          if (['SAIR', 'PARAR', 'STOP', 'CANCELAR MENSAGENS'].includes(text)) {
+            console.log(`[meta] Opt-out detectado: ${phone}`)
+            await handleOptOut(phone, null)
+          }
+
+          // Botão de resposta rápida (quick reply)
+          if (msg.type === 'button' || msg.type === 'interactive') {
+            const payload = msg.button?.payload || msg.interactive?.button_reply?.id || ''
+            console.log(`[meta] Button reply: ${payload} de ${phone}`)
+            // TODO: processar confirmação/cancelamento via botão
+          }
+        }
+      }
+    }
+  }
+
+  return jsonResponse({ ok: true })
+}
+
+
+// ── Helpers compartilhados ──────────────────────────────────
+
+/**
+ * Atualiza o status no notification_logs com base no provider_message_id.
+ */
+async function updateLogStatus (providerMessageId, status, failureReason) {
+  const now = new Date().toISOString()
+  const updateData = { provider_status: status }
+
+  switch (status) {
+    case 'sent':
+      updateData.status = 'sent'
+      break
+    case 'delivered':
+      updateData.status = 'delivered'
+      updateData.delivered_at = now
+      break
+    case 'read':
+      updateData.status = 'read'
+      updateData.read_at = now
+      break
+    case 'failed':
+      updateData.status = 'failed'
+      updateData.failed_at = now
+      updateData.failure_reason = failureReason || 'Falha reportada pelo provedor'
+      break
+  }
+
+  const { error } = await supabase
+    .from('notification_logs')
+    .update(updateData)
+    .eq('provider_message_id', providerMessageId)
+
+  if (error) {
+    console.warn(`[updateLogStatus] Erro ao atualizar ${providerMessageId}:`, error.message)
+  }
+}
+
+
+/**
+ * Processa opt-out: desativa WhatsApp para o paciente e cancela pendentes.
+ * @param {string} phone - número de telefone (apenas dígitos)
+ * @param {string|null} instanceName - nome da instância Evolution (para identificar owner)
+ */
+async function handleOptOut (phone, instanceName) {
+  // Normaliza telefone
+  const cleanPhone = String(phone).replace(/\D/g, '')
+  if (!cleanPhone) return
+
+  // Busca paciente(s) com esse telefone
+  const { data: patients } = await supabase
+    .from('patients')
+    .select('id, owner_id, telefone')
+    .or(`telefone.like.%${cleanPhone}%`)
+
+  if (!patients || patients.length === 0) {
+    console.warn(`[opt-out] Nenhum paciente encontrado para ${cleanPhone}`)
+    return
+  }
+
+  for (const patient of patients) {
+    // Atualiza preferência (o trigger cancela pendentes automaticamente)
+    const { error } = await supabase
+      .from('notification_preferences')
+      .upsert({
+        owner_id: patient.owner_id,
+        tenant_id: patient.owner_id,  // será ajustado pelo context
+        patient_id: patient.id,
+        whatsapp_opt_in: false,
+        lgpd_opt_out_date: new Date().toISOString(),
+        lgpd_opt_out_reason: 'Paciente respondeu SAIR no WhatsApp',
+      }, {
+        onConflict: 'owner_id,patient_id',
+        ignoreDuplicates: false,
+      })
+
+    if (error) {
+      console.error(`[opt-out] Erro ao salvar preferência para paciente ${patient.id}:`, error.message)
+    } else {
+      console.log(`[opt-out] WhatsApp desativado para paciente ${patient.id}`)
+    }
+  }
+}
+
+
+/**
+ * Helper para respostas JSON padronizadas.
+ */
+function jsonResponse (data, status = 200) {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
+}