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ção | Resultado |
|---|---|
| Etapa do funil diferente de GANHO | Nada é feito |
| Falha ao criar o cliente | Execução para com erro |
| Falha ao criar o projeto | Execução para com erro (o cliente já foi criado) |
| Falha em algum job ou tarefa | Os demais são criados; a execução termina com erro listando o que falhou, sem aviso no Chat |
| Tudo criado | Mensagem com o link do projeto no Google Chat |
Estrutura criada por padrão
Editável no campo jobs do nó Config.
| Job | Prazo | Tarefas |
|---|---|---|
| Reunião de kickoff | 3 dias úteis | Agendar a reunião · Preparar pauta e material · Conduzir a reunião · Registrar decisões e enviar resumo |
| Configuração de acessos e cadastro | 5 dias úteis | Cadastrar no sistema financeiro/operacional · Criar acessos às ferramentas · Enviar credenciais e orientações · Confirmar que os acessos funcionam |
| Primeira entrega/planejamento inicial | 15 dias úteis | Elaborar 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:
| Campo | Uso |
|---|---|
funnel_stage | Filtro: só segue se for GANHO |
company_name | Nome do cliente (empresa) |
Nome | Nome do contato (descrição do projeto) |
email_lead | E-mail do cliente e do contato |
phone_lead | Telefone do cliente; enviado só com dígitos (DDD + número). Se vier vazio, não é enviado |
Etapas
- Webhook recebe o lead do RD Station CRM.
- É lead ganho? só segue se
funnel_stagefor GANHO. - Formatar dados do lead extrai empresa, nome, e-mail e telefone.
- Config reúne os parâmetros do fluxo.
- Ler Token Cache e Criar Cliente na API Operand cadastram a empresa com o token salvo.
- 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!
- 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. - Montar jobs calcula os prazos em dias úteis (segunda a sexta, sem feriados) e Criar job na API Operand cria os jobs.
- Montar tarefas e Criar tarefa na API Operand criam as tarefas dos jobs criados com sucesso.
- 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ção | Endpoint |
|---|---|
| Abrir uma sessão | GET /v1/login |
| Criar um cliente | POST /v1/entity/clients |
| Criar um projeto | POST /v1/projects |
| Criar um job | POST /v1/jobs |
| Criar uma subtarefa | POST /v1/tasks |
Instalação
Antes de começar
| Item | Para que serve |
|---|---|
| Instância do n8n publicada | Receber o webhook do RD Station CRM |
Arquivo .json do fluxo | Importar o fluxo pronto |
| Token de acesso da API do Operand | Criar cliente, projeto, jobs e tarefas |
| Acesso às integrações do RD Station CRM | Cadastrar o webhook |
| Webhook de um espaço do Google Chat | Receber o aviso de novo projeto |
| IDs de usuários e status no Operand | Definir 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
.jsondo fluxo - Criar ou reutilizar a credential
[OPERAND] API tokene selecioná-la no nó Login Operand - Criar a data table
OPERAND API(se ainda não existir) com a linhagoogle_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
| Credential | Tipo | Usada no nó | Preenchimento |
|---|---|---|---|
[OPERAND] API token | Query Auth | Login Operand | Name: 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).
| key | value | Quem preenche |
|---|---|---|
operand_api_token | Token de sessão da API | O próprio fluxo |
google_chat_lead_ganho | URL do webhook do espaço que recebe os avisos | Você |
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ó.
| Campo | Uso | Valor padrão |
|---|---|---|
apiUrl | Endereço da API do Operand | https://api.operand.app/v1 |
appUrl | Base do link do projeto (/projetos/) | https://app4.operand.com.br |
projetoTitulo | Título do projeto | Onboarding de Novo Cliente |
projetoDescricao | Texto inicial da descrição (aceita HTML); o fluxo acrescenta contato, e-mail e celular | Texto de onboarding |
jobResponsibleId | ID do usuário responsável pelos jobs | 1102963 |
jobStatusId | ID do status inicial dos jobs | 0 |
tarefaResponsibleId | ID do usuário responsável pelas tarefas | 0 |
tarefaStatusId | ID do status inicial das tarefas | 0 |
googleChatChave | key da data table com a URL do Google Chat | google_chat_lead_ganho |
jobs | Jobs e tarefas do projeto | Ver 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ário | Resultado esperado |
|---|---|
| Lead com etapa diferente de GANHO | Execução termina em É lead ganho? e nada é criado |
| Lead ganho com telefone | Cliente com telefone, projeto com 3 jobs e 9 tarefas, mensagem no Chat |
| Lead ganho sem telefone | Cliente sem o campo phone; descrição mostra Celular: - |
| Token em cache apagado ou inválido | Login automático e linha operand_api_token atualizada |
jobResponsibleId inválido | Erro 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 = GANHOcria 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
| Chamada | Sucesso | Onde o fluxo lê o resultado |
|---|---|---|
| Login | HTTP 200 | Token no campo Op-Auth-Token |
| Cliente | HTTP 200, meta.status = SUCCESS | ID em records.idPerson (o fluxo envia o header customResponse: recordCreated para receber o registro criado) |
| Projeto | HTTP 201, meta.status = SUCCESS | Projeto em records (id e title) |
| Job e tarefa | HTTP 201, meta.status = SUCCESS | Job em records[0].id |
Token ausente, inválido ou expirado responde HTTP 401 em qualquer rota.
Erros comuns
| Sintoma | Causa provável | Como resolver |
|---|---|---|
| Nenhuma execução no n8n | Fluxo inativo ou URL de teste cadastrada no RD | Ative o fluxo e use a URL de produção |
| Execução para em É lead ganho? com lead ganho | Nome da etapa diferente de GANHO | Confira o nome exato da etapa no funil |
| Cliente sem nome ou e-mail | Identificadores de campo diferentes no RD | Ajuste Formatar dados do lead |
| HTTP 400 ao criar o cliente | Telefone fora do formato (11 dígitos com DDD) ou campo obrigatório ausente | Confira Formatar dados do lead e o corpo do nó Criar Cliente |
| URL do Google Chat não configurada! | Linha ausente na data table | Crie a linha com a key de googleChatChave |
| Erro em jobs ou tarefas | IDs de responsável ou status inválidos | Revise os IDs no nó Config |
Updated 25 days ago

