Legacy — Email Logging

O Email Logging guarda o registro dos e-mails com clientes. Cada mensagem de uma caixa do Gmail, recebida ou enviada, vira uma Message no Communication. Quando a outra pessoa tem um Relationship aberto no CRM, a thread inteira também vira uma Interaction nesse Relationship, e a data de follow-up anda: responder hoje quando a pessoa escreveu, conferir de novo em três dias depois da primeira mensagem que você mandou. E-mail entre endereços internos e de remetentes automáticos é ignorado. O workflow nunca cria uma pessoa.

O workflow está inativo. Ele nunca foi publicado no n8n, então nada desta página está rodando ainda. Antes de ativar lista o que precisa estar pronto antes. Uma cópia do workflow atende uma caixa de e-mail.

Substituído. Em 06/11/2026 este desenho foi substituído pelo Email Capture e seus dois sub-workflows, que leem uma caixa de captura só (non-reply@snackprompt.com), alimentada pelo roteamento do Google Workspace, em vez de uma credencial do Gmail por vendedor, e gravam Deals em vez de Relationships. Este workflow continua salvo e inativo no n8n; esta página descreve ele como está salvo, com os passos de Relationship, e será removida quando o workflow for apagado.

O maintainer do Communication cuida das Messages e da configuração da caixa; o maintainer do CRM cuida das Interactions e das regras de follow-up.

Fluxo

Gerado da versão do n8n do quadro acima: cada caixa é um nó e cada seta é uma ligação no n8n. Pílulas rosa são gatilhos, hexágonos amarelos são nós If e Switch com as saídas nas setas, cilindros azuis leem (Airtable, Data Table, HTTP GET), cilindros verdes gravam, caixas roxas chamam outro workflow e setas tracejadas são saídas de erro.

flowchart TD
  subgraph g0["Ler a caixa de e-mail"]
    n13(["Gmail Trigger"]):::trigger
    n0["Config"]:::logic
    n17["Normalize"]:::logic
  end
  subgraph g1["Resolver o contexto"]
    n6[("Find Mailbox Account<br/><small>GET Tooling Tool Account</small>")]:::read
    n20["Resolve Seller"]:::logic
    n8[("Find Membership (CRM)<br/><small>GET CRM Membership</small>")]:::read
    n7[("Find Membership (Communication)<br/><small>GET Communication Membership</small>")]:::read
    n4[("Find Channel<br/><small>GET Communication Channel</small>")]:::read
    n11[("Find Person (CRM)<br/><small>GET CRM People</small>")]:::read
    n19["Resolve Person"]:::logic
    n10[("Find Person (Communication)<br/><small>GET Communication Person</small>")]:::read
    n9[("Find Message<br/><small>GET Communication Message</small>")]:::read
    n5[("Find Interaction<br/><small>GET CRM Interaction</small>")]:::read
    n12[("Find Relationships<br/><small>GET CRM Relationship</small>")]:::read
    n18["Prepare"]:::logic
  end
  subgraph g2["Message do Communication"]
    n16{{"Message Exists?"}}:::decision
    n22[("Update Message<br/><small>PATCH Communication Message</small>")]:::write
    n3[("Create Message<br/><small>POST Communication Message</small>")]:::write
    n1["Continue"]:::logic
  end
  subgraph g3["Interaction do CRM"]
    n14{{"Has Relationship?"}}:::decision
    n15{{"Interaction Exists?"}}:::decision
    n21[("Update Interaction<br/><small>PATCH CRM Interaction</small>")]:::write
    n2[("Create Interaction<br/><small>POST CRM Interaction</small>")]:::write
  end
  n13 --> n0
  n0 --> n17
  n17 --> n6
  n6 --> n20
  n20 --> n8
  n8 --> n7
  n7 --> n4
  n4 --> n11
  n11 --> n19
  n19 --> n10
  n10 --> n9
  n9 --> n5
  n5 --> n12
  n12 --> n18
  n18 --> n16
  n16 -->|sim| n22
  n16 -->|não| n3
  n22 --> n1
  n3 --> n1
  n1 --> n14
  n14 -->|sim| n15
  n15 -->|sim| n21
  n15 -->|não| n2
  classDef trigger fill:#fde7f3,stroke:#d6409f,color:#111
  classDef decision fill:#fff7e0,stroke:#c99a00,color:#111
  classDef read fill:#e8f1ff,stroke:#3b82f6,color:#111
  classDef write fill:#e7f8ee,stroke:#16a34a,color:#111
  classDef subflow fill:#f3e8ff,stroke:#9333ea,color:#111
  classDef wait fill:#f1f1f1,stroke:#888,color:#111
  classDef logic fill:#ffffff,stroke:#999,color:#111

Sistemas que ele toca

