Your AI Connector Docs

Integrare GoHighLevel (GHL)

Folosești deja GoHighLevel (GHL) pentru a-ți gestiona afacerea? Această integrare îți permite să adaugi mesageria bazată pe AI de la Your AI Connector peste configurația ta GHL existentă. Mesajele care ajung în GHL sunt redirecționate către Your AI Connector pentru procesare prin AI, iar răspunsurile de la Your AI Connector sunt trimise înapoi prin GHL către client pe canalul original.

Folosiți un alt CRM? Nu are nevoie de un ecran dedicat pentru a funcționa cu Your AI Connector: consultați Conectarea unui instrument pe care nu îl listăm pentru funcții personalizate, API și webhook-uri.

Acest lucru înseamnă că poți continua să folosești GHL ca hub principal, permițând în același timp AI-ului să gestioneze conversațiile bazate pe inteligență artificială.

Notă: Aceasta este o integrare mai tehnică ce implică configurarea fluxurilor de lucru automatizate și conectarea sistemelor folosind webhook-uri (notificări automate între aplicații) și apeluri API. Dacă nu te simți confortabil cu acest lucru, poate ar fi mai bine să transmiți această pagină unui dezvoltator sau unui membru al echipei cu cunoștințe tehnice.


Cerințe preliminare

  • Un cont Your AI Connector activ cu cheia ta API (găsită la Setări → Integrări → Cheie API). O cheie API este un cod unic care permite GHL să comunice în siguranță cu contul tău.
  • Un cont GoHighLevel cu permisiuni pentru a crea fluxuri de lucru (workflows) și a gestiona webhook-uri (notificări automatizate între sisteme).

Cum funcționează

Direcție Ce se întâmplă
GHL către Your AI Connector Un client îți trimite un mesaj prin SMS, e-mail, Messenger, Instagram sau chat live în GHL. Un flux de lucru redirecționează automat acel mesaj către Your AI Connector. Your AI Connector îl procesează (răspuns AI, etichetare etc.).
Your AI Connector către GHL Când Your AI Connector trimite un răspuns (manual sau prin AI), notifică automat GHL. Un flux de lucru în GHL găsește contactul și trimite răspunsul prin canalul corect.

Flux de lucru 1: GHL către Your AI Connector

Acest flux de lucru redirecționează mesajele primite din GHL către Your AI Connector.

Pasul 1: Crearea fluxului de lucru

  1. În GHL, mergi la Automatizare > Fluxuri de lucru (Workflows).
  2. Dă clic pe Creează flux de lucru nou.
  3. Dă-i un nume descriptiv, cum ar fi „Trimite mesaj către Your AI Connector”.

Pasul 2: Adăugarea declanșatoarelor (Triggers)

Adaugă un declanșator pentru fiecare canal pe care dorești să îl redirecționezi:

  • Customer Replied - SMS
  • Customer Replied - Email
  • Customer Replied - Facebook Message
  • Customer Replied - Instagram DM
  • Customer Replied - Live Chat

Poți să le adaugi pe toate sau doar canalele relevante pentru configurația ta.

Pasul 3: Adăugarea filtrului de etichete (Opțional)

Dacă doriți să redirecționați mesaje doar de la anumite contacte:

  1. Faceți clic pe Adăugare filtru (Add Filter) pe declanșator.
  2. Setați condiția la „Contactul are etichetă” (Contact has tag).
  3. Alegeți eticheta/etichetele dorite.
  4. Selectați dacă respectivul contact trebuie să aibă oricare sau toate etichetele selectate.

Pasul 4: Creați o diviziune pe canale

Adăugați o acțiune de Condiție (Condition) pentru a direcționa fiecare canal către propriul webhook:

Ramură Condiție
Ramura 1 Sursa mesajului este egală cu Email
Ramura 2 Sursa mesajului este egală cu SMS
Ramura 3 Sursa mesajului este egală cu Messenger
Ramura 4 Sursa mesajului este egală cu Instagram
Ramura 5 Sursa mesajului este egală cu Live Chat

Pasul 5: Configurați webhook-urile

Pentru fiecare ramură, adăugați o acțiune de Webhook / Cerere HTTP (Webhook / HTTP Request):

  • Metodă: POST

  • URL:

    https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • Câmpuri de date personalizate:

Câmp Valoare Note
messageSid {{right_now.second}}{{contact.id}} Identificator unic de mesaj
fromId {{contact.id}} ID contact GHL
toId {{user.id}} ID utilizator GHL
body {{message.body}} Conținutul mesajului
channel Vezi tabelul de mai jos Trebuie să corespundă ramurii
status created Setați întotdeauna la created
messageType text Tipul mesajului

Valori canal per ramură:

Ramură Valoare channel
Email email
SMS sms
Messenger messenger
Instagram ig
Live Chat livechat

Important: Asigură-te că valoarea channel corespunde exact — acestea sunt sensibile la majuscule.

Pasul 6: Activați reintrarea

În setările fluxului de lucru, asigurați-vă că Permiteți reintrarea (Allow Re-entry) este activată. Fără aceasta, doar primul mesaj de la fiecare contact va fi redirecționat.


Flux de lucru 2: Your AI Connector către GHL

Acest flux de lucru primește răspunsurile de la Your AI Connector și le trimite clientului prin canalul GHL corect.

Pasul 1: Creați un Webhook de intrare în GHL

  1. În GHL, mergi la Setări > Dezvoltatori / API.
  2. Dă clic pe Creează webhook nou (sau „Webhook de intrare”).
  3. Numește-l „Mesaje”.
  4. Salvează și copiază URL-ul webhook-ului — vei avea nevoie de el la pasul următor.

