LetsBot Menu
Começar Português Idioma

Meta Business Partner Empresa registrada no Reino Unido

Idioma

Guia de configuração · HubSpot

Guia de configuração da integração HubSpot + WhatsApp

Este guia mostra, passo a passo, como instalar e configurar o app do LetsBot no HubSpot, até que sua primeira mensagem automática no WhatsApp seja disparada pelos eventos do seu CRM.

A configuração leva cerca de cinco minutos e não exige código. Esta página é pública e não requer login.

1. Antes de começar

  • Uma conta no LetsBot. Você pode começar com um teste grátis de 14 dias, sem cartão de crédito.
  • Um número do WhatsApp Business conectado ao LetsBot, já que as mensagens são enviadas pela API oficial do WhatsApp Business.
  • Uma conta do HubSpot em que você tenha permissão para instalar apps (um administrador da conta).
  • Números de telefone válidos em formato internacional nos seus contatos do HubSpot, para que o app consiga identificar o destinatário.

2. Instale o app e conecte o HubSpot

A conexão é feita pelo OAuth do HubSpot. Você nunca precisa copiar ou colar uma chave de API.

  1. Entre no painel do LetsBot. letsbot.net/login
  2. Abra a seção Integrações e escolha HubSpot.
  3. Clique no botão Conectar HubSpot. Você será levado à tela de autorização OAuth do HubSpot.
  4. Escolha a conta que deseja conectar, revise as permissões e aprove-as.
  5. Você volta automaticamente ao painel do LetsBot com a conexão concluída, e os principais gatilhos já estão ativados e prontos para personalizar.

3. Permissões solicitadas e por quê

O app solicita apenas as permissões de que seus recursos realmente precisam. Esta é a lista completa:

Escopo Por que é necessária
crm.objects.contacts.read Ler as propriedades do contato (nome, telefone, e-mail) para identificar o destinatário e preencher as variáveis da mensagem.
crm.objects.contacts.write Criar um contato quando chega uma mensagem do WhatsApp de um número desconhecido e registrar as respostas como notas na linha do tempo do contato.
crm.objects.deals.read Ler as propriedades do negócio (nome, etapa, valor, data de fechamento) e o contato associado, para acionar os gatilhos de negócio.
tickets Ler as propriedades do ticket (assunto, conteúdo) e o contato associado, para acionar o gatilho de ticket.

O app nunca modifica seus negócios ou tickets e nunca exclui nenhum registro. As únicas gravações que ele faz são criar um contato quando chega uma mensagem de um número desconhecido e adicionar uma nota da conversa à linha do tempo desse contato.

4. Escolha um evento de gatilho

Cada evento é independente: você ativa apenas o que precisa e pode desativar o restante a qualquer momento. Nenhuma mensagem é enviada para um evento que você mesmo não tenha ativado.

Evento Tipo de assinatura do HubSpot O que acontece
Contato criado contact.creation Envia uma mensagem de boas-vindas no momento em que um novo contato é adicionado no HubSpot.
Etapa do ciclo de vida do contato alterada contact.propertyChange Envia uma mensagem quando o contato passa para uma nova etapa do ciclo de vida (por exemplo, Marketing Qualified Lead).
Negócio criado deal.creation Envia uma mensagem ao contato associado ao negócio assim que ele é criado.
Etapa do negócio alterada deal.propertyChange Envia uma atualização quando o negócio passa para outra etapa do seu funil.
Ticket criado ticket.creation Avisa o cliente no WhatsApp que o ticket dele foi recebido e está sendo tratado.

5. Escreva a mensagem ou escolha um modelo

Para cada evento, você pode escrever uma mensagem de texto rápida ou escolher um modelo avançado de WhatsApp com suporte a botões, listas e mídia. Os dados do HubSpot são inseridos na mensagem por meio destas variáveis:

Variável Valor
{CONTACT_FIRSTNAME} Primeiro nome do contato
{DEAL_NAME} Nome do negócio
{DEAL_STAGE} Etapa do negócio
{DEAL_AMOUNT} Valor do negócio
{TICKET_SUBJECT} Assunto do ticket
{TICKET_CONTENT} Conteúdo do ticket

As mensagens suportam árabe e inglês. Se o idioma do contato estiver definido no LetsBot, a versão correspondente é enviada; caso contrário, a versão em inglês é usada por padrão.

6. Ative e teste

  1. Ative a chave ao lado do evento que você configurou e salve.
  2. No HubSpot, crie um registro real desse tipo — por exemplo, um novo contato — usando seu próprio número de telefone.
  3. Uma mensagem no WhatsApp chega até você em segundos. Você pode acompanhar o status de entrega no registro de mensagens dentro do LetsBot.

7. Respostas registradas de volta no HubSpot

Quando o cliente responde no WhatsApp, o LetsBot registra a resposta como nota na linha do tempo do contato no HubSpot, para que todo o contexto da conversa fique no registro do cliente. Se a resposta vier de um número que você não tem, um contato é criado automaticamente e a nota é registrada nele.

8. Solução de problemas

A mensagem não chegou

  • Verifique se a chave do evento está ativada e salva.
  • Verifique se o contato no HubSpot tem um número de telefone válido em formato internacional; sem ele, não é possível identificar o destinatário.
  • Verifique se o seu número do WhatsApp Business está conectado e aparece como online no LetsBot.

Os gatilhos de negócio ou de ticket não estão disparando

Os gatilhos de negócio e de ticket dependem de um contato associado, porque a mensagem é enviada a uma pessoa, e não a um registro. Associe o negócio ou ticket a um contato que tenha número de telefone e tente novamente.

A conexão caiu

Isso acontece se o app foi desinstalado dentro do HubSpot ou se a autorização foi revogada. Reconecte pelo painel do LetsBot clicando novamente em Conectar HubSpot.

9. Desconectar e desinstalar

Você pode desconectar a qualquer momento pelo painel do LetsBot, usando o botão de desconectar, ou removendo o app nas configurações de apps conectados da sua conta HubSpot. Assim que a desconexão é feita, todas as mensagens automáticas param imediatamente e o app deixa de ter qualquer acesso aos seus dados.

10. Dados e privacidade

Todos os dados são transmitidos por uma conexão criptografada, e os tokens de acesso são armazenados com criptografia. O LetsBot lê do HubSpot apenas os campos necessários para personalizar a mensagem e identificar o destinatário, e seus dados nunca são compartilhados com terceiros.

Precisa de ajuda com a configuração? Nosso suporte com IA responde 24/7 em qualquer idioma, e nossa equipe humana atende em árabe e inglês para ajudar você a concluir a conexão e enviar sua primeira mensagem.

Comece a conectar agora

A configuração leva cerca de cinco minutos e não exige código.