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ção | Exemplo | Como |
|---|---|---|
| HighLevel → WhatsApp | Um 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 → HighLevel | Um 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.
| Caminho | Enviar (HighLevel → WhatsApp) | Receber (WhatsApp → HighLevel) | Planos necessários |
|---|---|---|---|
| Workflows do HighLevel (recomendado) | Ação Custom Webhook → API de envio de mensagens | Webhook do WbizTool → gatilho Inbound Webhook | Recursos premium de workflow do HighLevel. Receber: o add-on Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact ou Add Task | Uma conta do Zapier. Receber: o add-on Unibox. |
| Make | Ação Webhook do HighLevel → Webhooks do Make → módulo HTTP | Webhook do WbizTool → Webhooks do Make → API do HighLevel | Uma conta do Make. Receber: o add-on Unibox. |
| n8n | Ação Webhook do HighLevel → Webhook do n8n → WbizTool Send Message | Webhook do WbizTool → Webhook do n8n → node HighLevel | n8n com o community node do WbizTool. Receber: o add-on Unibox. |
| Pabbly Connect | Ação Webhook do HighLevel → gatilho de webhook do Pabbly → requisição API (Pabbly) | Webhook do WbizTool → gatilho de webhook do Pabbly → sua etapa do HighLevel | Uma conta do Pabbly Connect. Receber: o add-on Unibox. |
Enviar mensagens de WhatsApp a partir de um workflow do HighLevel#
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.
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.
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çalhoAuthorizationcom o valorBearer YOUR_API_KEY. Defina Content-Type comoapplication/json.Cole o corpo
Cole um dos blocos para copiar e colar em Raw Body e substitua
678pelo seu WhatsApp Client ID. Use o ícone de tag do HighLevel para adicionar mais campos do contato à mensagem.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
{
"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": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}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\ndentro do texto. Uma quebra de linha real deixa o JSON inválido.- Imagens e arquivos: os links precisam ser públicos.
msgvira 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. Enviegroup_nameouphone, 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.
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.
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.
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.
Pule grupos e números ocultos
Adicione uma etapa If/Else que só continue quando
eventformessage_received,contact.is_groupforfalseecontact.phonenã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.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.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.Publique
Publique o workflow e envie outra mensagem de teste.
| Valor do Inbound Webhook | Use para |
|---|---|
contact.phone | O telefone do contato. Adicione + na frente. |
contact.name | O nome de WhatsApp de quem envia. Pode estar vazio. |
message.content | O texto. Para fotos, mensagens de voz e arquivos, é um rótulo como 📸 Image, e as legendas não são incluídas. |
message.timestamp | Quando a mensagem foi enviada no WhatsApp (ISO 8601, UTC). |
message.media.url | Um 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_phone | Qual dos seus números a recebeu, se vários números enviam para o mesmo workflow. |
event | message_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).
Importe o blueprint
Baixe um template abaixo. No Make, crie um cenário, abra o menu … e escolha Import blueprint.
Crie o webhook
Abra o módulo Webhooks, clique em Add para criar um webhook e copie o endereço dele.
Preencha os marcadores
Substitua cada marcador em maiúsculas nos módulos HTTP, como
YOUR_WBIZTOOL_API_KEYeYOUR_WHATSAPP_CLIENT_ID.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_rawcom 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.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.
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).
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.
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_rawdefinida 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.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#
| Arquivo | O que faz |
|---|---|
| ghl-blocks.md | Os blocos para copiar e colar desta página, em um só arquivo. |
| gohighlevel-to-whatsapp.make.json | Make: webhook do HighLevel → mensagem de WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: mensagem de WhatsApp recebida → contato e nota no HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: webhook do HighLevel → mensagem de WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: 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#
| Problema | O que fazer |
|---|---|
A mensagem vai para o número errado, ou Invalid phone number | Use {{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 required | O contato não tem número de telefone. Adicione uma etapa If/Else antes da ação. |
Auth Error: invalid api key | Confira 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 chega | A 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 aparece | A 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 HighLevel | O 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ório | Mensagens recebidas precisam do add-on Unibox em um plano pago ou vitalício. Veja Planos e cobrança. |
| Um novo contato é criado a cada mensagem | Mapeie Phone com o + na frente, para que o HighLevel encontre o contato existente. |
| Chats de grupo criam contatos estranhos | Pule as mensagens em que contact.is_group é true em uma etapa If/Else. |
| As mensagens recebidas pararam depois que um Zap foi ativado | Um 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#
- API de envio de mensagens: todos os campos e erros
- Webhooks de mensagens recebidas: números da caixa de entrada, entrega, payload
- Chaves de API e Client ID
- Integração com Zapier
- Integração com n8n
- Enviar a partir de qualquer ferramenta de automação: Make, Pabbly Connect e outras

