> For the complete documentation index, see [llms.txt](https://centraldeajuda.cubosuite.com.br/playbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://centraldeajuda.cubosuite.com.br/playbook/aplicativo-cubo-crm-de-integracao-no-make.md).

# Aplicativo Cubo CRM de integração no Make

<br>

### **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.

<figure><img src="/files/MCzxEd4ynLTBSilaKBLS" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/4rMtkcxT1afrHmDZApuu" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="/files/DGGZmsVBowUyNVHFO45L" alt=""><figcaption></figcaption></figure>

### **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.

<figure><img src="/files/tYLsytUMpfsJfRx47lu6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uHBot4isOmylgXGkKFY8" alt=""><figcaption></figcaption></figure>

* Clique em Gerar Nova ApiKey

<figure><img src="/files/qirNEQk66QYCsmnW0Te0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/8FGYQ6QBZDTPNEiT2O8v" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/AXN1rfMl2EFyzYtQ5MYo" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/huqniPin5iE5mgeK5Dm2" alt=""><figcaption></figcaption></figure>

***

**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.

<figure><img src="/files/6aClHp7wwsq8I4GlJvNp" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="/files/NRlT9b5A01deFTv4BQoS" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/CulSUgueivg0ngDyeRVV" alt=""><figcaption></figcaption></figure>

#### 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.<br>

#### Para obter o **UserId**:

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

<figure><img src="/files/Jr5TFCaGCeajBRyO3hwW" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/WIZ2mf4p607rYKJCcsgU" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/rPim9ZNQ6y09d2XQxGMs" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/40Q7nH6zsGQb8AfCgerL" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/AHCr55ojqfa1wgUk6GeX" alt=""><figcaption></figcaption></figure>

***

### **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.

<figure><img src="/files/vP48YMeVcZdLigEqUgo3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/GFf07w4VG5oETrY5rxAD" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/5f11xW02KoAQpTS47mnE" alt=""><figcaption></figcaption></figure>

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

<mark style="color:red;">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</mark>

***

**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.

<figure><img src="/files/2J6Bsp94ooXNXDCZXkGs" alt=""><figcaption></figcaption></figure>

#### Para obter o **ID do produto**:

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

<figure><img src="/files/y9Fyiiw6H9QL3Rdpg2eD" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/E0vo7FUdY35V471yeAtR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/hIhXqgfjfYRTvA8Q37bn" alt=""><figcaption></figcaption></figure>

#### **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.

<figure><img src="/files/aauW00p7XpeZ3aP6yNWi" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/t7M3M0jijVca3OcMrdsZ" alt=""><figcaption></figcaption></figure>

<mark style="color:red;">**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.**</mark>\ <mark style="color:red;">**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.**</mark>\ <mark style="color:red;">**Nossa orientação é utilizar: "Não informado".**</mark>

<figure><img src="/files/k1D3hr6PwsJKmjdFdSHM" alt=""><figcaption></figcaption></figure>

#### Obtenha o ID do campo personalizado no Cubo CRM

* Acesse Configurações > Campos Personalizados

<figure><img src="/files/LkAj6JGQ3Sk8im5QCIml" alt=""><figcaption></figcaption></figure>

* 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)

<figure><img src="/files/aJDdKRWfO9kT1zed7vFH" alt=""><figcaption></figcaption></figure>

**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.\
\
\ <br>

## **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.

<figure><img src="/files/jMLnlqps1PTbvkOwtxuA" alt=""><figcaption></figcaption></figure>

### 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

<figure><img src="/files/FbVHvJlZUaiRDYwM4vaV" alt=""><figcaption></figcaption></figure>

**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**.

<figure><img src="/files/D3xwEmxYuBjQiA2XBr7W" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/mNznac19SHAsFbyofJ4I" alt=""><figcaption></figcaption></figure>