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.