Aplicativo Cubo CRM de integração no Make

Instalação do Módulo Cubo CRM no Make

Para começar, é necessário instalar o módulo do Cubo CRM no Make. Na construção de cenários, busque pelo módulo Cubo CRM na biblioteca de aplicativos do Make.

Após encontrar o módulo, selecione a opção Create a Negotiation para criar uma negociação. Em seguida, será necessário configurar a conexão com o Cubo CRM.

Configuração da Conexão no Make

Para configurar a conexão, você precisará nomeá-la e inserir uma ApiKey, que será gerada diretamente no Cubo CRM.

• No Make, nomeie a conexão de forma clara (ex.: "Conexão Cubo CRM").

• Acesse o Cubo CRM para criar a ApiKey. Siga o passo a passo abaixo para gerá-la e utilizá-la no Make.

Criação da ApiKey no Cubo CRM

No Cubo CRM, siga estas etapas para criar a ApiKey:

• Acesse as Configurações no menu do Cubo CRM.

• Vá para a seção Chave de API.

• Clique em Gerar Nova ApiKey

• Dê um nome à chave (ex.: "ApiKey Make") e salve.

• Copie a ApiKey gerada e retorne ao Make para inseri-la no campo correspondente da conexão.

Após inserir a ApiKey no Make, salve a configuração para estabelecer a conexão.

---

Obtendo PipeId e StageId

Com a conexão configurada, você precisará coletar os dados necessários, como o PipeId e o StageId. O PipeId é obrigatório, enquanto o StageId é opcional e será usado apenas se você quiser que a negociação seja criada em um estágio específico do funil, em vez do estágio inicial.

Para obter o PipeId:

1. No Cubo CRM, acesse o funil onde deseja criar as negociações.

2. 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 Make.

---

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 Módulo no Make

Com todos os dados em mãos (ApiKey, PipeId, StageId e UserId), retorne ao Make para configurar o módulo Create a Negotiation, 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 a Negotiation permite incluir produtos na negociação. Para isso, você precisará do ID do produto registrado no Cubo CRM e da quantidade desejada.

No módulo do Make:

• 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 módulo do Make, clique em Add Item na seção de campos personalizados.

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

Importante: Por padrão, os campos personalizados não são obrigatórios no Cubo. No entanto, ao enviar o ID do campo, o valor (value) se torna obrigatório. Se algum campo personalizado puder chegar sem valor em determinado momento, recomendamos que você utilize uma condição simples (ex: ifempty(;) ), como no exemplo abaixo. Essa verificação checa se existe um valor no mapeamento; caso não exista, preenche com um texto à sua escolha. Nossa orientação é utilizar: "Não informado".

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 a Negotiation

Após preencher todos os campos no módulo Create a Negotiation do Make, revise cuidadosamente as configurações para garantir que os dados estejam corretos. Execute um teste do cenário no Make 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 a Negotiation no Make

O módulo Update a Negotiation no Make segue o mesmo funcionamento do módulo Create a Negotiation, mas com somente o ID da Negociação* como obrigatório.

No módulo "Make API Call"

Esse é um módulo aberto, que permite realizar qualquer requisição conforme a documentação oficial da API.

• Os métodos GET são usados para consultas — seja para obter todos os registros ou buscar por um ID específico.

• O método POST deve ser utilizado para criar dados e precisa receber o corpo (body) da requisição em formato JSON, conforme especificado na documentação

No módulo "Make API Call" – Método DELETE

O método DELETE está disponível e é extremamente importante. No entanto, seu uso exige muita atenção, pois ele é responsável por excluir dados diretamente no CRM.

Como esse é um módulo aberto, o método DELETE pode ser utilizado em qualquer rota disponível na documentação da API.

Por segurança, o método DELETE só funcionará se o responsável pela construção do fluxo na Make marcar a opção de confirmação, indicando que está ciente de que essa ação de exclusão é irreversível.

Recomendamos cautela ao utilizar esse método, especialmente em ambientes de produção, para evitar perdas de dados não intencionais.