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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://centraldeajuda.cubosuite.com.br/playbook/integracoes-1/botconversa-e-cubo-crm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.