> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/crm/crm-pt-br/integracao-da-plataforma-crm/como-conectar-y-configurar-tu-crm.md).

# Como conectar e configurar seu CRM

Centralize sua gestão. Aprenda a conectar HubSpot, Pipedrive, Salesforce e outros CRMs para sincronizar contatos, negócios e automatizar o envio de leads a partir do Vambe.

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

**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 você tiver dúvidas sobre o que posso conectar com meu CRM, pode ver isso aqui
{% 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.).

{% hint style="info" %}
Vai conectar **Odoo CRM**? Diferentemente de outros CRMs, o Odoo exige que você gere uma Chave de API manualmente antes desta etapa. Veja primeiro [como obter as credenciais do Odoo CRM](/crm/crm-pt-br/integracao-da-plataforma-crm/como-obter-as-credenciais-do-odoo-crm.md).
{% endhint %}

4. Siga as etapas de autenticação da sua plataforma externa.
5. Uma vez conectado, você voltará para a 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="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FMa2WOFQGyb9aHllO5vDX%2Fimage.png?alt=media&#x26;token=0b5c9518-690d-47d0-9ba9-d7cf2a2e2efc" alt=""><figcaption></figcaption></figure>

***

#### 2. Sincronização Geral

Na primeira aba **Sincronizar**, você encontrará três opções principais 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 responsáveis aos contatos.
* **Sincronizar Etiquetas**: Traz as etiquetas existentes no seu CRM.

<figure><img src="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FJKpqXHiNc3Mb8SQU7hkz%2Fimage.png?alt=media&#x26;token=1c7dabc5-1eb2-4b10-8358-f8dc386dbefd" 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 este dado** (nem a IA nem o humano o preencheram), a Vambe **NÃO enviará** o contato para o CRM para evitar poluir seu banco de dados com leads vazios.

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

<figure><img src="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FGbQcXq5SJDeAcx5zkt9M%2Fimage.png?alt=media&#x26;token=cc7a00ad-e981-481c-8e3e-ca97ce309057" alt="" width="563"><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="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FFzy2JSzvHOiqVTIeR4c7%2Fimage.png?alt=media&#x26;token=ce72b940-3a38-4208-b174-84639f54d91c" alt="" width="563"><figcaption></figcaption></figure>

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

Defina quais dados deve trazer **a Vambe do CRM para dentro**. 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="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FfONGSvtV3AFtttKYbo5u%2Fimage.png?alt=media&#x26;token=5e7ad941-48aa-4e88-87b5-57516096516d" alt=""><figcaption></figcaption></figure>

**C. Webhooks (Bidirecionalidade)**

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

<figure><img src="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FzZa1xwC8zUoLvaICA0wJ%2Fimage.png?alt=media&#x26;token=b2b4ee12-67fd-4756-ae8b-77f28d224ad8" alt=""><figcaption></figcaption></figure>

***

#### 5. Mapeamento de Campos

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

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

<figure><img src="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2Fgi5xHrI6UBNOllJIjvR8%2Fimage.png?alt=media&#x26;token=d4935004-df4a-4e95-bd4d-07f722d631f3" 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="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2F66FS8JoXwJVAyNvPye1T%2Fimage.png?alt=media&#x26;token=e5c2dbe4-e2f9-41e7-bf56-3658e7889afe" 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="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2FR6Dv7YjDtLZcT9TBeeSd%2Fimage.png?alt=media&#x26;token=e2e2fa5e-5861-4755-bb55-1fe4c0522890" alt=""><figcaption></figcaption></figure>

***

#### 7. Etapas (O gatilho)

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á como "gatilho" (ex.: Quando entrar em "Cotação Enviada").
2. **Pipeline CRM**: Selecione para qual funil do seu CRM ele irá.
3. **Etapa 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**: Cria ou atualiza apenas o Contato (sem criar oportunidade de venda).

<figure><img src="https://310161448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRUgcMYDLALCYrWDqh6tC%2Fuploads%2F8VyZcnqKugkufRw3imtt%2Fimage.png?alt=media&#x26;token=60b74a80-c72d-4c43-9915-4e40b211ed71" alt=""><figcaption></figcaption></figure>

***

#### 8. Automação Inversa: 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 principais:**

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

Para configurar este gatilho, vá para a seção de Workflows na Vambe e selecione a opção **"Mudança de Etapa no CRM"** como gatilho.

***

#### 9. Ajustes Finais

Na aba Ajustes, 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://academy.vambe.ai/crm/crm-pt-br/integracao-da-plataforma-crm/como-conectar-y-configurar-tu-crm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.