> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HighLevel

HighLevel jest też znany jako GoHighLevel, a jego API działa pod nazwą LeadConnector. Dzięki [narzędziu webhook](/docs/pl/reception-ai/integrations/webhooks) 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ę](/docs/pl/reception-ai/receptionist/testing), 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.

> **Warning**
>
> 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.

> **Tip**
>
> 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ę.                                                |