Lacunas conhecidas
Separe comportamento observado, descrições históricas e trabalho futuro.
Estas lacunas descrevem tabelas, campos, views e automações do Airtable do CRM como estavam em 28/10/2026. Não são mudanças feitas no CRM. O trabalho em aberto é acompanhado como Work Items no Systems Central; cada item abaixo traz o nome do Work Item e o status nessa data.
Inconsistências atuais
- Desde 04/11/2026 um lead é um Deal no estágio Lead. A tabela Relationship foi apagada nesse dia, depois que os registros dela foram migrados para Deals, junto com os 17 campos de outras tabelas que apontavam para ela.
- Desde 04/11/2026 a campanha é ligada no Deal em Campaign°, e Interaction.Campaign a lê por Deal°. A tabela Campaign Participation foi apagada nesse dia, com seus campos no Deal e na Interaction e o Campaign Attribution Check. No mesmo dia os 412 Deals com a tag Win the Storm foram ligados à campanha Win The Storm 2026. O fluxo do Cal.com não preenche Campaign°.
- Pendente: as views de etapa do Deal e da Interaction estão sendo refeitas; algumas ainda mostram colunas antigas.
- Pendente: o workflow Email Logging do n8n (desligado) ainda tem uma etapa Find Relationships e precisa passar para Deals antes de ser ligado.
- Descrições de People/Companies prometem escrita de mão dupla e tratamento automático de duplicados. O sync do Airtable é de mão única e o Core é o único escritor dos registros compartilhados (regra ainda proposta, não adotada); trate essas descrições como não confirmadas e confira as configurações do sync. Cal.com grava novas pessoas no Core. Work Items: “Document the CRM two-way exception to Core ownership” e “Write the mirror sync contract per domain (writer, freshness, conflicts)”.
- Deal.Product* aponta para Offer. Positions tem campos de Team, enquanto bds:position tem estrutura de Position. Não migre apenas pelo rótulo. Work Items: “Rename the remaining misnamed synced tables” e “Free CRM sync slots (duplicate Positions, BusinessRelationship mirror)”.
- CRM Record ID é fórmula local RECORD_ID(), apesar da descrição que mistura UUID. Membership # difere do atual Membership ID no Core.
- A automação nativa de cópia do próximo contato foi apagada com a tabela Relationship em 04/11/2026: o escopo da v1 mantém o próximo passo como atualização manual. Desde 04/11/2026 essa atualização é uma tarefa em Tasks. Work Item: “Decide how manual Interactions update the Relationship next step” (Waiting).
- Relationship.Task° e Due date* foram migrados para Tasks em 04/11/2026, antes de a tabela ser apagada. Tasks liga direto a People, Companies e Deal. Interaction.Next Action° continua como texto por enquanto. Work Item: “Decide whether Relationship Task° becomes a link to a structured Task” (Waiting).
- A coluna Tags criada em 22/10/2026 leva uma frase solta dentro do bloco
definition:, e 13 das 14 colunas que ela acrescentou à tabela Tags não têm descrição; duas se chamam Team 2 e Department 2. Work Item: “Fix the malformed Tags column descriptions”. - O alerta de participação incoerente ao lado do ✅ de Health check não existe mais: o Campaign Attribution Check foi apagado em 04/11/2026. O Work Item “Show the participation-mismatch alert apart from the Health check tick” pode ser fechado.
- As descrições das views estão incompletas. Em 28/10/2026 os calendários SEO Companies, Trevor - Cal.com e Verena - Cal.com não tinham descrição. Work Items: “Review and fix the description of every CRM view” e “Triage the 349 CRM usability audit items by rule”.
Limites da integração
Cal.com usa primeira correspondência para regra, pessoa e Deal aberto, uma página de API para listas, assinatura sobre JSON serializado e deduplicação por UID sem trava atômica. E-mail/UID/data ausentes não são todos rejeitados. Após aguardar mirror de pessoa ausente, continua com notas de reparo. PATCH/criações separados podem deixar resultados parciais; repetir não garante reparo. Esse workflow não inscreve nem atribui campanhas.
Em 28/10/2026 cinco regras de Lead Source estavam marcadas como ativas, uma por calendário de vendedor, e agendamentos criaram linhas de lead e de Interaction nesse dia. Desde 04/11/2026 os agendamentos criam ou avançam um Deal. Uma regra ativa não prova que cada conta funciona: confira o log de execuções do n8n para cada calendário de vendedor antes de depender dele. As duas automações nativas vazias, Automation 1 e Automation 2, continuam na base.
| Work Item | Status |
|---|---|
| Test an unmapped Cal.com source end to end (pilot case P16) | Waiting |
| Automate Campaign attribution in the Cal.com n8n flow | To Do |
| Validate central calendar coverage and Amanda’s access | To Do |
| Decide event title format and two-way calendar sync scope | To Do |
| Validate Fireflies transcripts and identify clients by any participant | Waiting |
| Activate the Email Logging workflow (Gmail to Message and Interaction) | Waiting |
| Sync Message to consumer bases and link Relationship Messages | To Do |
| Finish Cal.com session config cleanup (percent format, empty automations) | To Do |
Escopo de campanhas
A campanha atual pode estar Active com fatos da origem incompletos; por isso, a fila de disponíveis a exclui. Em 28/10/2026 Seo for Agents estava Active enquanto seu Campaign Check apontava objetivo, público, organização, membership e data de início ausentes. As cinco linhas de Participation do piloto foram apagadas com a tabela em 04/11/2026. O Campaign° do Deal aceita mais de um registro; uma campanha por Deal é regra de trabalho, não restrição do banco. Exclusão definitiva na origem pode deixar dados preservados no mirror. Ofertas/metas por campanha, sequências, supressão automática e métricas avançadas ficam após a v1.
A v1 fechada usa atribuição manual e exige revisão da carteira, dos registros sem participação e dos resultados. Clientes de Deals Won com trabalho de campanha ativo são revisados pelos Deals ligados à campanha. Last Contact Date agrega datas de Interactions e não comprova realização. Sem campos dedicados, realização e fechamento real, moeda/base do valor e impedimentos de contato devem ficar explícitos nas notas existentes e ser recuperáveis por outro operador. Não usar Expected Close Date como data real de venda nem limpar um vínculo de campanha para representar bloqueio geral. Não representam controles automáticos implementados. Os Deals sintéticos #25 e #26 foram mantidos como evidência e devem ser excluídos de indicadores reais; arquivar a campanha não os exclui automaticamente dos agregados.
Uma Tag classifica um registro; o Campaign° do Deal registra de qual campanha o lead veio. Uma tag com o nome de uma campanha não liga o Deal a ela.
| Work Item | Status |
|---|---|
| Complete the Seo for Agents campaign record in Core | Waiting |
| Exclude pilot records (Deals #25/#26, PILOT) from commercial reports | To Do |
| Explain Tag vs Campaign Participation and settle Campaign scope | Waiting |
| Set up campaign offers, targets and aggregations | To Do |
| Build connected e-mail and campaign sequences | To Do |
| Add structured commercial fields and indicators after the pilot | To Do |
| Add stage history, multitouch, Project Management and Interfaces | To Do |
Piloto 01 e homologação
A execução 01 do piloto ocorreu em 21/10/2026 com organizações fictícias e duas reservas controladas, ambas canceladas. Doze dos 17 casos passaram na amostra técnica. Cinco seguem bloqueados no aceite completo: P01 precisa de uma campanha real pronta, P05 de um atendimento real controlado, P15 de um segundo operador que identifique um bloqueio geral de contato, P16 de uma origem Cal.com sem mapeamento e P17 de uma conciliação reproduzida por um segundo operador. O piloto não gerou mudança de modelo. Em 28/10/2026 a homologação da v1 seguia pendente.
| Work Item | Status |
|---|---|
| Sign off CRM v1 manual operation (homologation) | Waiting |
| Complete Pedro’s reviewer check of pilot 01 records | To Do |
| Run controlled attendance and second-operator review (P05/P15/P17) | Waiting |
| Test CRM entry and update as a seller (Amanda/Daniel) | Waiting |
Acesso e regras de registro
Views com nome de empresa e filtros de calendário organizam o trabalho; não isolam registros entre vendedores. A unicidade de pessoas, empresas e negócios depende de busca antes da criação, não de uma chave no banco.
| Work Item | Status |
|---|---|
| Define record-level visibility policy and test it per seller role | Waiting |
| Define uniqueness keys, merge approval and critical-change history | To Do |
| Clean up data issues left from the Cal.com and CRM sessions | To Do |
| Settle who owns Deal: the domain model or the CRM | To Do |
| Add a direct Contact (Person) on Deal once Relationship has Contacts | To Do |
| Define partner participation and commission rules on Deals | Waiting |
O item sobre a posse do Deal trata da regra de que o cliente de uma empresa do grupo fica registrado no CRM, nunca como Organization Relationship no Core. Desde 04/11/2026 esse cliente é o cliente de um Deal Won.
Limites da documentação
O CRM tem 19 tabelas, 332 campos (em 04/11/2026), 70 Data views inventariadas e duas automações vazias do Airtable. O escopo operacional é Data views e intakes em grade. As Interfaces do Airtable e seus formulários ficam fora dos guias. Os guias descrevem filtros apenas das views de etapa do Deal e de Tasks e de três calendários de Interaction; abra qualquer outra view para confirmar o filtro. As capturas mostram views selecionadas de intake, checagem e consulta, não cada variante por empresa ou estado de falha. Antes de depender deles, confirme nos próprios sistemas os mapeamentos de sync exceto Campaign, as permissões da base, a configuração atual e a retenção de execuções do n8n e qualquer integração fora da pasta CRM no n8n.