Your AI Connector Docs

Integracja z GoHighLevel (GHL)

Korzystasz już z GoHighLevel (GHL) do zarządzania swoją firmą? Ta integracja pozwala dodać obsługę wiadomości opartą na sztucznej inteligencji od Your AI Connector do istniejącej konfiguracji GHL. Wiadomości przychodzące do GHL są przekazywane do Your AI Connector w celu przetworzenia przez AI, a odpowiedzi z Your AI Connector są odsyłane przez GHL do klienta tym samym kanałem.

Korzystasz z innego systemu CRM? Nie potrzebuje on dedykowanego ekranu, aby współpracować z Your AI Connector: zobacz Łączenie narzędzia, którego nie wymieniamy, aby dowiedzieć się więcej o funkcjach niestandardowych, API i webhookach.

Oznacza to, że możesz nadal używać GHL jako głównego centrum, pozwalając jednocześnie AI na prowadzenie rozmów.

Uwaga: Jest to bardziej techniczna integracja, która wymaga skonfigurowania zautomatyzowanych przepływów pracy (workflows) oraz połączenia systemów za pomocą webhooków (automatycznych powiadomień między aplikacjami) i wywołań API. Jeśli nie czujesz się z tym pewnie, warto przekazać tę stronę programiście lub członkowi zespołu z odpowiednią wiedzą techniczną.


Wymagania wstępne

  • Aktywne konto Your AI Connector z kluczem API (znajdziesz go w Ustawienia → Integracje → Klucz API). Klucz API to unikalny kod, który pozwala GHL na bezpieczną komunikację z Twoim kontem.
  • Konto GoHighLevel z uprawnieniami do tworzenia przepływów pracy (workflows) i zarządzania webhookami (automatycznymi powiadomieniami między systemami).

Jak to działa

Kierunek Co się dzieje
GHL do Your AI Connector Klient wysyła wiadomość przez SMS, e-mail, Messenger, Instagram lub czat na żywo w GHL. Przepływ pracy automatycznie przekazuje tę wiadomość do Your AI Connector. Your AI Connector przetwarza ją (odpowiedź AI, tagowanie itp.).
Your AI Connector do GHL Gdy Your AI Connector wysyła odpowiedź (ręcznie lub przez AI), automatycznie powiadamia GHL. Przepływ pracy w GHL znajduje kontakt i wysyła odpowiedź odpowiednim kanałem.

Przepływ pracy 1: GHL do Your AI Connector

Ten przepływ pracy przekazuje przychodzące wiadomości z GHL do Your AI Connector.

Krok 1: Utwórz przepływ pracy (Workflow)

  1. W GHL przejdź do Automatyzacja > Przepływy pracy (Workflows).
  2. Kliknij Utwórz nowy przepływ pracy.
  3. Nadaj mu opisową nazwę, np. „Wyślij wiadomość do Your AI Connector”.

Krok 2: Dodaj wyzwalacze (Triggers)

Dodaj wyzwalacz dla każdego kanału, który chcesz przekazywać:

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

Możesz dodać wszystkie z nich lub tylko te kanały, które są istotne dla Twojej konfiguracji.

Krok 3: Dodaj filtr tagów (opcjonalnie)

Jeśli chcesz przekazywać wiadomości tylko od określonych kontaktów:

  1. Kliknij Dodaj filtr (Add Filter) przy wyzwalaczu.
  2. Ustaw warunek na „Kontakt ma tag” (Contact has tag).
  3. Wybierz swój tag lub tagi.
  4. Wybierz, czy kontakt powinien mieć dowolny (any), czy wszystkie (all) z wybranych tagów.

Krok 4: Utwórz podział kanałów (Channel Split)

Dodaj akcję Warunek (Condition), aby skierować każdy kanał do odpowiedniego webhooka:

Gałąź Warunek
Gałąź 1 Źródło wiadomości równe Email
Gałąź 2 Źródło wiadomości równe SMS
Gałąź 3 Źródło wiadomości równe Messenger
Gałąź 4 Źródło wiadomości równe Instagram
Gałąź 5 Źródło wiadomości równe Live Chat