Toda chamada ao Airtable é um nó HTTP Request com uma credencial de token do Airtable. As leituras filtram pelo nome do campo: {Login Alias} e {Tool} em Tool Account, {Membership #} no mirror Membership do CRM, {Membership ID} no mirror Membership do Communication, {External Identifier} em Channel, {Email} nos dois mirrors de pessoas, {External Message Id} em Message e {Evidence URL} em Interaction. As gravações usam IDs de campo. Renomear um desses campos quebra a busca sem erro: o nó não devolve registro e o fluxo segue como se nada tivesse sido encontrado.

As páginas dos sistemas descrevem os registros que este workflow preenche: Communication, CRM e Tooling and Access, onde ficam a Tool Account da caixa e o vínculo dela com a membership.

Gatilho e caixa de e-mail

O Gmail Trigger consulta a caixa da sua credencial do Gmail a cada minuto com a busca in:inbox OR in:sent, lidas e não lidas, e devolve as mensagens completas (não o formato simplificado). Cada mensagem nova é um item.

O Config define dois valores que todos os nós seguintes leem: mailbox, o endereço da caixa desta cópia, e internalDomains, a lista separada por vírgulas dos domínios de e-mail da própria empresa. A caixa do Config precisa ser a mesma da credencial do Gmail; nada confere se elas batem.

O que o Normalize mantém

O Normalize transforma cada mensagem em um item e descarta as que não são contato com cliente.

Quando todas as mensagens de uma consulta são descartadas, a execução termina no Normalize.

Resolver o contexto

Cada mensagem mantida faz nove buscas em sequência, uma chamada HTTP cada.

1. Conta da caixa. O Find Mailbox Account procura no Tooling a Tool Account cujo Login Alias é a caixa e cujo Tool contém Google Workspace. O Resolve Seller lê o Bound Membership ID dela.
2. Memberships. O Find Membership (CRM) procura a Membership do CRM cujo Membership # começa com esse número seguido de “ - “. A Business Unit dela vira a empresa responsável. O Find Membership (Communication) procura a Membership do Communication com esse Membership ID. Sem Bound Membership ID, as duas buscas não acham nada.
3. Canal. O Find Channel procura o Channel do Communication cujo External Identifier é a caixa.
4. Pessoas. O Find Person (CRM) procura o e-mail da contraparte no mirror People do CRM e o Resolve Person junta os Relationships ligados a ela. O Find Person (Communication) procura o mesmo e-mail no mirror Person do Communication.
5. Registros existentes. O Find Message procura uma Message cujo External Message Id é o id do Gmail. O Find Interaction procura uma Interaction cuja Evidence URL é o link da thread.
6. Relationship. O Find Relationships lê os Relationships da pessoa. O Prepare fica com os que não estão em Stage* Lost ou Disqualified e pega o primeiro cujo Accountable (Company)* contém a empresa responsável, depois o primeiro cujo Accountable (Membership)* contém a membership, depois o primeiro aberto.

O Prepare então monta os dois registros e adiciona uma nota quando algo falta: nenhuma Tool Account para a caixa, nenhuma membership, a contraparte fora do mirror People do CRM, ou nenhum Relationship aberto. As notas vão para o Failure Reason da Message.

Gravar a Message

O Message Exists? manda o item para o Update Message quando o Find Message achou uma, e para o Create Message nos outros casos. Os dois mandam os mesmos campos, então processar uma mensagem de novo sobrescreve a Message com os mesmos valores. O Continue então passa o item preparado para a parte do CRM.

A Message é gravada mesmo quando faltam a pessoa ou o Relationship; é o único registro que uma mensagem dessas ganha.

Gravar a Interaction

O Has Relationship? para o item se o Prepare não achou Relationship aberto. O Interaction Exists? então manda para o Update Interaction quando uma Interaction já tem este link de thread, e para o Create Interaction nos outros casos. Uma thread é uma Interaction: o Date* e o Result dela seguem a última mensagem processada.

“Hoje” é a data UTC no momento do processamento.

Campos gravados

Message do Communication (Create Message e Update Message)

Interaction do CRM

Na tabela Interaction, o campo chamado Person era o link para Relationship; ele foi apagado com essa tabela em 04/11/2026. Toda gravação manda typecast: true: um valor de select que ainda não existe é criado como opção nova. O Status de Message não tem a opção Received hoje, então a primeira mensagem inbound a cria.

Nós

O workflow tem 24 nós: 23 que executam e uma nota adesiva. Num nó If, a saída 0 é verdadeiro e a saída 1 é falso.

Ligações

Configurações e tratamento de erro

O agendamento é a consulta do Gmail Trigger, a cada minuto. Uma chamada que ainda falha depois de três tentativas para a execução; os itens já gravados nessa execução continuam gravados.

Antes de ativar

Confira cada item nos sistemas e depois publique o workflow no n8n.

Lacunas conhecidas

O workflow nunca rodou. Estas vêm da configuração dos nós.

Recuperar uma gravação parcial

Veja o que foi salvo antes de processar uma mensagem de novo.

Manter esta página em dia

O quadro no topo mostra a versão do n8n que esta página descreve. Abra o workflow no n8n: quando o último salvamento dele é mais novo que a data do quadro, esta página está desatualizada até a próxima revisão. Todos os nós e todas as ligações dessa versão estão em Nós e Ligações.