Criar cliente e projeto no Operand quando um lead é ganho no RD Station CRM

Integração com n8n: lead ganho no RD Station CRM vira cliente, projeto, jobs e tarefas no Operand, com aviso no Google Chat.

🚀

Com o n8n, um lead marcado como GANHO no RD Station CRM vira cliente no Operand automaticamente, já com um projeto de onboarding, jobs e tarefas. No fim, a equipe recebe um aviso no Google Chat com o link do projeto.

Baixe aqui o arquivo pronto com o fluxo descrito abaixo

O que o fluxo faz em cada situação

SituaçãoResultado
Etapa do funil diferente de GANHONada é feito
Falha ao criar o clienteExecução para com erro
Falha ao criar o projetoExecução para com erro (o cliente já foi criado)
Falha em algum job ou tarefaOs demais são criados; a execução termina com erro listando o que falhou, sem aviso no Chat
Tudo criadoMensagem com o link do projeto no Google Chat

Estrutura criada por padrão

Editável no campo jobs do nó Config.

JobPrazoTarefas
Reunião de kickoff3 dias úteisAgendar a reunião · Preparar pauta e material · Conduzir a reunião · Registrar decisões e enviar resumo
Configuração de acessos e cadastro5 dias úteisCadastrar no sistema financeiro/operacional · Criar acessos às ferramentas · Enviar credenciais e orientações · Confirmar que os acessos funcionam
Primeira entrega/planejamento inicial15 dias úteisElaborar e apresentar plano inicial

O que você aprenderá

  • Como o fluxo funciona
  • Como instalar e conectar RD Station CRM, n8n, Operand e Google Chat
  • Como personalizar o projeto padrão
  • Como testar e evitar problemas comuns

Como funciona o fluxo

O fluxo filtra o lead logo no início e só chama a API do Operand quando a etapa é GANHO.

flowchart TD
  A[Webhook RD Station CRM] --> B{É lead ganho?}
  B -- Não --> Z[Fim, nada é criado]
  B -- Sim --> C[Formatar dados do lead] --> D[Config]
  D --> E[Criar cliente]
  E -- 401 --> F[Login e salvar token] --> E
  E -- Sucesso --> G[Criar projeto]
  G --> H[Criar jobs] --> I[Criar tarefas]
  I --> J{Tudo criado?}
  J -- Sim --> K[Aviso no Google Chat]
  J -- Não --> L[Erro com a lista do que falhou]

Gatilho

Webhook POST na URL de produção, cadastrada no RD Station CRM:

https://SEU-N8N/webhook/operand-criar-projeto-cliente-quando-lead-ganho-rd

O webhook responde 200 assim que recebe a requisição. Erros posteriores aparecem só na aba Executions do n8n.

Campos lidos de body.leads[0].last_conversion.content:

CampoUso
funnel_stageFiltro: só segue se for GANHO
company_nameNome do cliente (empresa)
NomeNome do contato (descrição do projeto)
email_leadE-mail do cliente e do contato
phone_leadTelefone do cliente; enviado só com dígitos (DDD + número). Se vier vazio, não é enviado

Etapas

  1. Webhook recebe o lead do RD Station CRM.
  2. É lead ganho? só segue se funnel_stage for GANHO.
  3. Formatar dados do lead extrai empresa, nome, e-mail e telefone.
  4. Config reúne os parâmetros do fluxo.
  5. Ler Token Cache e Criar Cliente na API Operand cadastram a empresa com o token salvo.
  6. Resposta da API decide o próximo passo:
    • HTTP 401 (token inválido ou expirado): Login Operand, Salvar Token Cache e nova tentativa, uma única vez por execução.
    • Cliente criado (meta.status = SUCCESS): segue.
    • Outra resposta: para em Houve um erro ao criar o cliente na API!
  7. Criar projeto na API Operand cria o projeto com título, descrição e dados de contato. O projeto foi criado? confere meta.status = SUCCESS.
  8. Montar jobs calcula os prazos em dias úteis (segunda a sexta, sem feriados) e Criar job na API Operand cria os jobs.
  9. Montar tarefas e Criar tarefa na API Operand criam as tarefas dos jobs criados com sucesso.
  10. Jobs e tarefas foram criados? confere todas as respostas:
    • Sim: Ler URL do Google Chat busca a URL e, se existir, Enviar para Google Chat manda o link do projeto. Se não existir, para em URL do Google Chat não configurada!
    • Não: para em Houve um erro ao criar jobs ou tarefas na API!, com a lista do que falhou.

