Integração com GoHighLevel (GHL) #

Já utiliza o GoHighLevel (GHL) para gerir o seu negócio? Esta integração permite-lhe adicionar as mensagens com tecnologia de IA do Your AI Connector à sua configuração atual do GHL. As mensagens que chegam ao GHL são reencaminhadas para o Your AI Connector para processamento por IA, e as respostas do Your AI Connector são enviadas de volta através do GHL para o cliente no canal original.

Utiliza um CRM diferente? Não precisa de um ecrã dedicado para funcionar com o Your AI Connector: consulte Ligar uma Ferramenta que Não Listamos para funções personalizadas, a API e webhooks.

Isto significa que pode continuar a utilizar o GHL como o seu centro principal, permitindo que a IA trate das conversas orientadas por IA.

Pré-requisitos #

• Uma conta Your AI Connector ativa com a sua chave API (encontrada em Definições → Integrações → Chave API). Uma chave API é um código único que permite ao GHL comunicar de forma segura com a sua conta.
• Uma conta GoHighLevel com permissão para criar fluxos de trabalho e gerir webhooks (notificações automatizadas entre sistemas).

Como Funciona #

Fluxo de trabalho 1: GHL para Your AI Connector #

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

Passo 1: Criar o fluxo de trabalho #

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

Passo 2: Adicionar gatilhos #

Adicione um gatilho para cada canal que pretende reencaminhar:

• Cliente respondeu - SMS
• Cliente respondeu - E-mail
• Cliente respondeu - Mensagem de Facebook
• Cliente respondeu - Mensagem direta de Instagram
• Cliente respondeu - Chat em direto

Pode adicionar todos ou apenas os canais relevantes para a sua configuração.

Passo 3: Adicionar filtro de etiqueta (Opcional) #

Se pretender apenas reencaminhar mensagens de contactos específicos:

1. Clique em Adicionar Filtro no acionador.
2. Defina a condição como “O contacto tem a etiqueta.”
3. Escolha a(s) sua(s) etiqueta(s).
4. Selecione se o contacto deve ter qualquer ou todas as etiquetas selecionadas.

Passo 4: Criar uma Divisão de Canal #

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

Passo 5: Configurar Webhooks #

Para cada ramo, adicione uma ação de Webhook / Pedido 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 ramo:

Passo 6: Ativar Reentrada #

Nas definições do fluxo de trabalho, certifique-se de que a opção Permitir Reentrada está ativada. Sem isto, apenas a primeira mensagem de cada contacto será reencaminhada.

Fluxo de trabalho 2: Your AI Connector para GHL #

Este fluxo de trabalho recebe respostas do Your AI Connector e envia-as para o cliente através do canal GHL correto.

Passo 1: Criar um Webhook de entrada no GHL #

1. No GHL, vá a Settings > Developers / API.
2. Clique em Create New Webhook (ou “Inbound Webhook”).
3. Dê-lhe o nome “Messages.”
4. Guarde e copie o URL do webhook — irá precisar dele no passo seguinte.

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. Desloque-se até ao cartão Custom channel no final da página.
4. Cole o URL do webhook de entrada do GHL que acabou de copiar em Webhook URL (tem de ser um endereço HTTPS público) e clique em Save.

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

O Your AI Connector enviará agora automaticamente uma notificação para o GHL sempre que uma mensagem for enviada para um contacto. Os dados enviados têm o seguinte aspeto:

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

Nota de navegação: a chave de API que utiliza para o Workflow 1 e o cartão Custom channel que utiliza aqui encontram-se em locais diferentes — Settings → Integrations → API Key para a chave, e o cartão Custom channel no fundo de Settings → Channels para este reencaminhamento. A página separada Settings → Integrations → Webhooks destina-se a notificações de eventos e envia um payload diferente; consulte Webhooks se for isso que pretende.

Passo 3: Criar o Fluxo de trabalho de resposta #

1. No GHL, vá a Automation > Workflows.
2. Crie um novo fluxo de trabalho chamado “Send Message to Contact.”
3. Defina o gatilho (trigger) como Inbound Webhook e selecione o webhook que criou no Passo 1.

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

1. Adicione uma ação Find Contact.
2. Defina o campo de pesquisa como Contact ID.
3. Utilize o valor: {{inboundWebhookRequest.toId}}

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

Se pretender limitar quais os contactos que recebem mensagens do Your AI Connector:

1. Adicione uma ação Condition.
2. Verifique se o contacto tem uma etiqueta específica.
3. Se a etiqueta não existir, termine o fluxo de trabalho (adicione uma ação “Stop” no ramo falso).

Passo 6: Adicionar uma divisão de canal #

Adicione uma ação Condição que encaminha 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: Ativar reentrada #

Tal como no Fluxo de Trabalho 1, certifique-se de que a opção Permitir reentrada está ativada nas definições do fluxo de trabalho.

Testar a integração #

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

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

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

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

Resolução de Problemas #

Próximos Passos #

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