# Plugin Cubo CRM Para WordPress

## Introdução

O plugin **Cubo CRM** permite integrar formulários do WordPress (especificamente do Contact Form 7) com o Cubo CRM, possibilitando a criação e atualização de negociações (deals) de forma automatizada. Este manual guia você passo a passo para configurar e usar o plugin no painel administrativo do WordPress, incluindo a integração com formulários, configuração de SMTP, visualização de relatórios e gerenciamento de envios com erro.

***

{% file src="/files/219yUslOdTvNbsvjAyUl" %}

## 1. Instalação e Ativação do Plugin

* **Baixe o Plugin**
  * Faça o download do plugin Cubo CRM, clicando no ZIP acima ou instale-o diretamente pelo repositório de plugins do WordPress.
* **Instale o Plugin**
  * No painel administrativo do WordPress, vá até **Plugins > Adicionar Novo**.
  * Clique em **Fazer Upload do Plugin**, selecione o arquivo ZIP do Cubo CRM e clique em **Instalar Agora**.
  * Alternativamente, se estiver instalando pelo repositório, pesquise por "Cubo CRM" e clique em **Instalar**.
* **Ative o Plugin**
  * Após a instalação, clique em **Ativar Plugin**.
  * O plugin criará automaticamente as tabelas necessárias no banco de dados para armazenar logs e submissões com erro.
* **Pré-requisitos**
  * O plugin **Contact Form 7** deve estar instalado e ativo, pois o Cubo CRM utiliza formulários criados por ele para a integração.
  * Certifique-se de ter uma conta no Cubo CRM e acesso à API para obter o token necessário.

***

## 2. Configurações Gerais

Antes de configurar formulários, é necessário definir o token da API do Cubo CRM para permitir a comunicação com o sistema.

* **Acesse as Configurações Gerais**

  * No menu lateral do WordPress, clique em **CUBO CRM > Configurações Gerais**.

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

  <figure><img src="/files/DdfgjtWZQpxcruP5M6Lb" alt=""><figcaption></figcaption></figure>
* **Obtenha e Insira o Token da API**

  * No Cubo CRM, clique no ícone de usuário no canto superior direito da tela.

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

  * Selecione **Meu Perfil** no menu que aparecer.

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

  * Na aba **Chave de API**, crie uma nova chave, dando um nome que refira sua utilização (ex.: "WordPress Plugin").

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

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

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

  * Após criar, clique no botão de copiar e cole o token no campo **Token da API** no WordPress.

  <figure><img src="/files/1VX3BUgyHxVBwSJZtN7w" alt=""><figcaption></figcaption></figure>

  * Agora precisamos inserir no wordpress, para visualizar o token enquanto digita, clique no ícone de olho ao lado do campo.

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

  * Clique em **Salvar Configurações**.

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

***

## 3. Configuração de Formulários para Integração

O plugin permite configurar formulários do Contact Form 7 para criar ou atualizar negociações no Cubo CRM.

### 3.1. Acesse a Página de Formulários

* No menu lateral do WordPress, clique em **CUBO CRM > CUBO CRM**.

  <figure><img src="/files/54gNHqAf66r9ill6v5if" alt=""><figcaption></figcaption></figure>
* Você verá uma lista de formulários criados no Contact Form 7. Clique no formulário que deseja configurar para expandir suas opções.

<figure><img src="/files/3DxuJ2M0SdVsP6XpzFQ1" alt=""><figcaption></figcaption></figure>

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

### 3.2. Configurações Gerais do Formulário

* **Escolha a Operação**
  * No campo **Operação**, selecione:
    * **Criação de Deal**: Para criar uma nova negociação no Cubo CRM.
    * **Atualização de Deal**: Para atualizar uma negociação existente (requer o ID da negociação, que pode ser obtido via URL, cookie ou sessão).
* **Defina os IDs Padrão**

  * **Pipe ID (Padrão/Obrigatorio)** (somente para criação): Insira o ID do funil onde a negociação será criada (obtido na seção "Funis" no menu à esquerda do Cubo CRM).

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

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

  * **Stage ID (Padrão/Opcional)**: Insira o ID do estágio que deseja criar a negociação (obtido nas configurações do funil selecionado).

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

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

  * **User ID (Padrão/Opcional)**: Insira o ID do usuário responsável pela negociação (obtido na seção "Usuários" no menu à esquerda do Cubo CRM). Para garantir compatibilidade, valide se o usuário está associado ao funil:

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

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

  * Acesse o funil no menu à esquerda em **Funis**, entre nas configurações (ícone no canto superior direito), e no select de usuários, adicione o usuário desejado.

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

  <figure><img src="/files/51BWScs3RAN0OssmuaUA" alt=""><figcaption></figcaption></figure>

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

