Documentação para integração com RizzoClinic
Este documento descreve a arquitetura técnica completa do Rizzo CRM, incluindo todas as entidades, módulos, funções backend e integrações externas — com foco em viabilizar a integração bidirecional com o RizzoClinic (Prontuário Eletrônico).
Plataforma
Base44 (BaaS)
Frontend
React + Tailwind + Vite
Backend
Deno Deploy (serverless)
Banco
Base44 Entities (MongoDB-like)
Auth
Custom (UsuarioApp + localStorage)
IA
Base44 InvokeLLM (GPT-4o)
# Base URL das funções backend:
https://base44.app/api/apps/{APP_ID}/functions/{nome_funcao}
# Autenticação por x-api-key (webhooks externos):
Header: x-api-key: $RIZZOZAP_API_KEY
POST /api/pacientes/cadastrar
Headers: x-api-key: API_EXTERNA_KEY
Body JSON:
{
"nome_completo": "Ana Silva",
"telefone": "48999990000",
"convenio": "particular",
"tratamento": "varizes",
"observacoes": "...",
"origem": "CRM Rizzo",
"token_seguranca": "API_EXTERNA_KEY"
}Retorno: { "id": "ID_DO_PACIENTE" }
| Campo CRM | Entidade | Propósito |
|---|---|---|
| cadastro_app_id | LeadAtendimento | Armazena o ID do paciente no RizzoClinic após cadastro |
| telefone | LeadAtendimento / PropostaComercial | Chave de identificação primária |
| data_consulta | LeadAtendimento | Data do agendamento |
| convenio / numero_carteirinha | LeadAtendimento | Dados do plano de saúde extraídos pelo RizzoZap |
| tipo_consulta | LeadAtendimento | particular | unimed | sc_saude | outro_convenio |
Armazena todos os leads do funil CRM. Ponto de entrada do RizzoZap e origem do cadastro no prontuário.
Proposta comercial enviada ao paciente. Conecta lead → serviços → financeiro → pós-venda.
Tarefas de CS e follow-up. Geradas automaticamente pela régua ou manualmente.
Pagamentos recebidos vinculados a propostas.
Preenchido pelo médico após a consulta. Transfere indicações para a vendedora gerar proposta.
Catálogo de procedimentos com preços, sessões e régua pós-venda por serviço.
| Função | Auth | Descrição |
|---|---|---|
| receberLeadDoBot | x-api-key | Webhook RizzoZap → CRM. Cria/atualiza LeadAtendimento. |
| notificarRizzoZap | service role | CRM → RizzoZap. Dispara eventos de mudança de status. |
| cadastrarPacienteExterno | Base44 auth | CRM → RizzoClinic. Cadastra paciente no prontuário. |
| dispararReguaPosVenda | Base44 auth | Gera TarefaFollowUp automáticas após fechamento. |
| processarRecallAutomatico | admin (agendado) | Move propostas concluídas para recall diariamente. |
| getTarefas | Base44 auth | Lista tarefas com join de proposta vinculada. |
| gerarMensagemCloser | Base44 auth | Gera mensagem de fechamento via IA. |
| fetchMetaAdsMetrics | Base44 auth | Sincroniza métricas do Meta Ads. |
| fetchGoogleAdsMetrics | Base44 auth | Sincroniza métricas do Google Ads. |
| cruzarLeadsPropostas | Base44 auth | Cruza leads com propostas por telefone/nome. |
consulta_marcadaconsulta_realizadalead_descartadoconsulta_desmarcadanova_propostatarefa_followup| Secret / Config | Onde é usado |
|---|---|
| RIZZOZAP_API_KEY | Auth do webhook receberLeadDoBot + envio de eventos para RizzoZap |
| RIZZOZAP_APP_ID | ID do app RizzoZap — montagem da URL de destino dos eventos |
| RIZZOZAP_WEBHOOK_URL | URL de destino alternativa para notificações |
| API_EXTERNA_KEY | Auth para cadastrarPacienteExterno (RizzoClinic) |
| EXTERNAL_APP_PATIENTS_URL | URL para buscar pacientes do app externo |
| META_ACCESS_TOKEN / META_AD_ACCOUNT_ID | Integração Meta Ads |
| GOOGLE_ADS_* | Integração Google Ads (5 secrets) |
| ConfiguracaoApp: url_cadastro_paciente_externo | URL do endpoint de cadastro do RizzoClinic |
⚠️ Para ativar integração com RizzoClinic:
Salvar em ConfiguracaoApp com chave url_cadastro_paciente_externo a URL do endpoint de cadastro do prontuário.