> 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/integracion-de-vambe-con-crms-que-es-posible-que-se-sincroniza-y-que-debes-considerar.md). # Integração do Vambe com CRMs: o que é possível, o que é sincronizado e o que você deve considerar ## Integração da Vambe com CRMs: o que é possível, o que é sincronizado e o que você deve considerar ### Integração da 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 entrega o contexto 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 status cada relação tem 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 mostra interesse real: responde, pergunta, interage. Já faz parte ativa da base. {% endstep %} {% step %} **Deal / Negócio / Oportunidade** Representa um negócio concreto. Um mesmo contato pode ter **múltiplos negócios** (por exemplo: compras, serviços ou contas diferentes). **Importante:** o contato é permanente, os negócios são transacionais. {% endstep %} {% endstepper %} #### Qual papel a Vambe cumpre junto a um CRM? A 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, negócios e tickets * Enviar contexto limpo e estruturado ao CRM **Automação Inteligente: a Vambe reage a mudanças no seu CRM** Além de enviar dados para o seu CRM, agora a Vambe pode **reagir às mudanças que acontecem nele**. Com o novo trigger 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 executivos) 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://academy.vambe.ai/workflows). 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 | Negócios / Deals | Tags | Executivos | | ----------------------- | ----: | -------: | ---------------: | ---------------------: | ---------: | | Zoho | ❌ | ✅ | ✅ | ✅ | ✅ | | Odoo | 🟡\* | ✅ | ✅ | ✅ | ✅ | | HubSpot (Deals/Tickets) | ❌ | ✅ | ✅ | ❌ | ✅ | | Pipedrive | ❌ | ✅ | ✅ | ✅ (apenas em negócios) | ✅ | | ActiveCampaign | ❌ | ✅ | ✅ | ✅ | 🟡 | | Salesforce | 🟡\* | ✅ | ✅ | ✅ | ✅ | 🟡 *No Odoo e no Salesforce, o conceito de “Lead” é tratado como um Negócio, não como um objeto independente.* 🟡 **ActiveCampaign** não trata “executivos” 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 executivos 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 negócio, por isso aparecem como compatibilidade parcial. 👉 **A Vambe trabalha principalmente com Contatos e Negócios.** **Contatos** * A 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. **Negócios / Deals / Tickets** * A Vambe pode **criar negócios automaticamente** quando um contato entra em uma etapa definida. * Os negócios avançam conforme o progresso do contato no funil. * Um mesmo contato pode ter múltiplos negócios ao longo do tempo. **Tags** Existem diferenças importantes entre os CRMs: * Alguns permitem tags em **contatos e negócios**. * Outros apenas em **negócios**. * Outros **não oferecem suporte nativo a tags**. Exemplos: * Pipedrive → tags apenas em negócios * 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 a criação delas**. **Executivos** * A Vambe pode sincronizar executivos 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 suportam os 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 trigger "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 passar para os artigos técnicos, você deveria 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 permanentes (contato) e quais transacionais (negócio)? * 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ê vai aprender: * Como conectar cada CRM passo a passo * Como mapear etapas corretamente * Como evitar duplicidades * Como sincronizar campos, executivos e etiquetas * Como usar o novo trigger de Workflow para que a Vambe reaja a mudanças no seu CRM. Este artigo é o **marco conceitual** para que todas essas configurações façam sentido. --- # 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/integracion-de-vambe-con-crms-que-es-posible-que-se-sincroniza-y-que-debes-considerar.md?ask=&goal= ``` `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.