# Como conectar e configurar seu CRM

A Vambe permite se integrar nativamente com os CRMs mais importantes do mercado para manter sua base de dados e sua equipe de vendas alinhadas.

**Integrações disponíveis:**

* HubSpot (Deals e Tickets)
* Pipedrive
* Salesforce
* Zoho (CRM e Desk)
* ActiveCampaign
* Odoo CRM

A seguir, explicamos passo a passo como realizar a conexão e a configuração avançada de sincronização.

{% hint style="info" %}
Se tiver dúvidas sobre o que posso conectar com meu CRM, você pode [ver aqui](/crm/crm-pt-br/integracao-com-plataforma-crm/integracion-de-vambe-con-crms-que-es-posible-que-se-sincroniza-y-que-debes-considerar.md)
{% endhint %}

***

#### Obtenção do seu Client ID (Vambe ID)

Para diversas configurações e integrações com seu CRM, talvez você precise do **Client ID** do seu workspace, também conhecido como **Vambe ID**. Esse identificador ajuda a Vambe a reconhecer sua instância e é fundamental para certos processos de conexão.

Para obtê-lo:

1. Acesse a nova visualização do seu Backoffice da Vambe.
2. Você encontrará o ícone de chave ('IDs') no canto superior direito da tela.
3. Clique nesse ícone para ver e copiar seu Client ID.

{% hint style="info" %}
**Recomendação Importante sobre a URL do Backoffice:**

Atualmente, para a maioria dos fluxos de trabalho e configurações na Vambe, recomenda-se continuar usando a URL antiga do Backoffice (`https://backoffice.vambe.ai/clients/...`). A nova URL (`https://backoffice.vambe.ai/workspaces/...`) foi introduzida, mas a antiga é recomendada para garantir compatibilidade com todas as funcionalidades existentes enquanto os fluxos internos são atualizados.
{% endhint %}

***

#### 1. Conexão Inicial

1. No menu lateral esquerdo, vá para a seção **CRM**.
2. Abra o menu de **Configurações** e selecione **Integrações**.
3. Você verá a lista de CRMs disponíveis. Clique em Conectar no cartão do seu CRM (ex.: Pipedrive, HubSpot etc.).
4. Siga os passos de autenticação da sua plataforma externa.
5. Uma vez conectado, você voltará à Vambe. Se não vir a integração ativa imediatamente, **atualize a página.**
6. Clique no ícone de Lápis (Editar) para entrar no painel de configuração.

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

***

#### 2. Sincronização Geral

Na primeira aba **Sincronizar**, você encontrará três opções-chave que permitem à Vambe "ler" a estrutura do seu CRM:

* **Sincronizar Campos**: Detecta automaticamente os campos personalizados do seu CRM para que você possa usá-los na Vambe.
* **Sincronizar Agentes**: Importa os usuários do seu CRM para atribuir donos aos contatos.
* **Sincronizar Etiquetas**: Traz as etiquetas existentes no seu CRM.

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

***

#### 3. Atributos de Contato (Regras de Envio)

Esta seção é crítica. Aqui você define os **requisitos mínimos** para que um contato seja enviado ao CRM.

* **Como funciona?** Você seleciona um funil e define quais campos são obrigatórios (ex.: RUT, Email).
* **A Regra:** Se o contato **NÃO tiver esse dado** (nem a IA nem o humano preencheram), a Vambe **NÃO enviará** o contato ao CRM para evitar sujar sua base de dados com leads vazios.

1. Ative o interruptor do funil que deseja configurar.
2. Clique no botão **(+)** e selecione o campo obrigatório (ex.: Email).

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

***

#### 4. Configuração de Contato

Aqui definimos como a Vambe busca, importa e atualiza as informações.

**A. Configuração de Busca**

Defina o critério único para evitar duplicados. A Vambe buscará no seu CRM se o contato já existe usando estes campos (ex.: Email ou Telefone). Se encontrar, atualiza; se não, cria.

<figure><img src="/files/2510173d5ca9f2211ab84d34ccbd24c29628e221" alt="" width="563"><figcaption></figcaption></figure>

**B. Configuração de Importação**

