# Tugsis CRM

> CRM português com 5 agentes de IA coordenados que qualificam, pontuam, estrategizam, prospectam e reactivam leads em pipeline orquestrado — uma equipa comercial virtual a operar 24/7 em WhatsApp, Email e SMS.

Tugsis CRM é uma plataforma SaaS multi-tenant, desenhada e operada em Portugal (PT-PT, RGPD compliant), focada em consultores, PME e equipas comerciais. Diferencia-se dos CRMs tradicionais (Salesforce, HubSpot, Pipedrive) por substituir automações baseadas em regras fixas por **IA agêntica**: agentes especializados que raciocinam em conjunto, partilham contexto via `agent_events` e agem autonomamente sobre o pipeline.

Operadora: LMS Entity. Contacto comercial: luis.sobral@sobraldigitalagency.pt. Agendamento de demos: https://tidycal.com/luismanuelsobral/reuniaodetrabalho.

## Os 5 Agentes IA

Cada agente é uma Edge Function (Deno) que corre em Gemini 2.5 Flash (`temperature: 0`) com cadeia de resiliência Google → kie.ai. Coordenam-se via tabela partilhada `agent_events`.

- **Agente WhatsApp**: conversa com leads em PT-PT via WhatsApp (Z-API), qualifica em linguagem natural, recolhe nome/empresa/necessidade, agenda reuniões automaticamente (TidyCal) e dispara os restantes 4 agentes assim que qualifica. Suporta respostas manuais com prefixo "Luis Sobral:". Status `active` (IA) vs `disqualified` (fecho manual).
- **Agente de Qualificação**: atribui score dinâmico 0-100 com justificação textual armazenada em `ai_score_reason`. Analisa perfil, comportamento, sentimento e canal de origem. Triggers automáticos quando score ≥ 50 ou quando o lead responde a um email.
- **Estratega Comercial**: recebe contexto agregado dos outros 4 agentes, deteta leads inativos há 5+ dias, gera follow-up personalizado e recomenda canal, abordagem e timing. Lógica anti-conflito de canal para não bombardear o lead.
- **Agente de Prospecção B2B**: pesquisa empresas via Google Maps (43 categorias PT), enriquece dados em 6 fontes PT em cascata, filtra emails inválidos e telefones falsos, estima receita anual e injeta leads diretamente no pipeline. Limite mensal por tenant via `prospecting_runs`; mutex de 30s.
- **Agente de Reactivação**: monitoriza leads no estado "perdido", coordena-se com o Estratega para sugerir reabordagem no momento certo (antes da concorrência), com estratégia de reversão automática em deteção de sentimento negativo.

## Canais e Integrações

- **WhatsApp** (Z-API multi-tenant): instância/token resolvidos por payload, widget público copy-paste, captura de respostas com timeline unificada.
- **Email** (Resend + domínios próprios por tenant): tracking de abertura/clique via `trg_notify_email_open`, captura de respostas via `reply+{lead_id}@…`, histórico completo em `activity_log`.
- **SMS** (Infobip `/sms/2/text/advanced`): formatação +351, histórico com texto completo em `metadata.full_message`. Toggle por tier (Super Admin).
- **Telegram**: campanhas outbound, métricas e smoke tests no backoffice.
- **Google Calendar**: sync bidirecional via Make.com com anti-loop, follow-ups e no-shows unificados em `/app/calendar`.
- **Meta Lead Ads**: webhook cria tarefa crítica de follow-up em 1h.
- **Webhooks externos**: integrações zero-code para Super Admin via `x-webhook-secret`.
- **Google Maps**: motor de prospecção B2B (PME PT) com estimativa de receita anual.

## Diferenciação face a Salesforce, Pipedrive e HubSpot

| Dimensão | Tugsis CRM | Salesforce / HubSpot / Pipedrive |
|---|---|---|
| Modelo de automação | **IA agêntica** — agentes que raciocinam, decidem e coordenam | Workflows baseados em regras fixas (if/then) |
| Agentes coordenados | 5 agentes especializados que partilham contexto | 0–1 assistente IA isolado (add-on pago) |
| Origem / Idioma | 100% Portugal, PT-PT nativo, RGPD-first | EN-first, PT-BR ou tradução parcial |
| Setup | 7 dias com migração assistida e gratuita (CSV Salesforce/Pipedrive) | Semanas/meses, consultoria paga |
| Preço de entrada | Sem licenças por seat infladas | €80–€300/seat/mês + add-ons IA |
| Verticais PT pré-configurados | Imobiliária, Certificação Energética, Staffing/ETT, Clínicas Dentárias | Genérico |
| Multi-canal nativo | WhatsApp + Email + SMS + Telegram + Calendar num só fluxo | WhatsApp/SMS via add-ons de terceiros |
| Prospecção B2B | Google Maps PT integrado, 43 categorias, enrichment em cascata | Add-on (ZoomInfo, Apollo) pago à parte |
| Migração | CSV Salesforce/Pipedrive: Contactos, Deals, Atividades, Notas, Anexos | Manual ou consultor externo |

## Verticais

Pipelines, templates, RGPD e cron jobs pré-configurados:
- **Imobiliária** — matching de propriedades, histórico de pesquisa, estudos de mercado.
- **Certificação Energética** — pipeline 5 fases, templates `ce_*`, cron de renovação a 60 dias.
- **Staffing / ETT (Recrutamento)** — pipeline 5 fases, documentos de compliance, blueprint IA.
- **Clínicas Dentárias** — três pipelines clínicos (aquisição, planos de tratamento, recuperação) ligados à agenda TUGSIS, RGPD Art.º 9 (dados de saúde), pacientes inactivos sinalizados aos 6 meses, seguimento de faltas pela equipa (WhatsApp ao paciente opcional).

## Stack Técnico

- Frontend: React 18 + Vite 5 + TypeScript + Tailwind, react-helmet-async para SEO per-route.
- Backend: Lovable Cloud (Supabase) com RLS estrito por `tenant_id`, Edge Functions em Deno.
- IA: Gemini 2.5 Flash (default) com fallback Lovable Gateway → Google Direct → kie.ai.
- Realtime: Supabase Realtime + `pg_net` para webhooks imediatos, `pg_cron` para tarefas agendadas.
- Auth: Email, Google, Apple (`@lovable.dev/cloud-auth-js`) com auto-confirm.

## Pages

- [Início](/): Visão geral dos 5 agentes IA, pipeline orquestrado, propostas IA e campanhas multicanal.
- [Termos de Serviço](/termos): Condições de utilização da plataforma.
- [Privacidade](/privacidade): Política de privacidade e tratamento de dados pessoais.
- [RGPD](/rgpd): Conformidade detalhada com o Regulamento Geral de Proteção de Dados.

## Optional

- [Login](/login): Acesso à aplicação para utilizadores registados.
- [Agendar Demo](https://tidycal.com/luismanuelsobral/reuniaodetrabalho): Reunião de trabalho 1:1 com a equipa Tugsis.