# 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](https://api.cubosuite.com.br/).
* 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](https://api.cubosuite.com.br/).
**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.
