# 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](connecting-other-tools.md) 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ă. ::: note **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` | ::: warning **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: ```json { "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](webhooks.md) 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](webhooks.md) — configurează webhook-uri pentru alte evenimente Your AI Connector. - [Acces API](api-access.md) — utilizează API-ul pentru integrări personalizate dincolo de GHL. - [Canale personalizate](../messaging-channels/custom-channels.md) — află mai multe despre mesageria prin canale personalizate.