> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # EspoCRM Dzięki poniższym [narzędziom webhook](/docs/pl/reception-ai/integrations/webhooks) twoja recepcjonistka rozpozna osoby dzwoniące, które są już w EspoCRM, i doda nowych dzwoniących jako leady — wraz z imieniem, nazwiskiem, numerem telefonu i informacją, czego potrzebują — aby twój zespół mógł się z nimi skontaktować. API EspoCRM używa statycznego klucza API i treści żądań JSON, więc działa tak samo w EspoCRM Cloud i instalacjach self-hosted. ## Zanim zaczniesz ### Utwórz rolę W EspoCRM przejdź do **Administracja** → **Role** i utwórz rolę, która może odczytywać i tworzyć **Leady** oraz odczytywać **Kontakty**. Wszystkie pozostałe zakresy pozostaw wyłączone. ### Utwórz użytkownika API Przejdź do **Administracja** → **Użytkownicy API** i utwórz użytkownika. Ustaw metodę uwierzytelniania na **Klucz API** i przypisz utworzoną przed chwilą rolę. Zapisz zmiany, a potem skopiuj klucz API z widoku szczegółów użytkownika. Każde narzędzie poniżej wysyła klucz w nagłówku żądania o nazwie `X-Api-Key`. Ustaw jego **Typ** na **Tajny**. > **Warning** > > Klucz API może odczytywać i zmieniać wszystko, na co pozwala jego rola. Ogranicz zakres roli i wygeneruj nowy > klucz w EspoCRM, jeśli wycieknie. ### Znajdź adres EspoCRM Adresy URL narzędzi zaczynają się od adresu, który otwierasz w przeglądarce, aby korzystać z EspoCRM, a następnie mają `/api/v1/`. W tabelach poniżej używamy `https://YOUR-CRM.example.com`; zastąp go własnym adresem. ## Utwórz narzędzia Dla każdego narzędzia przejdź do **Integracje**, wybierz **Dodaj integrację**, potem **Narzędzie webhook** i ustaw **Przypisz do agentów** na **Recepcjonistka**. Dla każdego parametru oznaczonego poniżej jako „Zawsze” ustaw **Wartość** na **Wartość stała**. ### Znajdź leada | Pole | Wartość | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `find_espocrm_lead` | | **Opis** | "Znajdź dzwoniącego wśród naszych leadów po numerze telefonu. Użyj tego na początku rozmowy, aby sprawdzić, czy kontaktował się z nami wcześniej." | | **Metoda** | GET | | **URL** | `https://YOUR-CRM.example.com/api/v1/Lead` | | **Nagłówki żądania** | `X-Api-Key`: twój klucz API | | **Parametry zapytania** | `textFilter` (ciąg znaków, wymagany): "Numer telefonu dzwoniącego z kodem kraju, na przykład +14155550123." `select` (ciąg znaków): Zawsze `id,name,status`. `maxSize` (liczba całkowita): Zawsze `5`. | Aby rozpoznawać też obecnych klientów, utwórz drugie narzędzie o nazwie `find_espocrm_contact` z tymi samymi ustawieniami i adresem URL `https://YOUR-CRM.example.com/api/v1/Contact`. ### Dodaj nowego leada | Pole | Wartość | | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `create_espocrm_lead` | | **Opis** | "Dodaj dzwoniącego jako nowego leada, gdy `find_espocrm_lead` go nie znajdzie." | | **Metoda** | POST | | **URL** | `https://YOUR-CRM.example.com/api/v1/Lead` | | **Nagłówki żądania** | `X-Api-Key`: twój klucz API | | **Parametry treści** | `firstName` (ciąg znaków, wymagany): "Imię dzwoniącego." `lastName` (ciąg znaków, wymagany): "Nazwisko dzwoniącego." `phoneNumber` (ciąg znaków, wymagany): "Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123." `emailAddress` (ciąg znaków): "Adres e-mail dzwoniącego, jeśli go podał." `description` (ciąg znaków, wymagany): "Czego potrzebuje dzwoniący i kiedy chciałby otrzymać telefon zwrotny." `status` (ciąg znaków): Zawsze `New`. `source` (ciąg znaków): Zawsze `Call`. | Aby kierować nowe leady do jednego sprzedawcy, dodaj `assignedUserId` (ciąg znaków) jako wartość stałą z identyfikatorem tego użytkownika. Identyfikator zobaczysz na pasku adresu, gdy otworzysz użytkownika w EspoCRM. Wybierz **Włącz** przy każdym narzędziu, a potem [przetestuj recepcjonistkę](/docs/pl/reception-ai/receptionist/testing) jako nowy dzwoniący, który prosi o wycenę. Lead pojawi się w EspoCRM ze statusem **New** i źródłem **Call**. > **Tip** > > Dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), aby recepcjonistka > najpierw wyszukiwała, a leada dodawała tylko wtedy, gdy nie znajdzie dopasowania. > **Warning** > > Wyszukiwanie dopasowuje też imiona, nazwiska i adresy e-mail, więc dzwoniący może próbować wyszukać kogoś innego. > Dodaj zasadę, że recepcjonistka nigdy nie odczytuje dzwoniącym danych z CRM, i ogranicz **select** > do `id,name,status`. ## Ograniczenia * `textFilter` działa tak samo jak wyszukiwarka EspoCRM: przeszukuje imiona, nazwiska, adresy e-mail i numery telefonów. Wyszukanie po numerze telefonu może też dopasować inny rekord, którego numer zaczyna się od tych samych cyfr, więc recepcjonistka powinna potwierdzić imię i nazwisko dzwoniącego. * Za pomocą tych narzędzi recepcjonistka nie może dodać notatki ani zadania do istniejącego leada lub kontaktu. Opis nowego leada zawiera szczegóły rozmowy. * Narzędzia nie ustawiają zespołów. EspoCRM przyjmuje zespoły jako listę identyfikatorów zespołów (`teamsIds`), a narzędzie webhook zawsze wypełnia listę na podstawie rozmowy, więc nie może przypisać każdego leada do tego samego zespołu, a recepcjonistka nie powinna wybierać zespołów. Zamiast tego użyj `assignedUserId`, aby kierować leady. ## Rozwiązywanie problemów | Problem | Co sprawdzić | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 z EspoCRM | Nagłówek musi nazywać się `X-Api-Key` i zawierać klucz z widoku szczegółów użytkownika API. Sprawdź, czy użytkownik API jest aktywny. | | 403 z EspoCRM | Rola użytkownika API nie może odczytywać ani tworzyć leadów. Edytuj rolę w **Administracja** → **Role**. | | 409 podczas dodawania leada | EspoCRM znalazł możliwy duplikat, na przykład leada o tym samym imieniu, nazwisku lub adresie e-mail. Recepcjonistka powinna najpierw wyszukać rekord. | | Nie znaleziono znanych dzwoniących | Zapisuj numery telefonów w formacie międzynarodowym, np. `+14155550123`, i sprawdź, czy numer jest przypisany do leada lub kontaktu, a nie tylko do konta. | | Błędy `status` lub `source` | Wartości muszą dokładnie odpowiadać opcjom **Status** i **Źródło** leadów ustawionym w **Administracja** → **Menedżer encji** → **Lead**. |