Defina quais dados deve trazer **a Vambe de dentro do CRM**. Você pode ativar:

* Sincronizar atribuição de agentes.
* Sincronizar etiquetas.
* Sincronizar campos de contato.
* Sincronizar Último Negócio: Importante para trazer o contexto de vendas anteriores.

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

**C. Webhooks (Bidirecionalidade)**

Ative esta opção para que, quando algo mudar no seu CRM (ex.: você alterar uma etapa no Pipedrive), isso seja atualizado automaticamente na Vambe em tempo real.

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

***

#### 5. Mapeamento de Campos

É hora de conectar os cabos. Você deve informar qual campo da Vambe corresponde a qual campo do seu CRM.

* **Campos de Contato:** Associe dados pessoais (Nome, RUT, Email).

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

* **Atributos do Deal (Negócio/Ticket):** Associe dados da venda (Valor, Produto de interesse, Endereço de entrega). Isso é vital para que o negócio seja criado com informações valiosas no seu CRM.

<figure><img src="/files/94f6999060a91823443f73fdb92bb1e47579c775" alt=""><figcaption></figcaption></figure>

***

#### 6. UTMs (Rastreamento de Marketing)

Se você faz publicidade digital, pode mapear os parâmetros UTM (Source, Medium, Campaign) para que sejam enviados ao CRM e você possa medir o ROI das suas campanhas. Selecione o valor UTM (ex.: `utm_source`) e associe-o ao campo correspondente no seu CRM.

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

***

#### 7. Etapas (O disparador)

Esta é a configuração mais importante para a automação. Aqui você decide **quando e onde** o lead é enviado.

Você deve configurar a seguinte lógica:

1. **Etapa Vambe**: Selecione a etapa do seu funil na Vambe que servirá de "gatilho" (ex.: Quando entrar em "Cotação Enviada").
2. **Pipeline do CRM**: Selecione para qual funil do seu CRM ele irá.
3. **Etapa do CRM**: Selecione em qual etapa exata ele cairá no seu CRM.
4. **Criar Negócio (Switch):**
   * **Ativado**: Cria o Contato + o Negócio (Deal/Oportunidade).
   * **Desativado**: Apenas cria ou atualiza o Contato (sem criar oportunidade de venda).

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

***

#### 8. Automação Reversa: Trigger de Workflow por Mudança de Etapa no CRM

Além de enviar informações da Vambe para o seu CRM, agora você pode configurar **Workflows na Vambe** que sejam ativados automaticamente quando um contato **muda de etapa diretamente no seu CRM**. Essa funcionalidade simplifica significativamente a automação e permite que você reaja a eventos-chave sem a necessidade de fluxos complexos no seu sistema de CRM.

**Benefícios-chave:**

* **Automação Direta:** Executa ações na Vambe (ex.: enviar mensagens, atribuir agentes) assim que uma etapa muda no HubSpot, Pipedrive ou Salesforce.
* **Otimização de Custos:** Permite que usuários de planos básicos de CRM (como o HubSpot Starter) automatizem ações que antes exigiam planos mais avançados e caros.
* **Flexibilidade:** O trigger oferece duas opções para gerenciar os contatos:
  * **Buscar apenas contatos existentes na Vambe:** Ative o workflow somente se o contato já estiver cadastrado na Vambe.
  * **Buscar ou criar o contato se ele não existir:** Se o contato não estiver na Vambe, ele será criado automaticamente para que o workflow possa ser executado.

Para configurar esse trigger, vá para a seção de [Workflows na Vambe](https://github.com/Jorgeprieto30/vambe-gitbook-docs/blob/main/crm/workflows/README.md) e selecione a opção **"Mudança de Etapa no CRM"** como gatilho.

***

#### 9. Ajustes Finais

Na aba Configurações, você poderá ver o status da sincronização ou **Excluir** a integração se precisar desconectar o CRM.

{% hint style="danger" %}
⚠️ **Aviso**: Se você excluir o CRM, a configuração de mapeamento realizada será perdida.
{% endhint %}


---

# 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://academy.vambe.ai/crm/crm-pt-br/integracao-com-plataforma-crm/como-conectar-y-configurar-tu-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.