Krok 5: Skonfiguruj webhooki

Dla każdej gałęzi dodaj akcję Webhook / Żądanie HTTP (Webhook / HTTP Request):

  • Metoda: POST

  • URL:

    https://api.youraiconnector.com/v1/incoming_custom_channel_message?apiKey=YOUR_API_KEY
    
  • Niestandardowe pola danych:

Pole Wartość Uwagi
messageSid {{right_now.second}}{{contact.id}} Unikalny identyfikator wiadomości
fromId {{contact.id}} Identyfikator kontaktu GHL
toId {{user.id}} Twój identyfikator użytkownika GHL
body {{message.body}} Treść wiadomości
channel Zobacz tabelę poniżej Musi odpowiadać gałęzi
status created Zawsze ustawione na created
messageType text Typ wiadomości

Wartości kanałów dla poszczególnych gałęzi:

Gałąź Wartość channel
Email email
SMS sms
Messenger messenger
Instagram ig
Czat na żywo livechat

Ważne: Upewnij się, że wartość channel jest dokładnie taka sama — wielkość liter ma znaczenie.

Krok 6: Włącz ponowne wejście (Re-Entry)

W ustawieniach przepływu pracy (workflow) upewnij się, że opcja Zezwalaj na ponowne wejście (Allow Re-entry) jest włączona. Bez tego przekazywana będzie tylko pierwsza wiadomość od każdego kontaktu.


Przepływ pracy 2: Your AI Connector do GHL

Ten przepływ pracy odbiera odpowiedzi z Your AI Connector i wysyła je do klienta przez odpowiedni kanał GHL.

Krok 1: Utwórz przychodzący webhook w GHL

  1. W GHL przejdź do Ustawienia > Deweloperzy / API.
  2. Kliknij Utwórz nowy webhook (lub „Przychodzący webhook”).
  3. Nazwij go „Wiadomości”.
  4. Zapisz i skopiuj adres URL webhooka — będzie on potrzebny w następnym kroku.

Krok 2: Skonfiguruj Your AI Connector

  1. W Your AI Connector kliknij Ustawienia na pasku bocznym.
  2. W sekcji Kanały kliknij Kanały.
  3. Przewiń stronę na sam dół do karty Kanał niestandardowy.
  4. Wklej właśnie skopiowany przychodzący adres URL webhooka GHL w polu Adres URL webhooka (musi to być publiczny adres HTTPS) i kliknij Zapisz.

To nie jest strona Ustawienia → Integracje → Webhooki. Ta strona służy do powiadomień o zdarzeniach i wysyła inny ładunek (payload). Przekaźnik wychodzący GHL ustawia się na karcie Kanał niestandardowy w sekcji Ustawienia → Kanały.

Your AI Connector będzie teraz automatycznie wysyłać powiadomienie do GHL za każdym razem, gdy wiadomość zostanie wysłana do kontaktu. Przesyłane dane wyglądają następująco:

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

Uwaga nawigacyjna: klucz API używany w przepływie pracy 1 oraz karta Kanał niestandardowy używana tutaj znajdują się w różnych miejscach — klucz w Ustawienia → Integracje → Klucz API, a karta Kanał niestandardowy na dole strony Ustawienia → Kanały. Osobna strona Ustawienia → Integracje → Webhooki służy do powiadomień o zdarzeniach i wysyła inny ładunek; zobacz Webhooki, jeśli to właśnie chcesz skonfigurować.

Krok 3: Utwórz przepływ pracy odpowiedzi

  1. W GHL przejdź do Automatyzacja > Przepływy pracy.
  2. Utwórz nowy przepływ pracy o nazwie „Wyślij wiadomość do kontaktu”.
  3. Ustaw wyzwalacz na Przychodzący webhook i wybierz webhook utworzony w kroku 1.

Krok 4: Dodaj akcję Znajdź kontakt

  1. Dodaj akcję Znajdź kontakt.
  2. Ustaw pole wyszukiwania na Identyfikator kontaktu.
  3. Użyj wartości: {{inboundWebhookRequest.toId}}