Endpoints usados

OperaçãoEndpoint
Abrir uma sessãoGET /v1/login
Criar um clientePOST /v1/entity/clients
Criar um projetoPOST /v1/projects
Criar um jobPOST /v1/jobs
Criar uma subtarefaPOST /v1/tasks

Instalação

Antes de começar

ItemPara que serve
Instância do n8n publicadaReceber o webhook do RD Station CRM
Arquivo .json do fluxoImportar o fluxo pronto
Token de acesso da API do OperandCriar cliente, projeto, jobs e tarefas
Acesso às integrações do RD Station CRMCadastrar o webhook
Webhook de um espaço do Google ChatReceber o aviso de novo projeto
IDs de usuários e status no OperandDefinir responsáveis e status iniciais
📘

Os IDs de usuários e status podem ser consultados pela própria API, em Listar usuários internos da conta e Listar status de um tipo de documento.

Checklist

  • Importar o arquivo .json do fluxo
  • Criar ou reutilizar a credential [OPERAND] API token e selecioná-la no nó Login Operand
  • Criar a data table OPERAND API (se ainda não existir) com a linha google_chat_lead_ganho
  • Selecionar a data table nos 3 nós que a utilizam
  • Revisar o nó Config, principalmente IDs de responsável e status e o campo jobs
  • Ativar o fluxo
  • Cadastrar a URL do webhook no RD Station CRM
  • Rodar os testes sugeridos

1. Credential

CredentialTipoUsada no nóPreenchimento
[OPERAND] API tokenQuery AuthLogin OperandName: tokenAccess · Value: token de acesso da API do Operand

É a mesma credential dos outros fluxos do Operand. Se já existir na instância, basta selecioná-la.

2. Data table OPERAND API

Tabela chave e valor, compartilhada com os demais fluxos do Operand. Colunas: key e value (string).

keyvalueQuem preenche
operand_api_tokenToken de sessão da APIO próprio fluxo
google_chat_lead_ganhoURL do webhook do espaço que recebe os avisosVocê

No Google Chat, a URL fica em Apps e integrações > Webhooks > Adicionar webhook.

Depois de importar, selecione OPERAND API no campo Data table destes nós:

  • Ler URL do Google Chat
  • Ler Token Cache
  • Salvar Token Cache

3. Webhook no RD Station CRM

Com o fluxo ativo, cadastre a URL de produção na integração de webhooks do RD Station CRM, no evento disparado quando o lead muda de etapa do funil.

O fluxo espera os campos company_name, Nome, email_lead e phone_lead. Se a conta usar outros identificadores, ajuste o nó Formatar dados do lead.

Configurações (nó Config)

Todo o projeto padrão é definido no nó Config. Para mudar o que é criado, edite só esse nó.

CampoUsoValor padrão
apiUrlEndereço da API do Operandhttps://api.operand.app/v1
appUrlBase do link do projeto (/projetos/)https://app4.operand.com.br
projetoTituloTítulo do projetoOnboarding de Novo Cliente
projetoDescricaoTexto inicial da descrição (aceita HTML); o fluxo acrescenta contato, e-mail e celularTexto de onboarding
jobResponsibleIdID do usuário responsável pelos jobs1102963
jobStatusIdID do status inicial dos jobs0
tarefaResponsibleIdID do usuário responsável pelas tarefas0
tarefaStatusIdID do status inicial das tarefas0
googleChatChavekey da data table com a URL do Google Chatgoogle_chat_lead_ganho
jobsJobs e tarefas do projetoVer abaixo
⚠️