### 3.3. Mapeamento de Campos

* Na seção **Mapeamento de Campos**, associe os campos do formulário Contact Form 7 aos campos do Cubo CRM:

  * Veja um exemplo da tela de mapeamento para criação:

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

  * Veja um exemplo da tela de mapeamento para atualização:

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

  * **Campo do Formulário**: Insira o nome do campo no Contact Form 7 (ex.: `your-name`).

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

  * **Campo do CRM**: Selecione o campo correspondente no Cubo CRM (ex.: Nome da Pessoa, Título do Deal, etc.).

    <figure><img src="/files/tJ5hp3IIDMPCmg1VbYRJ" alt=""><figcaption></figcaption></figure>
  * No modo **Criação de Deal**, os campos **Título** e **Nome da Pessoa** são obrigatórios.

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

  * No modo **Atualização de Deal**, nenhum campo é obrigatório.

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

* Clique em **Adicionar Campo** para mapear mais campos, se necessário.

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

* Para remover um mapeamento, clique em **Remover** (campos obrigatórios no modo criação não podem ser removidos).

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

### 3.4. Mapeamento de Campos Personalizados (Opcional)

* Na seção **Mapeamento de Custom Fields**, você pode mapear campos personalizados do Cubo CRM:

  * **ID do Custom Field**: Insira o ID do campo personalizado (obtido na seção "Campos Personalizados" no menu à esquerda do Cubo CRM, na coluna "ID", e use apenas campos do contexto "Negociação" para criação).

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

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

  <figure><img src="/files/0cv3V4CmFdSHH5b74tW3" alt=""><figcaption></figcaption></figure>

  * **Fonte**: Escolha se o valor virá do **Formulário** ou da **URL** (ex.: parâmetros UTM).
  *

  ```
  <figure><img src="/files/0T4i5raGVwcdDECIynJ3" alt=""><figcaption></figcaption></figure>
  ```

  * **Campo/Parâmetro**: Insira o nome do campo do formulário ou o parâmetro da URL (ex.: `utm_source`).

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

  <figure><img src="/files/90iKGenv3kDxTYv0dCFS" alt=""><figcaption></figcaption></figure>
* Clique em **Adicionar Custom Field** para adicionar mais campos personalizados.

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

* Para remover, clique em **Remover**.

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

### 3.5. Mapeamento de Produtos (Opcional)

* Na seção **Mapeamento de Produtos**, associe opções de um campo a produtos no Cubo CRM:

  * **Chave do Select (Formulário)**: Insira o valor da opção do campo select (ex.: `produto1`).

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

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

  * **Product ID**: Insira o ID do produto (obtido na seção "Produtos" no menu à esquerda do Cubo CRM; clique em "Produtos", abra a página e pegue o ID na coluna "Produto").

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

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

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

  * **Preço**: (Opcional) Insira o preço do produto, ou deixe em branco para usar o preço registrado no Cubo CRM.

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

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

* [**Preço**: (Opcional) Inserindo o preço do produto](#user-content-fn-1)[^1]

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

* Clique em **Adicionar Produto** para mapear mais produtos.

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

* Para remover, clique em **Remover**.

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

### 3.6. URL de Redirecionamento (Opcional)

* Na seção **URL de Redirecionamento**, insira uma URL para redirecionar o usuário após o envio bem-sucedido do formulário (ex.: `https://seusite.com/obrigado`).

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

### 3.7. Salve as Configurações

* Clique em **Salvar Configurações** para aplicar as mudanças ao formulário.

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

***

***

## Dicas e Solução de Problemas

* **Erro "Token da API não configurado"**: Certifique-se de que o token da API foi inserido corretamente em **Configurações Gerais**.
* **Campos Obrigatórios no Modo Criação**: No modo **Criação de Deal**, os campos **Título** e **Nome da Pessoa** devem ser mapeados.
* **Erro de Usuário Não Associado ao Funil**: Certifique-se de que o usuário definido no **User ID** está associado ao funil (verifique nas configurações do funil).
* **Problemas com Redirecionamento**: Verifique se a URL de redirecionamento está correta e se o formulário foi enviado com sucesso.

***

## Considerações Finais

O plugin Cubo CRM é uma ferramenta poderosa para integrar formulários do WordPress com o Cubo CRM, permitindo automações para criação e atualização de negociações. Certifique-se de testar todas as configurações após salvar, especialmente os mapeamentos de campos e produtos, para garantir que os dados sejam enviados corretamente ao Cubo CRM. Em caso de dúvidas, consulte a documentação oficial do Cubo CRM ou entre em contato com o suporte em <https://cubosuite.com.br>.

[^1]:


---

# 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/plugin-cubo-crm-para-wordpress.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.