Pasul 2: Configurează Your AI Connector

  1. În Your AI Connector, faceți clic pe Settings în bara laterală.
  2. Sub Channels, faceți clic pe Channels.
  3. Derulați până la cardul Custom channel din partea de jos a paginii.
  4. Lipiți URL-ul webhook-ului de intrare GHL pe care tocmai l-ați copiat în Webhook URL (trebuie să fie o adresă HTTPS publică) și faceți clic pe Save.

Aceasta nu este pagina Settings → Integrations → Webhooks. Acea pagină este destinată notificărilor de evenimente și trimite un payload diferit. Releul de ieșire GHL este configurat pe cardul Custom channel din Settings → Channels.

Your AI Connector va trimite acum automat o notificare către GHL de fiecare dată când un mesaj este trimis către un contact. Datele trimise arată astfel:

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

Notă de navigare: cheia API pe care o utilizați pentru Workflow 1 și cardul Custom channel pe care îl utilizați aici se află în locuri diferite — Settings → Integrations → API Key pentru cheie și cardul Custom channel din partea de jos a Settings → Channels pentru acest releu. Pagina separată Settings → Integrations → Webhooks este pentru notificări de evenimente și trimite un payload diferit; consultați Webhooks dacă doriți acest lucru în schimb.

Pasul 3: Creați fluxul de lucru de răspuns

  1. În GHL, accesați Automation > Workflows.
  2. Creați un flux de lucru nou numit „Send Message to Contact”.
  3. Setați declanșatorul (trigger) pe Inbound Webhook și selectați webhook-ul pe care l-ați creat la Pasul 1.

Pasul 4: Adăugați o acțiune de căutare a contactului (Find Contact)

  1. Adăugați o acțiune Find Contact.
  2. Setați câmpul de căutare pe Contact ID.
  3. Utilizați valoarea: {{inboundWebhookRequest.toId}}

Pasul 5: Adăugați o verificare opțională a etichetelor

Dacă dorești să limitezi contactele care primesc mesaje de la Your AI Connector:

  1. Adăugați o acțiune Condition.
  2. Verificați dacă contactul are o anumită etichetă.
  3. Dacă eticheta lipsește, încheiați fluxul de lucru (adăugați o acțiune „Stop” pe ramura falsă).

Pasul 6: Adăugați o diviziune pe canale

Adăugați o acțiune de Condiție care direcționează mesajul pe baza {{inboundWebhookRequest.channel}}:

Ramură Condiție Acțiune
Ramura 1 egal cu email Trimite e-mail
Ramura 2 egal cu sms Trimite SMS
Ramura 3 egal cu messenger Trimite mesaj Facebook
Ramura 4 egal cu ig Trimite mesaj Instagram
Ramura 5 egal cu livechat Trimite mesaj Chat

Pasul 7: Configurați fiecare acțiune de trimitere

În fiecare acțiune de trimitere, setați corpul mesajului la:

{{inboundWebhookRequest.body}}

Pasul 8: Activați reintrarea

La fel ca în Fluxul de lucru 1, asigurați-vă că Permiteți reintrarea este activată în setările fluxului de lucru.


Testarea integrării

Testează GHL către Your AI Connector (Flux de lucru 1)

  1. Trimite un mesaj către numărul tău GHL sau canalul conectat (de exemplu, trimite-ți un SMS).
  2. Deschide Your AI Connector și verifică dacă mesajul apare în Chat-uri.
  3. Verifică dacă eticheta canalului este corectă (SMS, e-mail etc.).
  4. Repetă pentru fiecare canal configurat.

Testează Your AI Connector către GHL (Flux de lucru 2)

  1. În Your AI Connector, trimite un răspuns unui contact (manual sau lasă AI-ul să răspundă).
  2. Deschide GHL și verifică dacă contactul a primit mesajul.
  3. Confirmă că a fost trimis prin canalul corect.
  4. Verifică dacă conținutul mesajului corespunde.

Depanare

Problemă Ce trebuie verificat
Mesajele nu ajung la Your AI Connector Verificați dacă cheia API este corectă în URL-ul webhook-ului. Verificați dacă declanșatoarele fluxului de lucru (workflow) sunt active (jurnalele fluxului de lucru GHL). Confirmați că opțiunea Allow Re-entry este activată.
Mesajele nu ajung la GHL Verificați dacă URL-ul webhook-ului de intrare GHL este lipit corect în Webhook URL pe cardul Custom channel din partea de jos a Settings → Channels (nu pe pagina Settings → Integrations → Webhooks, care este o funcție diferită). Verificați dacă webhook-ul de intrare GHL este activ. Examinați jurnalele de execuție ale fluxului de lucru GHL.
Contactul nu a fost găsit în GHL toId din datele webhook-ului trebuie să corespundă unui ID de contact GHL existent. Asigurați-vă că există contacte în ambele sisteme cu ID-uri corespondente.
Canal greșit utilizat pentru răspuns Verificați de două ori valorile canalului în ramurile de condiție. Acestea trebuie să se potrivească exact: email, sms, messenger, ig, livechat.
Doar primul mesaj este redirecționat Activați Allow Re-entry în ambele setări ale fluxului de lucru.

Pașii următori

  • Webhook-uri — configurează webhook-uri pentru alte evenimente Your AI Connector.
  • Acces API — utilizează API-ul pentru integrări personalizate dincolo de GHL.
  • Canale personalizate — află mai multe despre mesageria prin canale personalizate.