Pular para o conteúdo
WbizTool

Integrações

GoHighLevel e WhatsApp

Conecte o GoHighLevel (HighLevel) ao WbizTool, e seus workflows enviam mensagens de WhatsApp pelo seu próprio número de WhatsApp. As mensagens de WhatsApp recebidas também podem voltar para o HighLevel, como uma nota, uma tag ou uma tarefa no contato.

Tudo nesta página usa recursos que já existem dos dois lados: os webhooks de workflow do HighLevel e a API de envio de mensagens e os webhooks de mensagens recebidas do WbizTool. Você não instala nada.

Quem pode fazer isso: no WbizTool, um Proprietário cria a chave de API (Chaves de API), e um Proprietário ou Editor configura os webhooks de mensagens recebidas. No HighLevel, alguém que possa editar workflows na subconta os cria. A agência precisa ativar os recursos premium de workflow do HighLevel (veja Antes de começar).

O que você pode fazer#

DireçãoExemploComo
HighLevel → WhatsAppUm formulário é enviado, uma tag é adicionada ou um agendamento é marcado, e o contato recebe uma mensagem de WhatsApp.Uma ação Custom Webhook em um workflow do HighLevel chama a API de envio de mensagens do WbizTool.
WhatsApp → HighLevelUm cliente manda mensagem para o seu número de WhatsApp, e a mensagem é adicionada como nota no contato dele no HighLevel. O contato é criado se ainda não existir.Um número da caixa de entrada do WbizTool envia cada mensagem para um gatilho Inbound Webhook do HighLevel. É preciso ter o add-on Unibox.

Antes de começar#

  • Um número de WhatsApp conectado em Números do WhatsApp, e o WhatsApp Client ID dele (o ID mostrado para o número), por exemplo 678.
  • Uma chave de API do WbizTool de Configurações → Chaves de API. No HighLevel, ela vai em um cabeçalho Authorization: Bearer, então você não precisa do Client ID. Veja Enviar a chave em um cabeçalho.
  • Os recursos premium de workflow do HighLevel. O HighLevel lista Custom Webhook e Inbound Webhook como recursos premium de workflow. Agências em qualquer plano do HighLevel podem ativá-los: no Agency View, acesse Settings → Company e ative Workflow - Premium Features. O HighLevel cobra cada execução premium, e cada subconta recebe 100 execuções premium grátis (uma vez, não todo mês). A agência pode repassar essa cobrança à subconta. Os preços do HighLevel estão na página de ajuda dele.
  • Só para mensagens recebidas: o add-on Unibox em um plano pago ou vitalício do WbizTool (não no teste grátis). Ele custa US$ 20 por mês ou US$ 200 por ano pelos preços de tabela nos EUA para cada número de WhatsApp na caixa de entrada. Um Proprietário o adiciona em Cobrança e planos (veja Add-ons).

Escolha um caminho#

O caminho pelos workflows do HighLevel é o mais curto: o HighLevel chama o WbizTool diretamente, sem nenhuma outra ferramenta no meio. Use uma ferramenta de automação só se os seus workflows já rodam nela.

CaminhoEnviar (HighLevel → WhatsApp)Receber (WhatsApp → HighLevel)Planos necessários
Workflows do HighLevel (recomendado)Ação Custom Webhook → API de envio de mensagensWebhook do WbizTool → gatilho Inbound WebhookRecursos premium de workflow do HighLevel. Receber: o add-on Unibox.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact ou Add TaskUma conta do Zapier. Receber: o add-on Unibox.
MakeAção Webhook do HighLevel → Webhooks do Make → módulo HTTPWebhook do WbizTool → Webhooks do Make → API do HighLevelUma conta do Make. Receber: o add-on Unibox.
n8nAção Webhook do HighLevel → Webhook do n8n → WbizTool Send MessageWebhook do WbizTool → Webhook do n8n → node HighLeveln8n com o community node do WbizTool. Receber: o add-on Unibox.
Pabbly ConnectAção Webhook do HighLevel → gatilho de webhook do Pabbly → requisição API (Pabbly)Webhook do WbizTool → gatilho de webhook do Pabbly → sua etapa do HighLevelUma conta do Pabbly Connect. Receber: o add-on Unibox.

