HighLevel | ElevenLabs Documentation

HighLevel jest też znany jako GoHighLevel, a jego API działa pod nazwą LeadConnector. Dzięki narzędziu webhook twój recepcjonista może zapisać każdego dzwoniącego jako kontakt na subkoncie HighLevel. Jeśli dzwoniący jest już kontaktem, HighLevel zaktualizuje istniejący rekord zamiast tworzyć duplikat.

Konfiguracja

Utwórz prywatny token integracji

Na subkoncie HighLevel otwórz Settings → Private Integrations i wybierz Create New Integration. Nadaj integracji nazwę, wybierz tylko zakresy do wyświetlania i edycji kontaktów, a następnie ją utwórz. Od razu skopiuj token: HighLevel wyświetla go tylko raz.

Jeśli w ustawieniach nie ma Private Integrations, poproś administratora agencji o dostęp.

Znajdź ID lokalizacji

Na tym samym subkoncie otwórz Settings → Business Profile i skopiuj Location ID.

Utwórz narzędzie webhook

W Reception.ai przejdź do Integrations, wybierz Add integration, a potem Webhook Tool.

Pole	Wartość
Nazwa	`save_highlevel_contact`
Opis	”Zapisz dzwoniącego jako kontakt w naszym CRM, gdy znasz jego imię i numer telefonu. Użyj przy każdej rozmowie z nowym lub powracającym klientem.”
Metoda	POST
URL	`https://services.leadconnectorhq.com/contacts/upsert`
Nagłówki żądania	`Authorization`: `Bearer` , a następnie twój token `Version`: `2021-07-28`
Parametry body	`locationId` (string, wymagane): “Zawsze dokładna wartość `LOCATION_ID`.” `firstName` (string, wymagane): “Imię dzwoniącego.” `lastName` (string): “Nazwisko dzwoniącego, jeśli je podał.” `phone` (string, wymagane): “Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123.” `email` (string): “Adres e-mail dzwoniącego, jeśli go podał.” `source` (string, wymagane): “Zawsze dokładna wartość `Reception.ai phone call`.”
Przypisz do agentów	Receptionist

Zastąp LOCATION_ID skopiowanym ID. Wybierz Enable.

Przetestuj

Przetestuj recepcjonistę, dzwoniąc i podając swoje imię oraz numer. Kontakt pojawi się w HighLevel w sekcji Contacts. Zadzwoń ponownie z tego samego numeru: HighLevel zaktualizuje kontakt zamiast dodać nowy.

Token może odczytywać i zmieniać twoje kontakty. Nie umieszczaj go we współdzielonych dokumentach i usuń prywatną integrację w HighLevel, jeśli token wycieknie.

HighLevel określa, czy dzwoniący jest już kontaktem, na podstawie ustawienia Allow Duplicate Contact subkonta. Jeśli ustawienie dopasowuje zarówno e-mail, jak i telefon, sprawdza je w kolejności podanej w ustawieniu.

Aby zrobić więcej po rozmowie, na przykład utworzyć okazję lub powiadomić zespół, zbuduj workflow w HighLevel, który zaczyna się od wyzwalacza Inbound Webhook. Skieruj drugie narzędzie webhook na adres URL workflow z potrzebnymi polami, a potem zmapuj je w workflow. Traktuj adres URL workflow jak sekret. HighLevel wymienia Inbound Webhook jako płatny wyzwalacz, więc sprawdź opłaty za użycie w swoim planie.

Ograniczenia

Serwer MCP HighLevel wymaga logowania OAuth, którego Reception.ai nie obsługuje, więc użyj narzędzia webhook.
Tagi i pola niestandardowe są listami w API HighLevel, a narzędzia webhook wysyłają płaskie wartości. Ustaw je przez workflow.
Dodawanie notatek lub zadań wymaga ID kontaktu w adresie URL, którego narzędzie webhook nie może uzupełnić podczas rozmowy. Użyj do tego workflow Inbound Webhook.

Rozwiązywanie problemów

Problem	Co sprawdzić
401 z HighLevel	Nagłówek `Authorization` musi zawierać `Bearer` , a po nim token, ze spacją po `Bearer`.
403 z HighLevel	Token potrzebuje zakresów kontaktów, a `locationId` musi wskazywać subkonto, na którym utworzono token.
HighLevel odrzuca wersję	Nagłówek `Version` musi mieć dokładnie wartość `2021-07-28`. Jeśli dokumentacja API HighLevel podaje nowszą wymaganą wartość, użyj jej.
Powracający dzwoniący są duplikowani	Sprawdź ustawienie Allow Duplicate Contact oraz czy numery telefonów zapisano w tym samym formacie międzynarodowym.
Kontakt nie ma imienia	W opisie narzędzia wskaż recepcjoniście, by przed zapisaniem zapytał dzwoniącego o imię.