Przejdź do nawigacji
IntegracjePrzewodniki konfiguracjiCRM

EspoCRM

Rozpoznawaj dzwoniących i dodawaj nowe leady do EspoCRM za pomocą narzędzi webhook.

Dzięki poniższym narzędziom webhook 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

1

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.

2

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.

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.

3

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

PoleWartość
Nazwafind_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.”
MetodaGET
URLhttps://YOUR-CRM.example.com/api/v1/Lead
Nagłówki żądaniaX-Api-Key: twój klucz API
Parametry zapytaniatextFilter (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

PoleWartość
Nazwacreate_espocrm_lead
Opis”Dodaj dzwoniącego jako nowego leada, gdy find_espocrm_lead go nie znajdzie.”
MetodaPOST
URLhttps://YOUR-CRM.example.com/api/v1/Lead
Nagłówki żądaniaX-Api-Key: twój klucz API
Parametry treścifirstName (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ę jako nowy dzwoniący, który prosi o wycenę. Lead pojawi się w EspoCRM ze statusem New i źródłem Call.

Dodaj procedurę, aby recepcjonistka najpierw wyszukiwała, a leada dodawała tylko wtedy, gdy nie znajdzie dopasowania.

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

ProblemCo sprawdzić
401 z EspoCRMNagłó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 EspoCRMRola użytkownika API nie może odczytywać ani tworzyć leadów. Edytuj rolę w Administracja → Role.
409 podczas dodawania leadaEspoCRM 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ącychZapisuj 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 sourceWartości muszą dokładnie odpowiadać opcjom Status i Źródło leadów ustawionym w Administracja → Menedżer encji → Lead.