BotConversa e Cubo CRM

Este guia foi elaborado para auxiliar usuários na integração do Cubo Suíte CRM com o automatizador BotConversa, permitindo a criação e atualização automáticas de contatos e negociações.

Integrando o Cubo CRM com BotConversa

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.

Passo a Passo:

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

a. Chave de API:

Acesse "Meu perfil > API" e copie a chave.

b. Identificador do Funil e do Estágio:

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

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.

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.

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:

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}"
}

Mapeie a resposta para capturar o campo ID da resposta do Cubo e atribuir ao campo "CuboID" no BotConversa.

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:

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.

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).
}

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