Integração com GoHighLevel (GHL) #

Já usa o GoHighLevel (GHL) para gerenciar seu negócio? Esta integração permite que você adicione o sistema de mensagens com IA do Your AI Connector sobre sua configuração atual do GHL. As mensagens que chegam ao GHL são encaminhadas para o Your AI Connector para processamento via IA, e as respostas do Your AI Connector são enviadas de volta pelo GHL ao cliente no canal original.

Está usando um CRM diferente? Ele não precisa de uma tela dedicada para funcionar com o Your AI Connector: consulte Conectando uma Ferramenta que Não Listamos para funções personalizadas, a API e webhooks.

Isso significa que você pode continuar usando o GHL como seu hub principal enquanto deixa a IA cuidar das conversas automatizadas.

Pré-requisitos #

• Uma conta Your AI Connector ativa com sua chave de API (encontrada em Configurações → Integrações → Chave de API). Uma chave de API é um código exclusivo que permite que o GHL se comunique com segurança com sua conta.
• Uma conta GoHighLevel com permissão para criar fluxos de trabalho e gerenciar webhooks (notificações automatizadas entre sistemas).

Como Funciona #

Fluxo de trabalho 1: GHL para Your AI Connector #

Este fluxo de trabalho encaminha mensagens recebidas do GHL para o Your AI Connector.

Passo 1: Criar o fluxo de trabalho #

1. No GHL, vá para Automação > Fluxos de trabalho.
2. Clique em Criar novo fluxo de trabalho.
3. Dê um nome descritivo, como “Enviar mensagem para o Your AI Connector.”

Passo 2: Adicionar gatilhos #

Adicione um gatilho para cada canal que você deseja encaminhar:

• Cliente respondeu - SMS
• Cliente respondeu - E-mail
• Cliente respondeu - Mensagem do Facebook
• Cliente respondeu - DM do Instagram
• Cliente respondeu - Chat ao vivo

Você pode adicionar todos eles ou apenas os canais relevantes para sua configuração.

Passo 3: Adicionar filtro de tag (Opcional) #

Se você quiser encaminhar apenas mensagens de contatos específicos:

1. Clique em Adicionar Filtro no gatilho.
2. Defina a condição como “O contato tem a tag”.
3. Escolha sua(s) tag(s).
4. Selecione se o contato deve ter qualquer uma ou todas as tags selecionadas.

Passo 4: Criar uma Divisão de Canal #

Adicione uma ação de Condição para rotear cada canal para seu próprio webhook:

Passo 5: Configurar Webhooks #

Para cada ramificação, adicione uma ação de Webhook / Requisição HTTP:

• Método: POST

• URL:

  https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
  

• Campos de Dados Personalizados:

Valores de canal por ramificação:

Passo 6: Habilitar Reentrada #

Nas configurações do fluxo de trabalho, certifique-se de que Permitir Reentrada esteja ativado. Sem isso, apenas a primeira mensagem de cada contato será encaminhada.

Fluxo de trabalho 2: Your AI Connector para GHL #

Este fluxo de trabalho recebe respostas do Your AI Connector e as envia ao cliente pelo canal correto do GHL.

Passo 1: Criar um Webhook de entrada no GHL #

1. No GHL, vá para Configurações > Desenvolvedores / API.
2. Clique em Criar novo webhook (ou “Webhook de entrada”).
3. Nomeie-o como “Mensagens”.
4. Salve e copie a URL do webhook — você precisará dela na próxima etapa.

Passo 2: Configurar o Your AI Connector #

1. Em Your AI Connector, clique em Settings na barra lateral.
2. Em Channels, clique em Channels.
3. Role até o cartão Custom channel na parte inferior da página.
4. Cole a URL do webhook de entrada do GHL que você acabou de copiar em Webhook URL (deve ser um endereço HTTPS público) e clique em Save.

Esta não é a página Settings → Integrations → Webhooks. Essa página é para notificações de eventos e envia um payload diferente. O retransmissor de saída do GHL é configurado no cartão Custom channel em Settings → Channels.

O Your AI Connector agora enviará automaticamente uma notificação para o GHL toda vez que uma mensagem for enviada a um contato. Os dados enviados têm este formato:

{
  "contactId": "NtL97bwnhITrfIq8lWFi",
  "messageId": "s28dtg13qNuhXLoKpcLs",
  "userId": "wpDZRvaw4Hgh4whUBpwlKPRftOi2",
  "body": "Message content here",
  "toId": "qtpBsc6fiqkXTnSOeze3",
  "channel": "email"
}

Nota de navegação: a chave de API que você usa para o Fluxo de Trabalho 1 e o cartão de canal personalizado que você usa aqui ficam em locais diferentes — Settings → Integrations → API Key para a chave, e o cartão Custom channel na parte inferior de Settings → Channels para este retransmissor. A página separada Settings → Integrations → Webhooks é para notificações de eventos e envia um payload diferente; consulte Webhooks se for isso que você deseja.

Passo 3: Criar o fluxo de trabalho de resposta #

1. No GHL, vá para Automação > Fluxos de trabalho.
2. Crie um novo fluxo de trabalho chamado “Enviar mensagem para contato.”
3. Defina o gatilho como Webhook de entrada e selecione o webhook que você criou no Passo 1.

Passo 4: Adicionar uma ação de Encontrar Contato #

1. Adicione uma ação Encontrar Contato.
2. Defina o campo de pesquisa como ID do Contato.
3. Use o valor: {{inboundWebhookRequest.toId}}

Passo 5: Adicionar uma verificação de tag opcional #

Se você quiser limitar quais contatos recebem mensagens do Your AI Connector:

1. Adicione uma ação Condição.
2. Verifique se o contato possui uma tag específica.
3. Se a tag estiver ausente, encerre o fluxo de trabalho (adicione uma ação “Parar” no ramo falso).

Passo 6: Adicionar uma divisão de canal #

Adicione uma ação de Condição que roteia a mensagem com base em {{inboundWebhookRequest.channel}}:

Passo 7: Configurar cada ação de envio #

Em cada ação de envio, defina o corpo da mensagem como:

{{inboundWebhookRequest.body}}

Passo 8: Habilitar reentrada #

Assim como no Fluxo de Trabalho 1, certifique-se de que Permitir reentrada esteja habilitado nas configurações do fluxo de trabalho.

Testando a integração #

Testar GHL para Your AI Connector (Fluxo de trabalho 1) #

1. Envie uma mensagem para seu número do GHL ou canal conectado (por exemplo, envie um SMS para si mesmo).
2. Abra o Your AI Connector e verifique se a mensagem aparece em Chats.
3. Verifique se o rótulo do canal está correto (SMS, e-mail, etc.).
4. Repita para cada canal que você configurou.

Testar Your AI Connector para GHL (Fluxo de trabalho 2) #

1. No Your AI Connector, envie uma resposta para um contato (manualmente ou deixe a IA responder).
2. Abra o GHL e verifique se o contato recebeu a mensagem.
3. Confirme se ela foi enviada pelo canal correto.
4. Verifique se o conteúdo da mensagem corresponde.

Solução de problemas #

Próximos passos #

• Webhooks — configure webhooks para outros eventos do Your AI Connector.
• Acesso à API — use a API para integrações personalizadas além do GHL.
• Canais Personalizados — saiba mais sobre mensagens em canais personalizados.