# BotConversa e Cubo CRM

{% embed url="<https://youtu.be/1iobMby8z6s>" %}
Integrando o Cubo CRM com BotConversa
{% endembed %}

### Pré-Requisitos:

\- Contas ativas no Cubo Suíte CRM e BotConversa.\
\- Chave de API do Cubo Suíte.\
\- Identificador do funil e do estágio no Cubo Suíte.\
\- Campo personalizado "CuboID" criado no BotConversa.

&#x20;

### Passo a Passo:

### 1. Localizando Dados Necessários no Cubo Suíte:

a. Chave de API:

Acesse "Meu perfil > API" e copie a chave.\
![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=mcm80oeiyoc0m9kgtvkq30r6d8jfhdx7)

&#x20;

b. Identificador do Funil e do Estágio:

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=f61g7x410kli0cnmbt4q6exu4rnxesim)

No funil específico, copie o número da URL; este é o ID do seu funil.

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=serfs1ywsl8mwryqzy1p3zdlkz6bbewu)![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=vchsdxip5j1jxbwoz38y9myu46ha9eob)\
Para o ID do estágio, clique no ícone de engrenagem ao lado do nome do estágio e selecione "Ações > Editar estágio". O identificador está disponível no primeiro campo do modal.

&#x20;

### 2. Configuração no BotConversa:

Ao iniciar um fluxo, crie uma caixa de CONDICIONAL, verificando se o campo "CuboID" está preenchido. Se sim, o contato já possui uma negociação no Cubo; se não, é um novo contato e deve ser enviado para o CRM.

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=l6scif4umzzgkxhk3z387ov6qq3619rb)

Para criar um contato e sua respectiva negociação no Cubo, ligue a caixa de condicional à uma caixa do tipo INTEGRAÇÃO - WEBHOOK.

Configure a requisição de criação na API do Cubo Suíte como abaixo:

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=sora8ijxjvb7znn12mqa6px7p38ru2i1)

Método: POST

URL: <https://api.cubosuite.com.br/webhook/botconversa?apiKey=SUA\\_CHAVE\\&pipeId=ID\\_FUNIL\\&type=create>

Parâmetros:

```
{
"title": "{nome-completo}",
"peopleName": "{nome-completo}",
"peoplePhone": "{telefone}"
}
```

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=kbk8xpmf9nfjy6j35k1ssdpe3mct2em5)

**Mapeie a resposta para capturar o campo ID da resposta do Cubo e atribuir ao campo "CuboID" no BotConversa.**\
![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=u9pu56qtaemdeh6jtwr15ep811regfnb)

&#x20;

### 3. Atualizando uma Negociação no Cubo CRM:

Conecte a caixa anterior a uma caixa do tipo INTEGRAÇÃO - WEBHOOK para apontar a requisição de atualização na API do Cubo Suíte.\
Configure conforme abaixo:

![](https://cubosuite.ladesk.com/scripts/file.php?view=Y\&file=tc1lnnpk8rj8lwv46dkmhd70cgf0hbni)\
Método: POST

URL: <https://api.cubosuite.com.br/webhook/botconversa?apiKey=SUA\\_CHAVE\\&pipeId=ID\\_FUNIL\\&type=update>

Parâmetros:

```
{
"id": {CuboID},
"stageId": ID_ESTAGIO,
"customfield_IDENTIFICADOR": "Valor_personalizado"
}
```

**Lembre-se de que só o ID é obrigatório, mas você pode adicionar outros campos conforme necessário, como title, price, userId, peopleName, peoplePhone, organizationName, stageId, e rating.**

&#x20;

### 4. Entendendo os Parâmetros de Atualização:

```
{
title: Título da negociação.
price: Preço associado à negociação.
userId: Identificador do usuário no Cubo Suíte.
peopleName: Nome do contato.
peoplePhone: Telefone do contato.
organizationName: Nome da organização associada.
stageId: Identificador do estágio da negociação.
rating: Classificação da negociação (0-5).
}
```

&#x20;

### Conclusão:

Este artigo fornece instruções detalhadas para integrar o Cubo Suíte CRM com o BotConversa, facilitando a gestão de contatos e negociações. Lembre-se de seguir cada passo cuidadosamente para garantir uma integração bem-sucedida e eficiente entre as plataformas. Boa sorte e bons negócios! 🚀