Aplicativo Cubo CRM de integração no Make
Last updated
Last updated
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.
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.
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.
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.
No Cubo CRM, acesse o funil onde deseja criar as negociações.
Na URL do funil, localize o valor numérico que aparece após a barra (/) e antes da palavra "pipes". Este é o PipeId.
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)) .
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.
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
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.
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.
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
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.
No Cubo CRM, acesse o menu na seção Produtos.
Localize o produto desejado e anote seu ID, que estará na coluna ID ou #.
No módulo do Make, clique em Add Item na seção de campos personalizados.
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".
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.
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.
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.
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.
Esse é um módulo aberto, que permite realizar qualquer requisição conforme a .
Como esse é um módulo aberto, o método DELETE pode ser utilizado em qualquer rota disponível na .
