# Integração do Vambe com CRMs: o que é possível, o que é sincronizado e o que você deve considerar Antes de configurar uma integração, é fundamental entender o que é um CRM, qual papel ele cumpre dentro da sua operação e o que a Vambe pode (e o que não pode) fazer com cada um. Este artigo traz o panorama completo para que você saiba exatamente o que esperar antes de avançar para a configuração passo a passo. ## O que é um CRM? Um **CRM (Customer Relationship Management)** é um sistema projetado para centralizar e organizar **todas as interações de uma empresa com seus clientes e prospects**. Seu principal objetivo é se tornar uma **fonte única da verdade** (system of record), onde ficam registrados: * Quem é o cliente * Quando e por quais canais interagiu * Quem é o responsável comercial * Quais negócios (tratos/deals) existem * Quais tarefas, atividades e estados cada relação possui Um CRM não é apenas um funil: é a **base histórica e operacional do negócio**. ## Como um contato se move dentro de um CRM? A maioria dos CRMs compartilha um fluxo evolutivo semelhante, conhecido como Lifecycle: {% stepper %} {% step %} #### Lead É o primeiro registro. Existe informação básica, mas ainda não há uma intenção de compra validada. {% endstep %} {% step %} #### Contato (MQL – Marketing Qualified Lead) O contato demonstra interesse real: responde, pergunta, interage. Já faz parte ativa da base. {% endstep %} {% step %} #### Deal / Trato / Oportunidade Representa um negócio concreto. Um mesmo contato pode ter **múltiplos tratos** (por exemplo: compras, serviços ou contas diferentes). **Importante:** o contato é permanente, os tratos são transacionais. {% endstep %} {% endstepper %} ## Qual papel a Vambe cumpre junto a um CRM? Vambe **não substitui o CRM**, e sim o **alimenta e se integra a ele**. A Vambe é responsável por: * Gerenciar conversas multicanal com IA * Qualificar, encaminhar e estruturar informações * Criar e mover contatos, tratos e tickets * Enviar contexto limpo e estruturado para o CRM ### Automação Inteligente: a Vambe reage a mudanças no seu CRM Além de enviar dados para o seu CRM, a Vambe agora pode **reagir às mudanças que ocorrem nele**. Com o novo gatilho de Workflow por Mudança de Etapa no CRM, você pode configurar a Vambe para iniciar automações complexas (como enviar mensagens, mudar etapas na Vambe ou atribuir agentes) de forma automática quando um contato avança ou se move entre etapas no HubSpot, Pipedrive ou Salesforce. Isso amplia as capacidades de automação bidirecional, permitindo que você: * **Simplifique fluxos:** Você não precisa criar automações complexas no seu CRM apenas para disparar ações na Vambe. * **Otimize custos:** Acesse funcionalidades avançadas de automação na Vambe, mesmo se você usar planos básicos do seu CRM (ex.: HubSpot Starter). Para uma configuração detalhada, consulte a documentação sobre [Workflows na Vambe](https://github.com/Jorgeprieto30/vambe-gitbook-docs/blob/main/crm/workflows/README.md). O CRM recebe essas informações e as usa para: * Relatórios financeiros * Automações comerciais * Gestão de equipes * Acompanhamento histórico ## Com quais CRMs a Vambe se integra? Atualmente, a Vambe se integra com os seguintes CRMs: * Zoho * Odoo * HubSpot (Deals e Tickets) * Pipedrive * ActiveCampaign * Salesforce Cada um tem **capacidades e limitações próprias**, e por isso a integração **não é idêntica em todos os casos**. ## O que pode ser sincronizado com cada CRM? A tabela a seguir resume **quais objetos podem ser criados ou sincronizados da Vambe para cada CRM**: | CRM | Leads | Contatos | Tratos / Deals | Tags | Agentes | | ----------------------- | ----: | -------: | -------------: | --------------------: | ------: | | Zoho | ❌ | ✅ | ✅ | ✅ | ✅ | | Odoo | 🟡\* | ✅ | ✅ | ✅ | ✅ | | HubSpot (Deals/Tickets) | ❌ | ✅ | ✅ | ❌ | ✅ | | Pipedrive | ❌ | ✅ | ✅ | ✅ (somente em tratos) | ✅ | | ActiveCampaign | ❌ | ✅ | ✅ | ✅ | 🟡 | | Salesforce | 🟡\* | ✅ | ✅ | ✅ | ✅ | 🟡 *No Odoo e no Salesforce, o conceito de “Lead” é tratado como um Trato, e não como um objeto independente.* 🟡 **ActiveCampaign** não trabalha com “agentes” como um objeto padrão; a atribuição de responsáveis depende de usuários, campos ou automações. Por isso, a sincronização de agentes da Vambe pode variar conforme a configuração de cada conta. ## Explicação por tipo de objeto ### Leads * Atualmente, a Vambe **não trabalha com o objeto Lead puro** na maioria dos CRMs. * Isso é intencional: muitos CRMs tratam leads de forma inconsistente ou simplesmente não os utilizam. * No Odoo e no Salesforce, o lead é assimilado a um trato, por isso aparecem como compatibilidade parcial. 👉 **A Vambe trabalha principalmente com Contatos e Tratos.** ### Contatos * Vambe **cria e atualiza contatos em todos os CRMs**. * O contato é **permanente**: uma vez criado, ele é reutilizado em conversas futuras. * O e-mail costuma ser a **chave primária recomendada** para evitar duplicidades. ### Tratos / Deals / Tickets * A Vambe pode **criar tratos automaticamente** quando um contato entra em uma etapa definida. * Os tratos se movem conforme o avanço do contato no funil. * Um mesmo contato pode ter múltiplos tratos ao longo do tempo. ### Tags Existem diferenças importantes entre CRMs: * Alguns permitem tags em **contatos e tratos**. * Outros somente em **tratos**. * Outros **não oferecem suporte nativo a tags**. Exemplos: * Pipedrive → tags somente em tratos * HubSpot → não oferece suporte a tags como objeto nativo 👉 Se um CRM não oferece suporte a tags, a Vambe **não pode forçar sua criação**. ### Agentes * A Vambe pode sincronizar agentes em todos os CRMs. * Para evitar erros de permissão, **recomenda-se conectar o CRM com um usuário administrador ou owner**. ## Considerações e limitações importantes Antes de configurar sua integração, leve em conta: * Nem todos os CRMs oferecem suporte aos mesmos tipos de campos. * Campos do tipo seletor podem falhar se os valores não coincidirem exatamente. * Os tokens de conexão podem expirar e exigir reconexão. * Automações existentes no CRM podem ser ativadas ao receber dados da Vambe. * **Workflows na Vambe:** Ao configurar o gatilho "Mudança de Etapa no CRM", considere que os workflows na Vambe serão ativados com base nas mudanças no seu CRM. Revise a lógica das suas automações na Vambe para garantir o comportamento desejado. {% hint style="warning" %} Sempre revise as automações ativas no seu CRM antes de mapear etapas ou campos. {% endhint %} ## O que você deve ter claro antes de configurar Antes de avançar para os artigos técnicos, você deve conseguir responder: * Qual CRM eu uso e quais objetos preciso sincronizar? * Quais campos são obrigatórios no meu CRM? * Quais etapas do funil quero refletir no CRM? * Quais informações devem permanecer fixas (contato) e quais são transacionais (trato)? * Quais automações quero disparar na Vambe quando um contato mudar de etapa no meu CRM? Se você tiver essas respostas claras, a configuração será muito mais simples e estável. ## Próximos passos Nos próximos artigos você aprenderá: * Como conectar cada CRM passo a passo * Como mapear etapas corretamente * Como evitar duplicidades * Como sincronizar campos, agentes e etiquetas * Como usar o novo gatilho de Workflow para que a Vambe reaja às mudanças no seu CRM. Este artigo é o **marco conceitual** para que todas essas configurações façam sentido. --- # 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/integracion-de-vambe-con-crms-que-es-posible-que-se-sincroniza-y-que-debes-considerar.md?ask= ``` 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.