Integrazione con GoHighLevel (GHL) #

Stai già utilizzando GoHighLevel (GHL) per gestire la tua attività? Questa integrazione ti consente di aggiungere la messaggistica basata sull’IA di Your AI Connector alla tua configurazione GHL esistente. I messaggi che arrivano in GHL vengono inoltrati a Your AI Connector per la gestione tramite IA e le risposte di Your AI Connector vengono inviate nuovamente tramite GHL al cliente sul canale originale.

Utilizzi un CRM diverso? Non serve una schermata dedicata per farlo funzionare con Your AI Connector: consulta Connettere uno strumento non presente nel nostro elenco per funzioni personalizzate, API e webhook.

Ciò significa che puoi continuare a utilizzare GHL come hub principale, lasciando che l’IA gestisca le conversazioni basate sull’intelligenza artificiale.

Prerequisiti #

• Un account Your AI Connector attivo con la tua chiave API (che trovi in Impostazioni → Integrazioni → Chiave API). Una chiave API è un codice univoco che consente a GHL di comunicare in modo sicuro con il tuo account.
• Un account GoHighLevel con l’autorizzazione per creare flussi di lavoro e gestire webhook (notifiche automatizzate tra sistemi).

Come funziona #

Flusso di lavoro 1: Da GHL a Your AI Connector #

Questo flusso di lavoro inoltra i messaggi in arrivo da GHL a Your AI Connector.

Passaggio 1: Crea il flusso di lavoro #

1. In GHL, vai su Automazione > Flussi di lavoro.
2. Fai clic su Crea nuovo flusso di lavoro.
3. Dagli un nome descrittivo, come “Invia messaggio a Your AI Connector”.

Passaggio 2: Aggiungi trigger #

Aggiungi un trigger per ogni canale che desideri inoltrare:

• Risposta del cliente - SMS
• Risposta del cliente - Email
• Risposta del cliente - Messaggio Facebook
• Risposta del cliente - DM Instagram
• Risposta del cliente - Live Chat

Puoi aggiungerli tutti o solo i canali pertinenti alla tua configurazione.

Passaggio 3: Aggiungi filtro tag (opzionale) #

Se desideri inoltrare solo i messaggi provenienti da contatti specifici:

1. Fai clic su Aggiungi filtro sul trigger.
2. Imposta la condizione su “Il contatto ha un tag”.
3. Scegli il/i tuo/i tag.
4. Seleziona se il contatto deve avere qualsiasi o tutti i tag selezionati.

Passaggio 4: Crea una suddivisione dei canali #

Aggiungi un’azione Condizione per instradare ogni canale verso il proprio webhook:

Passaggio 5: Configura i webhook #

Per ogni ramo, aggiungi un’azione Webhook / Richiesta HTTP:

• Metodo: POST

• URL:

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

• Campi dati personalizzati:

Valori del canale per ramo:

Passaggio 6: Abilita il rientro #

Nelle impostazioni del flusso di lavoro, assicurati che Consenti rientro sia abilitato. Senza questa opzione, verrà inoltrato solo il primo messaggio di ogni contatto.

Flusso di lavoro 2: Da Your AI Connector a GHL #

Questo flusso di lavoro riceve le risposte da Your AI Connector e le invia al cliente tramite il canale GHL corretto.

Passaggio 1: Creare un Webhook in entrata in GHL #

1. In GHL, vai su Impostazioni > Sviluppatori / API.
2. Fai clic su Crea nuovo webhook (o “Webhook in entrata”).
3. Chiamalo “Messaggi”.
4. Salva e copia l’URL del webhook: ti servirà nel passaggio successivo.

Passaggio 2: Configura Your AI Connector #

1. In Your AI Connector, fai clic su Settings nella barra laterale.
2. Sotto Channels, fai clic su Channels.
3. Scorri fino alla scheda Custom channel in fondo alla pagina.
4. Incolla l’URL del webhook in entrata di GHL che hai appena copiato in Webhook URL (deve essere un indirizzo HTTPS pubblico) e fai clic su Save.

Questa non è la pagina Settings → Integrations → Webhooks. Quella pagina serve per le notifiche degli eventi e invia un payload diverso. Il relay in uscita di GHL si imposta nella scheda Custom channel sotto Settings → Channels.

Your AI Connector invierà ora automaticamente una notifica a GHL ogni volta che viene inviato un messaggio a un contatto. I dati inviati appaiono così:

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

Nota di navigazione: la chiave API che utilizzi per il Workflow 1 e la scheda Custom channel che utilizzi qui si trovano in posti diversi: Settings → Integrations → API Key per la chiave, e la scheda Custom channel in fondo a Settings → Channels per questo relay. La pagina separata Settings → Integrations → Webhooks serve per le notifiche degli eventi e invia un payload diverso; consulta Webhooks se è quello che ti serve.

Passaggio 3: Creare il flusso di lavoro di risposta #

1. In GHL, vai su Automazione > Flussi di lavoro.
2. Crea un nuovo flusso di lavoro chiamato “Invia messaggio al contatto”.
3. Imposta il trigger su Webhook in entrata e seleziona il webhook creato nel Passaggio 1.

Passaggio 4: Aggiungere un’azione Trova contatto #

1. Aggiungi un’azione Trova contatto.
2. Imposta il campo di ricerca su ID contatto.
3. Usa il valore: {{inboundWebhookRequest.toId}}

Passaggio 5: Aggiungere un controllo tag opzionale #

Se desideri limitare quali contatti ricevono messaggi da Your AI Connector:

1. Aggiungi un’azione Condizione.
2. Verifica se il contatto ha un tag specifico.
3. Se il tag manca, termina il flusso di lavoro (aggiungi un’azione “Interrompi” sul ramo falso).

Passaggio 6: Aggiungere una suddivisione dei canali #

Aggiungi un’azione Condizione che instrada il messaggio in base a {{inboundWebhookRequest.channel}}:

Passaggio 7: Configura ogni azione di invio #

In ogni azione di invio, imposta il corpo del messaggio su:

{{inboundWebhookRequest.body}}

Passaggio 8: Abilita il rientro #

Come per il Flusso di lavoro 1, assicurati che Consenti rientro sia abilitato nelle impostazioni del flusso di lavoro.

Test dell’integrazione #

Testa da GHL a Your AI Connector (Flusso di lavoro 1) #

1. Invia un messaggio al tuo numero GHL o al canale collegato (ad esempio, inviati un SMS).
2. Apri Your AI Connector e verifica che il messaggio appaia in Chat.
3. Controlla che l’etichetta del canale sia corretta (SMS, email, ecc.).
4. Ripeti per ogni canale configurato.

Testa da Your AI Connector a GHL (Flusso di lavoro 2) #

1. In Your AI Connector, invia una risposta a un contatto (manualmente o lascia che l’IA risponda).
2. Apri GHL e verifica che il contatto abbia ricevuto il messaggio.
3. Conferma che sia stato inviato tramite il canale corretto.
4. Controlla che il contenuto del messaggio corrisponda.

Risoluzione dei problemi #

Prossimi passi #

• Webhook — configura i webhook per altri eventi Your AI Connector.
• Accesso API — utilizza l’API per integrazioni personalizzate oltre a GHL.
• Canali personalizzati — scopri di più sulla messaggistica tramite canali personalizzati.