Enviar mensagens de WhatsApp a partir de um workflow do HighLevel#

  1. Abra ou crie um workflow

    Na sua subconta do HighLevel, abra Automation e crie um workflow, ou edite um existente. Dê a ele o gatilho que você quiser, como o envio de um formulário, uma nova tag ou um agendamento marcado.

  2. Adicione a ação Custom Webhook

    Clique em + no ponto em que a mensagem deve sair e depois em Send Data → Custom Webhook (ou pesquise "webhook" nas ações e escolha Custom Webhook). A ação Webhook simples não consegue definir o cabeçalho e o corpo de que esta API precisa.

  3. Configure a requisição

    Defina Event como CUSTOM e Method como POST. Defina a URL como https://wbiztool.com/api/v1/send_msg/. Em Authorization, escolha Bearer Token e cole sua chave de API do WbizTool, ou escolha sem autenticação e adicione o cabeçalho Authorization com o valor Bearer YOUR_API_KEY. Defina Content-Type como application/json.

  4. Cole o corpo

    Cole um dos blocos para copiar e colar em Raw Body e substitua 678 pelo seu WhatsApp Client ID. Use o ícone de tag do HighLevel para adicionar mais campos do contato à mensagem.

  5. Teste e publique

    Salve a ação e publique o workflow. Execute-o em um contato de teste com o seu próprio número de telefone. Cada execução aparece nos logs de execução do workflow. Quando o WbizTool aceita a mensagem, ele responde "status": 1. A mensagem então sai pelo seu número de WhatsApp.

O campo do número de telefone#

Use {{contact.phone_raw}}, não {{contact.phone}}. O {{contact.phone}} do HighLevel é formatado para leitura, como (515) 555-2345, sem o código do país. O {{contact.phone_raw}} é o mesmo número em formato internacional, como +15155552345.

O WbizTool remove o +, os espaços, os hífens e os parênteses para você. Um número escrito com + já inclui o código do país, então você não precisa enviar country_code. Se alguns dos seus contatos foram salvos sem código do país, adicione "country_code": "1" (o código de discagem do seu país) ao corpo. Ele só é adicionado a números escritos sem +. Veja Enviar mensagem → phone.

Blocos para copiar e colar#

URL: https://wbiztool.com/api/v1/send_msg/ · Método: POST · Cabeçalhos: Authorization: Bearer YOUR_API_KEY e Content-Type: application/json

