Como funciona a sincronização do WhatsApp com negócios e contatos do Pipedrive
A TimelinesAI sincroniza o WhatsApp com o Pipedrive pelo número de telefone: cada conversa é associada a uma Pessoa existente ou cria uma nova. As mensagens são registradas como atividades nessa Pessoa e no Negócio ou Lead ativo mais recente.
A TimelinesAI sincroniza o WhatsApp com o Pipedrive pelo número de telefone: cada conversa é associada a uma Pessoa existente ou cria uma nova. As mensagens são registradas como atividades personalizadas nessa Pessoa e no Negócio ou Lead ativo mais recente. Você decide se as novas conversas criam um Negócio, um Lead ou nada. A configuração leva cerca de cinco minutos e não precisa da API do WhatsApp.
A maioria dos guias sobre como conectar WhatsApp e Pipedrive explica em quais botões clicar. Poucos explicam o que realmente acontece com os seus dados depois: em qual registro uma mensagem cai, o que acontece quando um número não corresponde a nada e a qual de três negócios abertos uma conversa se vincula.
Isso importa, porque quase todo problema de sincronização vem da lógica de correspondência, não da configuração. Este guia trata primeiro da mecânica e depois das configurações.
A TimelinesAI funciona como aplicativo nativo do Marketplace do Pipedrive — 4,5 estrelas em 269 avaliações — e não como um fluxo montado sobre uma camada de automação de terceiros. É essa diferença que torna possível um mapeamento direto de objetos, e é por aí que começamos.
O que realmente sincroniza: o mapa de objetos
Toda conversa do WhatsApp se resolve em registros do Pipedrive por meio de uma sequência fixa. Entendê-la leva cerca de um minuto e vai poupar a maior parte da solução de problemas descrita adiante.
Uma conversa produz quatro coisas no Pipedrive:
- Pessoa — associada pelo número de telefone, ou criada a partir do número se nada corresponder.
- Atividade personalizada — cada mensagem enviada e recebida, registrada na Pessoa e no Negócio associado, agrupada por data.
- Negócio ou Lead — a conversa se vincula a um deles, conforme suas configurações.
- Arquivos — mensagens de voz, imagens e anexos são enviados para a seção Arquivos da Pessoa e do Negócio.
Chamadas em um número conectado também são registradas, e conversas em grupo sincronizam se você ativar essa opção. Mais sobre as duas coisas adiante.
A sequência de correspondência
Quando uma mensagem chega, a TimelinesAI a resolve nesta ordem:
- Associação existente. Se a conversa já está vinculada a um registro do Pipedrive, a mensagem vai para lá.
- Correspondência do número. Caso contrário, o número do WhatsApp é comparado com os registros de Pessoas. A correspondência é flexível: lida com números com ou sem o sinal de mais e com ou sem código de país, de modo que +44 7700 900123, 447700900123 e 07700 900123 se resolvem na mesma Pessoa.
- Criação. Se nada corresponder, uma nova Pessoa é criada a partir do número do WhatsApp.
Por que isso importa: o número de telefone é a chave de ligação de toda a integração. Todo registro que termina no lugar errado chegou lá na etapa dois — e é também por isso que a correção mais comum é remover duplicatas, não reconfigurar.
Em qual Negócio uma conversa cai
Esta é a mecânica que mais surpreende, e vale dizer com clareza: a TimelinesAI sincroniza uma conversa no Negócio ativo mais recente. Negócios mais antigos e negócios fechados são ignorados.
Ou seja, um cliente com três negócios abertos não tem as mensagens espalhadas pelos três. Tudo cai no mais recente, a menos que você fixe a conversa em um específico.
Antes de começar
- Permissões de administrador no Pipedrive. Necessárias para instalar o aplicativo no nível da empresa e para que a sincronização enxergue todos os registros.
- O mesmo endereço de e-mail nas duas contas. A TimelinesAI usa e-mails coincidentes para atribuir automaticamente a propriedade dos registros. Endereços diferentes são causa frequente de conversas sincronizadas sob o proprietário errado.
- Qualquer tipo de conta do WhatsApp — WhatsApp comum, o aplicativo WhatsApp Business, a API do WhatsApp Business ou Coexistence. Não é preciso acesso à API do WhatsApp, e você não migra nem exclui o seu número atual.
- Cerca de cinco minutos.
Vale se deter no terceiro ponto se você está comparando ferramentas. A maioria dos produtos de WhatsApp para CRM é construída sobre a API do WhatsApp Business, o que exige que o número esteja registrado em uma WABA — e um número registrado na Business API não pode mais ser usado com o WhatsApp comum nem com o aplicativo Business. Para um time comercial que já conduz negócios a partir de números de WhatsApp existentes, isso significa abrir mão desses números e do histórico deles. A TimelinesAI conecta a conta que você já usa.
Etapa 1: Conecte sua conta do WhatsApp
Escaneie o QR code no seu espaço de trabalho da TimelinesAI, exatamente como faria no WhatsApp Web.
Por que isso importa: é aqui que a característica de «não exigir API» se torna concreta. Você está conectando a conta que sua equipe já usa, então as conversas existentes vêm junto. Nada é migrado e nenhum número é registrado novamente.
Etapa 2: Autorize a conexão com o Pipedrive
Instale o aplicativo pelo Marketplace do Pipedrive e autorize-o com uma conta de administrador.
Por que isso importa: o escopo da autorização determina o que a sincronização consegue ver. Instalar com um usuário restrito é a causa mais comum de «algumas conversas sincronizam e outras não»: a integração não enxerga registros fora do grupo de visibilidade desse usuário.
Etapa 3: Escolha o que as novas conversas criam
Abra as configurações da integração. Quatro controles decidem como os registros são criados:
- Auto-Add Chat as New Person — se números sem correspondência criam registros de Pessoa.
- Action on New Chat — Create New Deal, Create New Lead ou Do Nothing.
- Choose Pipeline for New Deals — onde os negócios criados automaticamente vão parar.
- Import Messages from Groups — se as conversas em grupo sincronizam.
A configuração Action on New Chat funciona assim. Create New Deal vincula ao Negócio ativo mais recente e cria um se não houver nenhum. Create New Lead vincula ao Lead não arquivado mais recente e cria um se não houver nenhum. Do Nothing vincula apenas ao Negócio mais recente e não cria nada.
Por que isso importa: esta é a decisão da qual você mais provavelmente vai se arrepender. Create New Deal em um número de suporte com alto volume vai fabricar um negócio para cada consulta e distorcer seus relatórios de funil em uma semana. Se a maioria das conversas recebidas não são oportunidades de venda, escolha Do Nothing e fixe as conversas de forma deliberada.
Etapa 4: Exclua conversas pessoais e decida sobre os grupos
Desative a criação automática para números que não devem virar registros do CRM e deixe Import Messages from Groups desativado, a menos que você queira mesmo os tópicos de grupo no Pipedrive.
Grupos funcionam de forma diferente das conversas individuais, e vale conhecer a diferença. Um grupo não tem número de contato, então ele é associado pelo seu ID de grupo exclusivo e sincronizado com uma Pessoa do Pipedrive com o nome do grupo, registrando as mensagens de cada participante como atividades. Você pode sincronizar conversas em grupo do WhatsApp com o Pipedrive em qualquer número conectado por QR.
Por que isso importa: a conta de WhatsApp que seus vendedores conectam é a que eles já usam. Sem esta etapa, conversas com a família e com entregadores chegam ao Pipedrive como Pessoas e, em algumas configurações, como Negócios. É muito mais fácil prevenir do que limpar depois.
Etapa 5: Fixe uma conversa em um Negócio específico
Abra a conversa na TimelinesAI e fixe-a ao Negócio ao qual ela pertence.
Por que isso importa: fixar substitui a regra padrão do Negócio ativo mais recente. Para qualquer cliente com mais de uma oportunidade aberta — uma renovação ao lado de um upsell, dois imóveis, dois projetos — fixar é a única forma de garantir que o tópico caia no lugar certo. Se você aplicar apenas uma coisa deste guia além da configuração, que seja esta.
Etapa 6: Decida como as mensagens aparecem no feed de atividades
As mensagens são registradas como atividades personalizadas na Pessoa e no Negócio associados, agrupadas por data. Você pode desativar a criação de atividades se não quiser que apareçam no calendário do Pipedrive.
Por que isso importa: deixada no padrão em um número movimentado, a atividade do WhatsApp pode abafar ligações e reuniões agendadas na visão de calendário. Equipes que usam o calendário do Pipedrive para planejar costumam desativar; equipes que o usam como trilha de auditoria mantêm ativo.
Etapa 7: Responda de dentro do Pipedrive
Abra uma Pessoa ou um Negócio e use o painel do WhatsApp para ler o tópico e responder sem sair do CRM. Os modelos de mensagem estão disponíveis no mesmo painel, e você pode enviar mensagens de WhatsApp pelo Pipedrive como parte do seu fluxo de trabalho normal.
Em um número conectado por QR, essas respostas são de texto livre. Você escreve o que quiser, com suas próprias palavras, sem modelo aprovado: os modelos continuam disponíveis para iniciar uma conversa, não para responder a ela. Ferramentas construídas sobre a API do WhatsApp Business funcionam ao contrário, e é por isso que as respostas delas tantas vezes soam como carta padrão.
Por que isso importa: a sincronização sozinha ainda obriga os vendedores a trocar de janela para responder. É responder ali mesmo que realmente tira o WhatsApp da barra de abas.
Veja na prática: mensagens do WhatsApp sincronizando dentro do Pipedrive — uma demonstração curta do painel, do registro de atividade e de uma resposta enviada a partir do negócio.
Problemas comuns de sincronização e como resolvê-los
Algumas conversas sincronizam e outras não. Grupos de visibilidade ou conjuntos de permissões estão limitando o que o usuário conectado consegue ver. Conecte com uma conta de administrador e verifique Grupos de visibilidade e Conjuntos de permissões no Pipedrive.
As mensagens caem na Pessoa errada, ou aparece uma duplicata. Já existem registros de Pessoa duplicados no Pipedrive. Quando duas Pessoas compartilham um número, a etapa de correspondência não consegue decidir qual prevalece.
Remova as duplicatas no Pipedrive primeiro. A correspondência da integração tolera formatos, então quase sempre se trata de duplicatas preexistentes e não de um problema de formatação.
As mensagens vão para o Negócio errado. Por padrão, o alvo é o Negócio ativo mais recente. Fixe a conversa, como na etapa 5.
Uma mensagem enviada pelo Pipedrive não aparece no feed. Normalmente é o estado da conexão, e não a mensagem em si. Verifique se a conexão está ativa e autorizada por uma conta de administrador e depois consulte o registro de sincronização da conversa.
Nada sincroniza desde determinada data. A conexão do espaço de trabalho caiu ou perdeu privilégios de administrador. Reconecte e confirme as permissões.
Contatos pessoais aparecendo como Pessoas do Pipedrive. A adição automática ficou ativa em um número que também trata de conversas pessoais. Veja a etapa 4.
Há mais detalhes na central de ajuda do Pipedrive e um panorama mais amplo de armadilhas de processo no nosso guia para evitar os erros mais comuns entre WhatsApp e Pipedrive.
Como verificar se a sincronização está funcionando
Um teste de 60 segundos, antes de confiar nela com negócios reais:
- Envie uma mensagem de WhatsApp de um número que não existe no Pipedrive.
- Confirme que aparece uma nova Pessoa com esse número.
- Confirme que a mensagem aparece como atividade nessa Pessoa.
- Se Action on New Chat estiver configurado para criar um Negócio ou Lead, confirme que o registro foi criado no funil esperado.
- Fixe a conversa em outro Negócio, envie outra mensagem e confirme que ela cai lá.
- Responda de dentro do Pipedrive e confirme que a mensagem chega ao telefone.
Onde olhar quando uma etapa falha: abra o registro de sincronização da conversa. Ele mostra para onde cada mensagem foi encaminhada e por quê, e resolve a maioria dos problemas mais rápido do que conferir no Pipedrive.
Indo além: acesso de agentes de IA aos mesmos dados
Quando WhatsApp e Pipedrive passam a compartilhar uma camada de dados, a pergunta natural é se um agente de IA pode agir sobre ela. O MCP do WhatsApp conecta seu espaço do WhatsApp ao Claude, ChatGPT, Cursor ou ao seu próprio framework de agentes: navegar por conversas, redigir respostas, aplicar etiquetas e atribuir atendimentos a partir de um prompt. O Pipedrive oferece o próprio MCP, então os dois se complementam bem para equipes que constroem fluxos de venda com agentes.
Perguntas frequentes
Quanto tempo leva para configurar a sincronização entre WhatsApp e Pipedrive?
Cerca de cinco minutos. Conectar o WhatsApp é escanear um QR code, autorizar o Pipedrive é instalar um aplicativo, e o tempo restante vai para decidir o que as novas conversas devem criar. Não há desenvolvimento nem acesso a API envolvidos.
Preciso de acesso de administrador no Pipedrive?
Sim. As permissões de administrador são necessárias para instalar o aplicativo no nível da empresa, e a visibilidade da conta conectada determina quais registros a sincronização consegue alcançar. Instalar com um usuário restrito causa sincronização parcial.
Ele sincroniza o histórico de conversas ou apenas as mensagens novas?
Como você conecta sua conta de WhatsApp existente em vez de registrar um número novo, suas conversas vêm junto. O histórico fica disponível no espaço de trabalho da TimelinesAI, e as mensagens em andamento são registradas no Pipedrive a partir da conexão.
O que acontece se um número de WhatsApp não corresponder a nenhum contato do Pipedrive?
Uma nova Pessoa é criada automaticamente a partir desse número, desde que Auto-Add Chat as New Person esteja ativo. O que acontece além da Pessoa depende da sua configuração em Action on New Chat: um Negócio, um Lead ou nada.
Em qual Negócio uma conversa é sincronizada se um cliente tiver vários?
No Negócio ativo mais recente. Os fechados e mais antigos são ignorados. Para mudar isso, fixe a conversa em um Negócio específico.
Preciso de modelos de mensagem aprovados para responder?
Não. Em um número conectado por QR você responde com texto livre, exatamente como no WhatsApp. Os modelos continuam disponíveis para iniciar novas conversas. Isso difere das ferramentas baseadas na Business API, onde é exigido um modelo aprovado para enviar fora de uma janela de conversa aberta.
Posso usar meu número atual do WhatsApp ou preciso de uma conta Business API?
Qualquer tipo de conta funciona: WhatsApp comum, o aplicativo WhatsApp Business, a API do WhatsApp Business ou Coexistence. Sem migração de número e sem excluir uma conta de WhatsApp existente. Isso difere das ferramentas construídas exclusivamente sobre a Business API, onde um número existente precisa ser cancelado antes de poder ser usado.
Posso sincronizar conversas em grupo do WhatsApp com o Pipedrive?
Sim, pela configuração Import Messages from Groups. Um grupo é associado pelo seu ID de grupo em vez de um número de telefone e sincronizado com uma Pessoa do Pipedrive com o nome do grupo. Vem desativado por padrão, o que costuma ser a escolha certa a menos que os tópicos de grupo façam parte real do seu processo de vendas.
Comece agora
Conecte sua conta de WhatsApp existente ao Pipedrive em cerca de cinco minutos, sem acesso a API e sem migrar o número. Comece um teste gratuito da integração entre WhatsApp e Pipedrive — sem cartão de crédito.