Os IDs de responsável e status pertencem à conta Operand de cada agência. Revise todos na instalação.

Campo jobs

Cada item é um job com titulo, descricao, prazoDiasUteis (a partir do dia da execução) e tarefas (lista de títulos). Exemplo com o primeiro job:

[
  {
    "titulo": "Reunião de kickoff",
    "descricao": "Apresentar o time, alinhar escopo contratado, expectativas de prazos e canais de comunicação com o cliente",
    "prazoDiasUteis": 3,
    "tarefas": [
      "Agendar a reunião com o cliente",
      "Preparar pauta e material de apresentação do time",
      "Conduzir a reunião",
      "Registrar decisões e enviar resumo"
    ]
  }
]

Para incluir ou remover jobs e tarefas, edite a lista. Não é preciso criar nós. Deve haver pelo menos uma tarefa no total, senão a execução para em Montar tarefas.

⚠️

Ao importar uma nova versão do fluxo, o nó Config volta aos valores do arquivo. Anote suas alterações, inclusive o campo jobs. A URL do Google Chat e o token ficam na data table e não são afetados.

Usar Slack, Discord ou outra ferramenta

Troque a URL na data table e ajuste o corpo JSON do nó Enviar para Google Chat ao formato da nova ferramenta (por exemplo, text no Slack e content no Discord).

Testes e pontos de atenção

Testes sugeridos

Com o fluxo ativo, enviando pela URL de produção:

CenárioResultado esperado
Lead com etapa diferente de GANHOExecução termina em É lead ganho? e nada é criado
Lead ganho com telefoneCliente com telefone, projeto com 3 jobs e 9 tarefas, mensagem no Chat
Lead ganho sem telefoneCliente sem o campo phone; descrição mostra Celular: -
Token em cache apagado ou inválidoLogin automático e linha operand_api_token atualizada
jobResponsibleId inválidoErro em Montar tarefas, sem aviso no Chat

Pontos de atenção

  • Sem autenticação no webhook: qualquer requisição no formato esperado com funnel_stage = GANHO cria cliente e projeto. Não divulgue a URL fora da equipe.
  • Sem deduplicação: se o RD Station CRM enviar o mesmo lead ganho mais de uma vez, cliente e projeto são criados de novo. Evite mover o lead para fora e de volta para GANHO.
  • Prazos: contam só dias úteis de segunda a sexta, sem considerar feriados.
  • Considerações da venda: a descrição termina com o texto fixo Considerações da venda: [Considerações da venda], que ainda não vem de nenhum campo do RD. Preencha manualmente no projeto.
  • Primeira execução: sem token em cache, o fluxo faz login e cria a linha operand_api_token.

Respostas que o fluxo espera da API

ChamadaSucessoOnde o fluxo lê o resultado
LoginHTTP 200Token no campo Op-Auth-Token
ClienteHTTP 200, meta.status = SUCCESSID em records.idPerson (o fluxo envia o header customResponse: recordCreated para receber o registro criado)
ProjetoHTTP 201, meta.status = SUCCESSProjeto em records (id e title)
Job e tarefaHTTP 201, meta.status = SUCCESSJob em records[0].id

Token ausente, inválido ou expirado responde HTTP 401 em qualquer rota.

Erros comuns

SintomaCausa provávelComo resolver
Nenhuma execução no n8nFluxo inativo ou URL de teste cadastrada no RDAtive o fluxo e use a URL de produção
Execução para em É lead ganho? com lead ganhoNome da etapa diferente de GANHOConfira o nome exato da etapa no funil
Cliente sem nome ou e-mailIdentificadores de campo diferentes no RDAjuste Formatar dados do lead
HTTP 400 ao criar o clienteTelefone fora do formato (11 dígitos com DDD) ou campo obrigatório ausenteConfira Formatar dados do lead e o corpo do nó Criar Cliente
URL do Google Chat não configurada!Linha ausente na data tableCrie a linha com a key de googleChatChave
Erro em jobs ou tarefasIDs de responsável ou status inválidosRevise os IDs no nó Config

Did this page help you?