Raw Body da ação Custom Webhook
{
  "whatsapp_client": 678,
  "phone": "{{contact.phone_raw}}",
  "msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}
  • whatsapp_client: o ID do número que envia. Você só pode omiti-lo quando o seu espaço de trabalho tem exatamente um número conectado.
  • msg: até 3.000 caracteres. A formatação do WhatsApp funciona: *bold*, _italic_. Para uma nova linha, digite \n dentro do texto. Uma quebra de linha real deixa o JSON inválido.
  • Imagens e arquivos: os links precisam ser públicos. msg vira a legenda. Veja Enviar imagens e arquivos.
  • expire_after_seconds: se a mensagem não sair dentro desse tempo, por exemplo porque o número foi desconectado, ela é marcada como expirada e não é enviada.
  • Grupos: group_name é o nome exato de um grupo de WhatsApp do qual o seu número participa. Envie group_name ou phone, nunca os dois. Veja Enviar para grupo.

Registrar mensagens de WhatsApp recebidas no HighLevel#

Esta direção precisa do add-on Unibox. Cada mensagem que o seu número de WhatsApp recebe é enviada ao gatilho Inbound Webhook do HighLevel. O workflow então encontra ou cria o contato e adiciona a mensagem como nota, tag ou tarefa. As mensagens não aparecem em nenhum outro lugar do HighLevel.

  1. Crie um workflow com um gatilho Inbound Webhook

    No HighLevel, crie um workflow e escolha o gatilho Inbound Webhook. Copie a URL do webhook que ele mostra.

  2. Aponte o seu número de WhatsApp para ela

    No WbizTool, abra Números da caixa de entrada. Clique em Adicionar número à caixa de entrada, escolha o número e cole a URL do HighLevel em URL do webhook (opcional). Para um número que já está na caixa de entrada, cole-a nas Configurações do webhook do número. Em Mensagens a notificar, marque só Mensagens recebidas. Cada envio é uma execução premium no HighLevel, então deixe Mensagens enviadas desmarcada, a menos que precise delas.

  3. Envie uma mensagem de teste

    De outro celular, envie uma mensagem para o seu número de WhatsApp. Ela é enviada após a próxima verificação, geralmente em um ou dois minutos. No HighLevel, clique em Test Trigger (testar gatilho), escolha a requisição em Mapping Reference e salve o gatilho. Os campos estão listados em Payload.

  4. Pule grupos e números ocultos

    Adicione uma etapa If/Else que só continue quando event for message_received, contact.is_group for false e contact.phone não estiver vazio. O WhatsApp às vezes oculta o número de quem envia, e mensagens de grupo trazem o ID do grupo em vez de um número de telefone.

  5. Encontre ou crie o contato

    Na ação Create/Update Contact, defina Phone como + seguido de contact → phone dos valores do Inbound Webhook. O WbizTool envia o número sem +, e o + indica ao HighLevel que ele inclui o código do país. Você também pode mapear contact → name. É o nome de WhatsApp de quem envia, e ele pode substituir um nome que você editou no HighLevel.

  6. Adicione a mensagem ao contato

    Adicione uma ação Add to Notes (adicionar às notas). Escreva uma nota como "Mensagem de WhatsApp:" e escolha message → content e message → timestamp dos valores do Inbound Webhook. Você também pode adicionar Add Contact Tag (por exemplo whatsapp), uma tarefa ou uma notificação interna para a sua equipe.

  7. Publique

    Publique o workflow e envie outra mensagem de teste.

Valor do Inbound WebhookUse para
contact.phoneO telefone do contato. Adicione + na frente.
contact.nameO nome de WhatsApp de quem envia. Pode estar vazio.
message.contentO texto. Para fotos, mensagens de voz e arquivos, é um rótulo como 📸 Image, e as legendas não são incluídas.
message.timestampQuando a mensagem foi enviada no WhatsApp (ISO 8601, UTC).
message.media.urlUm link de download de uma foto ou arquivo. Ele expira depois de 3½ a 7 dias, então não dependa dele em uma nota.
whatsapp_phoneQual dos seus números a recebeu, se vários números enviam para o mesmo workflow.
eventmessage_received ou message_sent.
  • Só mensagens novas são enviadas, a partir do momento em que o webhook é configurado. Chats antigos não são importados.
  • Um webhook por número. Cada número da caixa de entrada envia para uma URL. Se um Zap do Zapier usa o gatilho Incoming WhatsApp Message para o mesmo número, o Zap assume o webhook enquanto estiver ativado.
  • Responder pelo HighLevel: para responder no WhatsApp a partir do mesmo workflow, adicione a ação Custom Webhook com "phone": "{{contact.phone_raw}}".
  • Mantenha a URL em sigilo. O Inbound Webhook do HighLevel não verifica a assinatura do WbizTool, então qualquer pessoa com a URL pode enviar para ela. Se ela vazar, crie um novo gatilho e cole a URL dele no WbizTool.

Zapier#

O app do HighLevel no Zapier se chama LeadConnector. Ele tem um gatilho, Pipeline Stage Changed (etapa do pipeline alterada). As ações dele incluem Add/Update Contact e Add Task. Veja Integração com Zapier para conectar o WbizTool.

  • Enviar: gatilho LeadConnector Pipeline Stage Changed, depois uma etapa Filter by Zapier para a etapa que você quer e depois WbizTool Send Text-Only WhatsApp Message. Escolha o número em WhatsApp Number, mapeie o telefone do contato em Phone Number e escreva a Message. Para outros eventos do HighLevel, use a ação Custom Webhook.
  • Receber: gatilho WbizTool Incoming WhatsApp Message (precisa do add-on Unibox), depois uma etapa Filter by Zapier que só continue quando Contact Phone Hidden e Is Group forem falsos. Depois LeadConnector Add/Update Contact com o telefone definido como + e Contact Phone, e por fim LeadConnector Add Task com Message Content.

Make#

O app do HighLevel no Make se chama GoHighLevel. Estes templates usam só os módulos genéricos Webhooks, JSON e HTTP do Make, então você não precisa de uma conexão do GoHighLevel no Make. Em vez disso, o template de recebimento precisa de um token de Private Integration do HighLevel e do ID da sua location (veja abaixo).

  1. Importe o blueprint

    Baixe um template abaixo. No Make, crie um cenário, abra o menu … e escolha Import blueprint.

  2. Crie o webhook

    Abra o módulo Webhooks, clique em Add para criar um webhook e copie o endereço dele.

  3. Preencha os marcadores

    Substitua cada marcador em maiúsculas nos módulos HTTP, como YOUR_WBIZTOOL_API_KEY e YOUR_WHATSAPP_CLIENT_ID.

  4. Conecte o webhook

    Enviar: no HighLevel, adicione uma ação Webhook ao seu workflow com o endereço do Make como URL. Em Custom Data, adicione a chave phone_raw com o valor {{contact.phone_raw}}. Receber: cole o endereço do Make como URL do webhook do número em Números da caixa de entrada, com só Mensagens recebidas marcada.

  5. Execute uma vez

    Clique em Run once no Make e dispare o workflow, ou envie uma mensagem de WhatsApp para o seu número.

O template de recebimento grava no HighLevel pela API dele, com um token de Private Integration das configurações da sua subconta, com o escopo contacts.write, e o ID da location da sua subconta. Você também pode usar os módulos Create a Contact e Add a Note to the Contact do app GoHighLevel.

n8n#

O n8n tem um node HighLevel integrado. A operação Contact → Create or Update dele encontra um contato pelo telefone ou e-mail, ou cria um, e pode adicionar uma Note. Instale primeiro o community node do WbizTool: veja Integração com n8n.

  1. Importe o workflow

    Baixe um template abaixo. No n8n, crie um workflow e importe o arquivo (menu … → Import from File, ou cole o JSON no canvas).

  2. Adicione suas credenciais

    Abra o node WbizTool Send Message e escolha ou crie uma credencial WbizTool API. No workflow de recebimento, abra o node HighLevel e escolha ou crie uma credencial do HighLevel.

  3. Conecte o webhook

    Copie a URL de produção do node Webhook. Enviar: use-a como URL de uma ação Webhook do HighLevel, com a chave de Custom Data phone_raw definida como {{contact.phone_raw}}. Receber: cole-a como URL do webhook do número em Números da caixa de entrada, com só Mensagens recebidas marcada.

  4. Ative

    Ative o workflow e faça um teste.

Pabbly Connect#

Use o gatilho de webhook do próprio Pabbly Connect e a ação API (Pabbly) dele, configurada como em Enviar mensagens de WhatsApp a partir de qualquer ferramenta de automação. Para a direção de envio, aponte uma ação Webhook do HighLevel para a URL do webhook do Pabbly e mapeie phone_raw em phone. Para as mensagens recebidas, cole a URL do webhook do Pabbly como URL do webhook do número em Números da caixa de entrada.

Templates#

ArquivoO que faz
ghl-blocks.mdOs blocos para copiar e colar desta página, em um só arquivo.
gohighlevel-to-whatsapp.make.jsonMake: webhook do HighLevel → mensagem de WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake: mensagem de WhatsApp recebida → contato e nota no HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n: webhook do HighLevel → mensagem de WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n: mensagem de WhatsApp recebida → contato no HighLevel com uma nota.

Os templates não contêm chaves. Adicione as suas nos marcadores ou nas credenciais depois de importar.

Solução de problemas#

ProblemaO que fazer
A mensagem vai para o número errado, ou Invalid phone numberUse {{contact.phone_raw}}, não {{contact.phone}}. Se o número do contato não tem código do país no HighLevel, adicione country_code ao corpo ou corrija o contato.
Either phone or group_name parameter is requiredO contato não tem número de telefone. Adicione uma etapa If/Else antes da ação.
Auth Error: invalid api keyConfira o cabeçalho Authorization: Bearer, um espaço e depois a chave, sem aspas. A chave pode ter sido excluída. Veja Chaves de API.
Invalid whatsapp client ou Invalid whatsapp client id.Use o WhatsApp Client ID de Números do WhatsApp. Ele é obrigatório quando você tem mais de um número.
Invalid JSON format: …O corpo não é um JSON válido: falta uma vírgula, sobra uma vírgula no final, há uma quebra de linha real em msg ou um valor mesclado com aspas duplas.
"status": 1, mas nada chegaA mensagem fica na fila até o seu número de WhatsApp estar conectado. Confira Números do WhatsApp e Status da mensagem.
A ação Custom Webhook ou Inbound Webhook não apareceA agência não ativou os recursos premium de workflow (Workflow - Premium Features), ou a subconta já usou as execuções grátis e não tem repasse de cobrança. Fale com a sua agência.
Nenhuma mensagem recebida chega ao HighLevelO número precisa mostrar Sincronizando em Números da caixa de entrada, com a URL certa e Mensagens recebidas marcada. O receptor precisa responder 2xx em até 8 segundos. As requisições chegam com o User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), caso um firewall filtre por ele. Mais em Webhooks de mensagens recebidas.
Add-on Unibox obrigatórioMensagens recebidas precisam do add-on Unibox em um plano pago ou vitalício. Veja Planos e cobrança.
Um novo contato é criado a cada mensagemMapeie Phone com o + na frente, para que o HighLevel encontre o contato existente.
Chats de grupo criam contatos estranhosPule as mensagens em que contact.is_group é true em uma etapa If/Else.
As mensagens recebidas pararam depois que um Zap foi ativadoUm Zap com o gatilho Incoming WhatsApp Message do WbizTool assume o webhook do número enquanto está ativado. Desative o Zap ou use outro número.

Relacionados#