[Extensão] Como enviar mensagens ativas no WhatsApp pelo HubSpot

1. Introdução

2. Funcionalidades

3. Pré-requisitos

4. Instalação e configuração

5. Disparo de mensagens em massa

6. Disparo de mensagem individual

7. Acompanhamento dos disparos

8. Suporte

Descrição breve: Dispare mensagens ativas no WhatsApp pela Blip direto do HubSpot, em massa por Fluxos de trabalho ou individualmente no registro do contato, com modelos aprovados pela Meta.

Introdução

A extensão HubSpot: Disparo de mensagens ativas conecta sua conta HubSpot ao Blip e permite enviar mensagens ativas de WhatsApp sem sair do HubSpot. Você dispara para vários contatos de uma vez a partir de um Fluxo de trabalho ou envia individualmente pelo registro de um contato.

Por exemplo, quando um lead preenche um formulário e entra em um fluxo de trabalho no HubSpot, a extensão envia um modelo de WhatsApp aprovado com o nome do lead já preenchido a partir das propriedades do contato, e registra o disparo na linha do tempo desse contato.

Funcionalidades

• Disparo de mensagens ativas de WhatsApp em massa, a partir dos Fluxos de trabalho do HubSpot.

• Disparo individual pelo cartão Blip no registro de um contato.

• Uso de modelos (templates) de WhatsApp aprovados pela Meta, com variáveis, mídia e botão dinâmico.

• Preenchimento automático das variáveis do modelo a partir de propriedades do contato no HubSpot.

• Redirecionamento do contato para um bot ou fluxo específico após o envio.

• Registro automático de cada disparo na linha do tempo do contato no HubSpot, com o status (Disparada, Recebida, Lida ou Falha).

Suportada no seguinte canal: WhatsApp.

Pré-requisitos

Antes de começar, garanta que você tem:

• Um bot na Blip com um canal de WhatsApp conectado, no próprio bot ou no Roteador ao qual ele pertence.

• Uma conta HubSpot com permissão de administrador para instalar e autorizar aplicativos.

• Um modelo (template) de WhatsApp aprovado pela Meta e disponível no bot.

• Uma propriedade de contato no HubSpot com o telefone preenchido em formato internacional (por exemplo, +5511999999999) ou no padrão brasileiro válido.

• Acesso aos Fluxos de trabalho do HubSpot, caso vá usar o disparo em massa.

Instalação e configuração

Instale a extensão no bot que fará os disparos. Esse bot precisa ter um canal de WhatsApp conectado, seja diretamente, seja através do Roteador ao qual ele pertence. A extensão localiza o número de WhatsApp automaticamente.

1. Acesse a extensão HubSpot: Disparo de mensagens ativas na Blip Store.

2. Clique em Instalar. A extensão passa a aparecer na lista de instaladas do bot.

3. Abra a extensão para iniciar a configuração.

4. Clique em Entrar com HubSpot. Uma janela de autorização do HubSpot abre.

5. Na janela, entre na sua conta HubSpot, selecione a conta que será integrada, revise as permissões e clique em Conectar aplicativo. A janela fecha e a conta aparece conectada na extensão.

Se a janela de autorização não abrir, verifique se o navegador está bloqueando pop-ups. Confirme também se o bot mostrado na extensão é o que fará os disparos. Para trocar de conta HubSpot, clique em Entrar com outra conta e repita o processo.

Nota: ao entrar com o HubSpot você aceita os termos de uso e a política de privacidade da Wiv, exibidos na tela de login da extensão.

Nota: para enviar mensagens ativas você precisa de um modelo de WhatsApp aprovado pela Meta e disponível no bot selecionado. O modelo pode conter texto, variáveis, mídia (imagem, vídeo ou documento) e botões, conforme o tipo de disparo.

Disparo de mensagens em massa

O disparo em massa acontece dentro dos Fluxos de trabalho do HubSpot. Monte o fluxo como preferir e, no ponto em que quiser enviar o WhatsApp, adicione a ação da extensão. A ação funciona tanto em fluxos novos quanto em fluxos que já existem. Se ainda não criou nenhum fluxo, consulte a documentação de fluxos de trabalho do HubSpot.

