Como o Tintim se conecta ao seu WhatsApp
Introdução
No Tintim, as conexões de WhatsApp são a forma como a nossa plataforma se comunica com sua conta do WhatsApp Business. São essas conexões que permitem que o Tintim consiga ler as mensagens trocadas entre seu time comercial e os leads/clientes para identificar origens, rastrear vendas e registrar eventos importantes.
Há diferentes maneiras de integrar o WhatsApp ao Tintim, dependendo de como cada negócio usa o aplicativo. Por isso, o Tintim oferece três tipos de conexão:
- Conexão com plataformas de atendimento, indicada para quem utiliza a API Oficial através de plataformas de atendimento e não tem acesso à conta de WhatsApp através do aplicativo WhatsApp Business no celular, ou através de WhatsApp Web e WhatsApp Desktop.
- Conexão Coexistence, um método de conexão oficial da Meta que permite ter acesso à conta WhatsApp através do aplicativo WhatsApp Business no celular, WhatsApp Web e WhatsApp Desktop.
- Conexão Lite, uma alternativa prática e leve para quem não usa API Oficial e não deseja utilizar a integração Coexistence.
Tipos de conexão disponíveis
Conexão com número de API Oficial (integração com plataforma de atendimento)
Essa integração permite que o Tintim receba informações automaticamente da sua plataforma de atendimento usando a API Oficial do WhatsApp.
Na prática, sempre que algo acontece no atendimento, por exemplo, um lead chama no WhatsApp, uma conversa é criada ou uma mensagem é enviada, a plataforma avisa o Tintim em tempo real através de webhooks.
Com isso, o Tintim consegue rastrear leads, identificar origem, acompanhar a jornada e registrar eventos, tudo de forma automática.
Tecnicamente, a integração funciona assim:
- A plataforma de atendimento (conectada via API Oficial do WhatsApp) dispara webhooks sempre que determinados eventos acontecem.
- Esses webhooks são enviados para um endpoint do Tintim.
- O Tintim recebe e processa dados de mensagem recebida ou enviada
Tudo acontece em tempo real, sem ações manuais.
Para que a integração funcione corretamente, é necessário:
1. Plataforma que utiliza a API Oficial compatível
- A plataforma de atendimento precisa usar a API Oficial do WhatsApp
- E permitir o envio de webhooks com conteúdo das mensagens
- A plataforma deve conseguir disparar webhooks para eventos de mensagem recebida e mensagem enviada
2. Conta Tintim configurada
No Tintim, é necessário:
- Ter uma Conta criada
- Preencher o formulário para abertura da tarefa ao time de Integrações (nosso time é o resposável por fazer toda a parte técnica, e você usuário do Tintim será apenas notificado que sua conta já está conectada)
- Nosso time fará os testes necessários para garantir que os eventos e mensagens estão chegando corretamente
Conexão Coexistence
A Coexistence (ou Coexistência) é um recurso oficial da Meta que permite que você use o mesmo número de WhatsApp Business de duas formas ao mesmo tempo:
- No aplicativo WhatsApp Business no celular, como você já usa normalmente, para conversar diretamente com clientes.
- Em uma plataforma comercial integrada à API do WhatsApp, como o Tintim, para metrificar o atendimento.
Em outras palavras: a Coexistence cria um modo híbrido, onde o mesmo número funciona tanto no aplicativo quanto dentro de uma plataforma comercial, sem precisar escolher entre um ou outro (ou ficar preso apenas à plataforma de atendimento, no caso do número de API Oficial).
Para que a integração funcione corretamente, é necessário:
Ao ativar a Coexistence, você realiza o processo de vinculação oficial do número do WhatsApp com a Meta, através de um fluxo chamado Embedded Signup (vinculação com o Meta Ads). Esse processo consiste basicamente em:
- Escolher o número existente do seu WhatsApp Business.
- Escanear o QR Code de vinculação fornecido pelo Tintim, oficialmente da Meta.
- Autorizar a conexão entre a sua conta do WhatsApp Business e a conta comercial no Business Manager da Meta Ads.
- Aguardar a sincronização — o WhatsApp faz um alinhamento técnico que pode durar algumas horas.
Após isso, você poderá:
- Continuar respondendo clientes normalmente pelo app
- Usar o Tintim para visualizar e metrificar conversas vindas de tráfego pago
- Seu número torna-se um número de API Oficial, apenas homologado pelo Meta Ads, mas sem os custos adicionais de envio de mensagem via template ou janela de conversas de 24 horas, por exemplo.
Conexão Lite (QR Code do WhatsApp Web)
No WhatsApp Lite, o Tintim se conecta ao WhatsApp da empresa usando um QR Code, da mesma forma que o WhatsApp Web funciona no navegador, por exemplo.
Isso significa que o Tintim espelha o WhatsApp que já existe no celular.
As mensagens continuam sendo enviadas e recebidas normalmente pelo WhatsApp, e o Tintim apenas acompanha as conversas para transformar essas interações em dados de rastreio.
Na prática:
- O cliente conversa normalmente no WhatsApp
- O atendente responde como já está acostumado
- O Tintim lê essas mensagens e registra origem do lead, etapas da jornada, eventos de conversão e valor de venda (se desejar)
Para que a integração funcione corretamente, é necessário:
- O usuário escaneia um QR Code dentro do Tintim, semelhante ao vínculo com o WhatsApp Web
- O WhatsApp do celular autoriza a sessão
- O Tintim passa a observar mensagens recebidas e enviadas
Como escolher a conexão ideal ao Tintim para seu negócio
Conexão com número de API Oficial (integração com plataforma de atendimento)
Vantagens
- A conexão do WhatsApp com a plataforma de atendimento é 100% oficial
- A conexão da plataforma de atendimento com o Tintim é segura através de integração externa que utiliza webhooks da plataforma de atendimento
- Não tem nenhuma influencia nos atendimentos do dia a dia ou qualquer interferência na plataforma de atendimento
Desvantagens
- Configuração mais técnica e realizada pelo nosso time de integrações, ou seja, a conexão não é instantânea para começar (leva até 5 dias úteis para conexões já conhecidas)
- Configurações manuais para rastrearmos leads oriundos de campanhas de mensagem do Meta Ads
Quando usar?
Quando seu número de WhatsApp é uma API oficial e está vinculada a uma plataforma de atendimento, ou seja, você não possui o número atrelado a um celular para conectar o Tintim via QR Code (conexão Lite)
Como conectar o Tintim à API Oficial do WhatsApp
Você precisa acessar o onboarding de conexões do Tintim (ao tentar conectar-se com o WhatsApp, você é redirecionado para este onboarding de conexões) e preencher o formulário com as informações pedidas. Em até 5 dias úteis nosso time de suporte entrará em contato para informá-lo sobre a conexão
Conexão Coexistence
Vantagens
- Conexão do WhatsApp com o Tintim imediata
- Conexão do WhatsApp com o Tintim é 100% oficial da Meta
- Número homologado oficialmente ao Meta Ads
- O uso do WhatsApp Businesse no celular continua normalmente
- Permanece o histórico das conversas no WhatsApp Businesse no celular
- Rastreio 100% automático de leads oriundos de campanhas de mensagem do Meta Ads
- Não tem nenhuma influencia nos atendimentos do dia a dia ou qualquer interferência no WhatsApp do celular
Desvantagens
- Regras rígidas da Meta quanto a disparos em massa ou qualquer outra ação que viole as políticas do WhatsApp
- Quando conectado via Coexistence não é possível ter conexões não oficiais no Whatsapp
- Possibilidade de ter o número restrito por até 24 horas após a conexão
- Isso se deve pois o WhatsApp faz uma verificação no histórico de utilização do número quase que instanteneamente após a conexão.
Quando usar?
- Quando empresas precisam do WhatsApp no celular
- Quando a empresa quer o número de API oficial, mas sem abandonar o app do WhatsApp no celular/desktop
Como conectar o Tintim ao seu WhatsApp Business através do método Coexistence?
- Clique aqui para acessar o tutorial de conexão
- E caso queira entender os erros mais comuns da Meta sobre conexão Coexistence, clique aqui
Conexão Lite (QR Code do WhatsApp Web)
Vantagens
- Conexão do WhatsApp com o Tintim imediata
- Facilidade de conectar (apenas escanear e pronto)
- Não exige verificação na Meta ou provedor oficial de WhatsApp
- Não exige vínculo com BM (Business Manager) ou WABA (WhatsApp Business API)
- Rastreio 100% automático de leads oriundos de campanhas de mensagem do Meta Ads
- Excelente para provar o valor da sua operação em tráfego pago e do Tintim em um curto período de tempo.
- Não tem custo (ao contrário do número de API Oficial)
Desvantagens
- Menor estabilidade frente a conexão Coexistence ou API Oficial
- Pode acontecer de cair a conexão com maior frequência ou se o celular desconectar
- Risco maior de restrição ou bloqueio se usado incorretamente
Quando usar?
- Quando o usuário/cliente quer implementar o Tintim sem complexidade (o cliente precisa apenas escanear o QR Code e ver funcionando)
- Quando é necessário rastrear conversas agora, não semana/mês que vem
- Quando empresas que não tem número de API Oficial vinculada ao atendimento do cliente
- Quando o cliente não tem a necessidade de muitos atendentes simultâneos
- Quando o cliente quer demonstração de valor rápido, sem a necessidade de um onboarding extenso
- Quando clientes de negócio local que não tem complexidade na operação (muitos fluxos de atendimento e/ou automações)
Comportamento e limitações
Conexão com número de API Oficial (integração com plataforma de atendimento)
Na API Oficial do WhatsApp, todas as mensagens passam por regras definidas pela própria Meta, ou seja, o recebimento de mensagens e identificação da origem ocorre quando:
- O lead envia uma mensagem pré-programada para o WhatsApp da empresa
- A mensagem chega primeiro na plataforma de atendimento, e essa plataforma é responsável pelo envio do conteúdo da conversa para o Tintim
- O Tintim não interfere no envio ou nas automações da plataforma de atendimento, apenas recebe os dados gerados pelas interações através da integração que o time do Tintim realizou internamente
Limitações
- As origens das conversas oriundas de campanhas de mensagem (click to whatsApp) só serão capturadas caso ocorra, num primeiro momento, a criação das frases dentro do Tintim que serão alocadas dentro do Modelo de Mensagem, no anúncio do Meta Ads.
- Em alguns casos, o Tintim receberá apenas as mensagens enviadas pelo Lead, e não receberá todo o conteúdo da conversa, ou seja, todas as mensagens enviadas e recebidas.
- Neste caso o Tintim identifica a origem da conversa, mas não é possível alterar a etapa da jornada via envio de termo-chave
- O Tintim depende totalmente dos webhooks enviados pela plataforma. Se a plataforma não enviar o conteúdo da mensagem ou enviar dados incompletos, isso pode influenciar no exercício de nossas funcionalidades.
- Algumas plataformas de atendimento exigem upgrade ao plano pago ou configurações avançadas para liberar webhooks completos
Conexão Coexistence
Na conexão Coexistence, o seu número é homologado diretamente ao Meta Ads, tornando-se um número oficial do WhatsApp, porém sem a limitações de API Oficial, como por exemplo:
- Aprovar templates de marketing ou utilidade antes do envio aos clientes
- Ter custo ao enviar estes templates
- Ter limitação de janela de 24 horas para enviar mensagens livres
Sendo assim, o recebimento de mensagens e identificação da origem ocorrem normalmente sem a necessidade de uma plataforma de atendimento ou automação externa.
Limitações
- Clique aqui para saber os motivos pelos quais o whatsApp pode sofrer restrição ou bloqueio após ativar a conexão coexistence
- Você só pode ter uma plataforma comercial conectada por vez. Isso significa que, se o seu número já estiver vinculado via Coexistence a outra plataforma, você não conseguirá conectar o mesmo número ao Tintim até que o vínculo anterior seja removido. Mas em alguns casos não é necessário removê-lo. Entre em contato com nosso suporte para entender como é possivel integrar seu número de WhatsApp.
- É necessário que o número esteja atrelado a um WhatsApp Business para que a conexão ocorra (e não ao WhatsApp normal).
Conexão Lite (QR Code do WhatsApp Web)
Na conexão Lite, todas as mensagens enviadas e recebidas chegam ao Tintim (inclusive os metadados destas mensagens, que responsáveis pelo rastreio 100% automático de leads oriundos das campanhas de mensagem, ou seja, leads via click to whatsApp. Portanto não há necessidade de:
- Pré-programar uma mensagem dentro do Tintim e coloca-la no modelo de mensagem do anúncio.
- A mensagem chega no WhatsApp sem nenhuma interferência do Tintim, ou seja, não há risco de interferir na produtividade do atendimento/time comercial.
- As mudanças de etapa do funil de compra via termo-chave ocorrem sem maiores problemas.
Limitações
- Dependência total da sessão do QR Code, ou seja, caso as 4 instâncias estejam sendo utilizadas, é necessário a desconexão de uma delas para conectar-se ao Tintim
- Caso ocorre uma desconexão ou caso o Tintim não esteja atualizando em tempo real a chegada de conversas, é necessário ler um novo QR Code
- Caso ocorra uma troca de celular, será necessário ler um novo QR Code
- É importante manter o app do WhatsApp no celular sempre atualizado para que não ocorram divergências de dados ou dificuldade de conexão.
- Como a conexão Lite não é uma conexão oficial da Meta/Whatsapp, o funcionamento do Tintim está sujeito à restrições, bloqueios ou mudanças/atualizações de comportamento do WhatsApp.
Caso ocorra desconexão, o que fazer?
- Não se preocupe! Basta ler um novo QR Code e o Tintim fará o reprocessamento das conversas e não haverá perda de mensagens no período que o WhatsApp ficou desconectado.
Perguntas frequentes
Conexão com número de API Oficial (integração com plataforma de atendimento)
- Não sei como fazer a integração, o que fazer?
Não se preocupe, a integração é realizada pelo nosso time! Basta você preencher o formulário com as informações necessárias e aguardar a conclusão por parte do nosso time. - A integração pode ser feita com o cliente via call?
Como o processo envolve análise técnica da plataforma de atendimento, a integração acontece de forma assíncrona, garantindo uma avaliação mais precisa. - O cliente não quer passar os dados de acesso, tem como fazer essa integração de outra maneira?
Para realizar a integração corretamente, é necessário o acesso temporário à ferramenta, utilizado apenas para fins técnicos e em conformidade com a LGPD. Mas vale entrar em contato com o suporte do Tintim caso seja realmente impossível o acesso a plataforma por terceiros. - Por que minhas campanhas de mensagem do Meta ADS não estão sendo rastreadas automaticamente na API Oficial?
Na API Oficial, o rastreio de campanhas de mensagem não é 100% automático, pois os dados chegam ao Tintim por meio da plataforma de atendimento. Para que a campanha seja identificada, é necessário realizar a criação da mensagem rastreável que permite ao Tintim reconhecer a origem da conversa e coloca-la no modelo de mensagem do seu anúncio.
Conexão Coexistence
- O que é Coexistence?
Coexistence permite usar o mesmo número de WhatsApp no celular (app) e via API Oficial ao mesmo tempo, mantendo as duas conexões ativas.
É um recurso oficial da Meta que permite que você use o mesmo número de WhatsApp Business de duas formas ao mesmo tempo: no aplicativo WhatsApp Business, como você já usa normalmente e em uma plataforma comercial integrada à API do WhatsApp — como o Tintim — para metrificar o atendimento.
Em outras palavras: a Coexistence cria um modo híbrido, onde o mesmo número funciona tanto no aplicativo quanto dentro de uma plataforma comercial, sem precisar escolher entre um ou outro. - Como fazer a conexão?
Para conectar via coexistence você pode acessar as instruções deste tópico: clique aqui - Como desconectar o número do cliente?
Para desconectar a Coexistence ao Tintim, baste seguir as orientações deste tópico: clique aqui - O suporte pode desconectar internamente da Coexistence?
Não é possível, é necessário realizar o passo a passo de desconexão dentro do Whatsapp, conforme o item 3. - Por que meu cliente não consegue mais editar/apagar uma mensagem enviada ao lead?
Como o número se torno homologado oficialmente pela Meta, mensagens enviadas não podem ser editadas ou apagadas. Essa é uma limitação definida pela própria Meta. - Já tenho uma ferramenta de atendimento conectada via Coexistence, posso conectar o Tintim?
Sim. É possível conectar o Tintim desde que a ferramenta dispare webhooks com o conteúdo das mensagens. Nesse caso, a integração acontece semelhante a uma conexão de API Oficial, recebendo os dados via webhook. - Ao conectar o Tintim via Coexistence, a conexão com minha outras ferramentas caiu. Por quê?
Isso acontece porque a Coexistence é uma conexão oficial. Quando ela está ativa, o WhatsApp não permite manter conexões não oficiais em paralelo (conexões Lite). Por isso, ao conectar o Tintim via Coexistence, outras conexões que não sejam oficiais podem ser automaticamente desconectadas.
Mas é possível conectar-se novamente ao WhatsApp web ou WhatsApp Desktop App, caso necessário.
Conexão Lite (QR Code do WhatsApp Web)
- O uso do WhatsApp Business pode atrapalhar minha operação?
Não. O WhatsApp Business funciona normalmente com o Conexão Lite, assim como o WhatsApp normal. O Tintim apenas observa e espelha as conversas, sem interferir no uso do aplicativo. - Ao conectar com o Tintim meu número sofreu restrição ou bloqueio. Foi por causa do Tintim?
O Tintim não aplica restrições nem bloqueios. Qualquer limitação é definida pelo próprio WhatsApp, com base em regras de uso, volume de mensagens e comportamento da conta.
Por ser uma conexão lite, ou seja, uma conexão não-oficial do Meta/WhatsApp, existem casos que isto pode acontecer, mas historicamente é baixa a frequência. De qualquer maneira, fique alerta a:
- Envio excessivo de mensagens, independente do intervalo de tempo;
- Automação agressiva vinculada ao WhatsApp;
- Uso que inflingi as políticas do WhatsApp.