Krok 5: Dodaj opcjonalne sprawdzanie tagów

Jeśli chcesz ograniczyć, które kontakty mają otrzymywać wiadomości z Your AI Connector:

  1. Dodaj akcję Warunek.
  2. Sprawdź, czy kontakt posiada określony tag.
  3. Jeśli tagu brakuje, zakończ przepływ pracy (dodaj akcję „Zatrzymaj” w fałszywej gałęzi).

Krok 6: Dodaj podział kanałów

Dodaj akcję Warunek (Condition), która kieruje wiadomość w oparciu o {{inboundWebhookRequest.channel}}:

Gałąź Warunek Akcja
Gałąź 1 równa się email Wyślij e-mail
Gałąź 2 równa się sms Wyślij SMS
Gałąź 3 równa się messenger Wyślij wiadomość na Facebooku
Gałąź 4 równa się ig Wyślij wiadomość na Instagramie
Gałąź 5 równa się livechat Wyślij wiadomość na czacie

Krok 7: Skonfiguruj każdą akcję wysyłania

W każdej akcji wysyłania ustaw treść wiadomości na:

{{inboundWebhookRequest.body}}

Krok 8: Włącz ponowne wejście

Podobnie jak w przypadku przepływu pracy 1, upewnij się, że opcja Zezwalaj na ponowne wejście (Allow Re-entry) jest włączona w ustawieniach przepływu pracy.


Testowanie integracji

Przetestuj GHL do Your AI Connector (Przepływ pracy 1)

  1. Wyślij wiadomość na swój numer GHL lub podłączony kanał (na przykład wyślij do siebie SMS).
  2. Otwórz Your AI Connector i sprawdź, czy wiadomość pojawiła się w Czatach.
  3. Sprawdź, czy etykieta kanału jest poprawna (SMS, e-mail itp.).
  4. Powtórz dla każdego skonfigurowanego kanału.

Przetestuj Your AI Connector do GHL (Przepływ pracy 2)

  1. W Your AI Connector wyślij odpowiedź do kontaktu (ręcznie lub pozwól AI odpowiedzieć).
  2. Otwórz GHL i sprawdź, czy kontakt otrzymał wiadomość.
  3. Potwierdź, że została wysłana przez właściwy kanał.
  4. Sprawdź, czy treść wiadomości się zgadza.

Rozwiązywanie problemów

Problem Co sprawdzić
Wiadomości nie docierają do Your AI Connector Sprawdź, czy klucz API w adresie URL webhooka jest poprawny. Sprawdź, czy wyzwalacze przepływu pracy działają (dzienniki przepływu pracy GHL). Potwierdź, że włączona jest opcja „Zezwalaj na ponowne wejście” (Allow Re-entry).
Wiadomości nie docierają do GHL Sprawdź, czy przychodzący adres URL webhooka GHL został poprawnie wklejony w polu Adres URL webhooka na karcie Kanał niestandardowy na dole strony Ustawienia → Kanały (nie na stronie Ustawienia → Integracje → Webhooki, która jest inną funkcją). Sprawdź, czy przychodzący webhook GHL jest aktywny. Przejrzyj dzienniki wykonania przepływu pracy GHL.
Nie znaleziono kontaktu w GHL toId w danych webhooka musi odpowiadać istniejącemu identyfikatorowi kontaktu w GHL. Upewnij się, że kontakty istnieją w obu systemach i mają pasujące identyfikatory.
Użyto niewłaściwego kanału do odpowiedzi Sprawdź dokładnie wartości kanałów w gałęziach warunkowych. Muszą być identyczne: email, sms, messenger, ig, livechat.
Przekazywana jest tylko pierwsza wiadomość Włącz opcję Zezwalaj na ponowne wejście (Allow Re-entry) w ustawieniach obu przepływów pracy.

Następne kroki

  • Webhooki — skonfiguruj webhooki dla innych zdarzeń Your AI Connector.
  • Dostęp do API — użyj API do niestandardowych integracji wykraczających poza GHL.
  • Niestandardowe kanały — dowiedz się więcej o przesyłaniu wiadomości przez niestandardowe kanały.