Adicionar a ação de envio

1. No fluxo de trabalho, clique no ícone + para adicionar uma nova ação.

2. Abra a seção Aplicativos conectados e localize o app Blip (em contas mais antigas, pode aparecer com o nome anterior da Wiv, Blip - White Wall).

3. Selecione a ação Enviar mensagem WhatsApp.

Configurar o disparo

Preencha os campos da ação:

• Bot disparador: o bot da Blip que executa o envio.

• Número WhatsApp do contato: a propriedade do contato que contém o telefone.

• Modelo de mensagem: apenas modelos aprovados no WhatsApp aparecem na lista.

• Variáveis separadas por linha: informe uma variável por linha, na mesma ordem do modelo. A primeira linha substitui a primeira variável, a segunda linha a segunda variável, e assim por diante. O número de linhas precisa bater com o número de variáveis do modelo.

• Link do arquivo de mídia: URL pública da imagem, vídeo ou PDF, quando o modelo usa mídia.

• Variável associada ao botão: valor enviado ao botão dinâmico, quando o modelo tem botão.

• Posicionar usuário no bot e Posicionar usuário no fluxo: opcionais, para direcionar o contato a um bot ou estado de fluxo após o envio.

Com o bloco configurado, clique em Salvar e depois em Revisar e publicar para ativar o fluxo. Crie um fluxo simples com um contato de teste antes de publicar em produção.

Atenção: todos os campos obrigatórios do modelo precisam estar preenchidos, e a quantidade e a ordem das variáveis precisam corresponder exatamente ao modelo. Caso contrário, a mensagem não é enviada.

Disparo de mensagem individual

Você também pode enviar uma mensagem ativa para um único contato, direto pelo registro dele no HubSpot.

1. No HubSpot, acesse CRM > Contatos e abra o registro do contato que vai receber a mensagem.

2. Na lateral direita, localize o cartão Blip. Se ele não estiver visível, pode estar recolhido ou precisar ser adicionado à visualização do registro.

3. No cartão Blip, clique em Enviar mensagem ativa. Uma janela abre com o formulário de envio.

4. Selecione o bot disparador.

5. Selecione a propriedade que contém o telefone, escolha o modelo de mensagem, preencha as variáveis e informe o link da mídia quando o modelo pedir.

6. Se quiser, ative Posicionar usuário no bot e escolha o bot e o fluxo de destino.

7. Clique em Enviar. Depois do envio, confirme que a mensagem chegou ao contato correto.

Limitações do envio individual

O envio individual pelo cartão suporta texto, variáveis e imagem no cabeçalho do modelo. Modelos com botão dinâmico, vídeo ou documento devem ser disparados pelo Fluxo de trabalho, que aceita esses recursos. Se o modelo não aparecer ou não for aceito no cartão, use o fluxo de trabalho ou um modelo de texto compatível.

Acompanhamento dos disparos

Cada disparo é registrado automaticamente na linha do tempo do contato no HubSpot como uma comunicação de WhatsApp, com o status atualizado (Disparada, Recebida, Lida ou Falha). A atualização roda em segundo plano, então o status pode levar alguns minutos para aparecer.

Na Blip, os disparos criam campanhas em Growth, onde você acompanha a audiência e o andamento de cada envio.

No campo Ações, baixe uma planilha com os detalhes dos disparos. O arquivo mostra o destinatário, o status do envio e os erros ocorridos no processamento.

Quando um envio falha, revise primeiro o telefone do contato, o modelo selecionado e o preenchimento das variáveis. As causas mais comuns são:

• Telefone vazio, inválido ou fora do formato internacional.

• Modelo inativo, reprovado ou não encontrado no bot.

• Quantidade ou ordem de variáveis diferente do modelo do WhatsApp.

• Link de mídia inválido ou não público.

• Bot sem canal de WhatsApp ativo ou sem as permissões necessárias.

• Extensão conectada a um portal HubSpot diferente do que está executando o fluxo.

Ajuste os dados e faça um novo teste de envio.

Suporte

Em caso de dúvidas ou problemas na configuração, fale com o time de suporte da Wiv pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