Integração Cubo CRM com n8n

Este módulo permite integrar o Cubo Suite CRM ao N8N, utilizando chamadas diretas à API para criar e atualizar negociações dentro de workflows automatizados.

---

📦 Instalação do pacote npm

1. Navegue até o diretório de instalação do seu n8n.

2. Instale o pacote:

3. npm install n8n-nodes-cubo-suite-crm

4. Reinicie o n8n.

---

O nó Cubo CRM estará disponível para uso na interface.

Criando a ApiKey no Cubo CRM

1. Acesse o menu Configurações no Cubo CRM.

1. Vá até a seção Chave de API.

1. Clique em Gerar Nova ApiKey.

1. Dê um nome (ex: ApiKey n8n) e clique em salvar.

1. Copie a chave gerada para uso no n8n.

🔧 Configuração da Conexão no n8n

Vá até a aba Credentials no n8n.

Crie uma nova credencial com o tipo CRM Integration Account.

Cole a ApiKey copiada do Cubo CRM.

Salve com o nome claro, como Cubo CRM.

🔍 Coletando IDs Necessários 🔹 PipeId (ID do Funil) Acesse o funil desejado no Cubo CRM.

Na URL do funil, localize o valor numérico que aparece após a barra (/) e antes da palavra "pipes". Este é o PipeId.

🔹 Para obter o StageId (se desejar um estágio específico):

No funil escolhido, clique no icone de engrenagem e clique em editar estágio.

Verifique nas configurações do estágio para encontrar o valor numérico correspondente ao StageId (Número Indentificador (ID)) .

Anote esses valores, pois eles serão usados no módulo do N8N.

---

Definindo o Responsável pela Negociação (UserId)

Se você deseja atribuir a negociação a um usuário específico, será necessário informar o UserId. É fundamental garantir que o usuário selecionado tenha permissão para visualizar negociações no funil escolhido. Caso contrário, a criação da negociação falhará, retornando um erro informando que o usuário não está associado ao funil.

Para obter o UserId:

• No Cubo CRM, acesse o menu na seção de configurações, acesse usuários

• Localize o usuário desejado e verifique seu ID, que estará na coluna ID

Para verificar se o usuário está associado ao funil:

• Acesse as configurações do funil no Cubo CRM.

• Confira a lista de usuários permitidos para o funil em Configurações de funil.

• Certifique-se de que o usuário com o UserId escolhido está incluído. Se não estiver, adicione-o antes de prosseguir.

---

Configurando o Nó na N8N

Com todos os dados em mãos (ApiKey, PipeId, StageId e UserId), retorne ao N8N para configurar o módulo Create , se ainda não o fez:

• Insira a ApiKey criada no campo correspondente.

Preencha os campos do módulo com os dados coletados:

• PipeId: ID do funil onde a negociação será criada.

StageId (opcional): ID do estágio desejado, se aplicável.

UserId (opcional): ID do usuário responsável pela negociação.

Adicione outros dados relevantes, como nome do contato, e-mail ou informações adicionais, conforme necessário para a criação da negociação.

Os campos obrigatórios e opcionais estarão destacados no módulo. Certifique-se de mapear corretamente os valores que deseja enviar ao Cubo CRM

---

Adicionando Produtos à Negociação

O módulo Create permite incluir produtos na negociação. Para isso, você precisará do ID do produto registrado no Cubo CRM e da quantidade desejada.

No Nó da N8N:

• No campo de produtos, insira o ID do produto e a quantidade.

• Opcionalmente, você pode informar o preço total do produto. Se não informado, o Cubo CRM usará o preço registrado no sistema.

Para obter o ID do produto:

• No Cubo CRM, acesse o menu na seção Produtos.

• Localize o produto desejado e anote seu ID, que estará na coluna ID ou #.

Preenchendo o ID do produto obtido do Cubo CRM e a quantidade do produto de acordo com a necessidade.

Configurando Campos Personalizados

Para adicionar campos personalizados à negociação, siga estas etapas:

• No Nó da N8N, clique em Add Custom Fields na seção de Custom Fields.

No N8N, mapeie o ID do campo personalizado e insira o valor que deseja enviar.

Obtenha o ID do campo personalizado no Cubo CRM

• Acesse Configurações > Campos Personalizados

• Selecione o campo desejado e anote seu ID.

• Verifique se o campo está associado ao contexto correto (Negociações, não Organização ou Pessoas)

Considerações Finais para o Módulo Create

Após preencher todos os campos no módulo Create da N8N, revise cuidadosamente as configurações para garantir que os dados estejam corretos. Execute um teste do Workflow na N8N para confirmar que a negociação é criada com sucesso no Cubo CRM, incluindo produtos, campos personalizados e responsáveis devidamente atribuídos. Em caso de erros, verifique:

• A associação do usuário ao funil (UserId).

• A validade da ApiKey utilizada.

• A consistência dos IDs informados (PipeId, StageId, ProductId e campos personalizados).

Se tudo estiver configurado corretamente, a integração funcionará conforme esperado, criando negociações no Cubo CRM de forma automatizada. Configurando o Módulo Update na N8N

O módulo Update na N8N segue o mesmo funcionamento do módulo Create mas com somente o ID da Negociação* como obrigatório.