Przejdź do nawigacji

Freshsales

Wyszukuj i dodawaj kontakty Freshsales oraz zapisuj notatki i zadania do wykonania podczas rozmów.

Twój recepcjonista może rozpoznawać osoby dzwoniące, które są już w Freshsales, dodawać nowe osoby jako kontakty, zapisywać, czego potrzebuje każda z nich, i tworzyć dla zespołu zadania do wykonania. Możesz połączyć na dwa sposoby:

  • Narzędzia webhook wywołują API Freshsales bezpośrednio — bez konta Zapier i bez zużywania zadań Zapier. API Freshsales wyszukuje kontakty po imieniu i nazwisku lub adresie e-mail, a nie po numerze telefonu, więc recepcjonista znajduje dzwoniących po adresie e-mail.
  • Zapier może też znaleźć dzwoniących po numerze telefonu, ale każda akcja zużywa zadania z planu Zapier.

Korzystaj z narzędzi webhook, chyba że musisz rozpoznawać dzwoniących po numerze telefonu.

Opcja 1: Narzędzia webhook (zalecane)

1

Pobierz klucz API i alias pakietu

W Freshsales wybierz swoje zdjęcie profilowe, otwórz Profile Settings i przejdź na kartę API Settings. Skopiuj Your API key oraz alias pakietu pod nim, który wygląda jak yourcompany.myfreshworks.com/crm/sales. W poniższych adresach URL zastąp nim BUNDLE_ALIAS, bez https://.

Klucz działa jak twój użytkownik i może robić w Freshsales wszystko, co ty. Rozważ utworzenie go z konta użytkownika, którego rola pozwala tylko na pracę z kontaktami, notatkami i zadaniami.

2

Znajdź identyfikatory do ustawienia

Nowe kontakty i zadania wymagają ID użytkownika, który jest ich właścicielem. Możesz też ustawić źródło leada i etap cyklu życia nowych kontaktów. Uruchom poniższe polecenia w terminalu, zastępując YOUR_API_KEY i BUNDLE_ALIAS, a następnie zapisz id każdej wartości, której chcesz użyć:

curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/owners
curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/lead_sources
curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/lifecycle_stages
3

Utwórz narzędzia webhook

Dla każdego narzędzia poniżej przejdź do Integrations, wybierz Add integration, a potem Webhook Tool. Każde narzędzie wysyła ten sam nagłówek: Authorization (Secret), ustawiony na Token token=, po którym podajesz swój klucz API.

Znajdź dzwoniącą osobę

PoleWartość
Nazwafind_freshsales_contact
Opis”Znajdź dzwoniącą osobę w naszym CRM po adresie e-mail. Użyj tego przed dodaniem nowego kontaktu. Przekaż id kontaktu do narzędzi notatek i zadań.”
MetodaGET
URLhttps://BUNDLE_ALIAS/api/lookup
Nagłówki żądaniaAuthorization (Secret): Token token=, po którym podajesz swój klucz API
Parametry zapytaniaq (string, wymagane): “Adres e-mail dzwoniącej osoby, dokładnie tak, jak go podaje.”
f (string, stała wartość): email
entities (string, stała wartość): contact
Przypisz do agentówRecepcjonista

Freshsales zwraca tylko dokładne dopasowania, więc recepcjonista powinien potwierdzić z dzwoniącą osobą pisownię adresu e-mail.

Dodaj dzwoniącą osobę

PoleWartość
Nazwacreate_freshsales_contact
Opis”Dodaj dzwoniącą osobę jako kontakt tylko wtedy, gdy find_freshsales_contact jej nie znajdzie.”
MetodaPOST
URLhttps://BUNDLE_ALIAS/api/contacts
Nagłówki żądaniaAuthorization (Secret): Token token=, po którym podajesz swój klucz API
Parametry treścicontact (object, wymagane), z polami poniżej
Przypisz do agentówRecepcjonista

Dla każdego z tych pól wybierz Add field w contact:

  • first_name (string, wymagane, z rozmowy): “Imię dzwoniącej osoby.”
  • last_name (string, z rozmowy): “Nazwisko dzwoniącej osoby, jeśli je podała.”
  • mobile_number (string, wymagane, z rozmowy): “Numer telefonu dzwoniącej osoby w formacie międzynarodowym, na przykład +14155550123.”
  • emails (array, z rozmowy): “Dokładnie jeden element z adresem e-mail dzwoniącej osoby. Pomiń, jeśli go nie podała.” W sekcji Each item wybierz object i dodaj dwa pola:
    • value (string, wymagane, z rozmowy): “Adres e-mail dzwoniącej osoby.”
    • is_primary (boolean, stała wartość): true
  • owner_id (integer, stała wartość): ID właściciela
  • lead_source_id (integer, stała wartość): ID źródła leada, jeśli chcesz je ustawić
  • lifecycle_stage_id (integer, stała wartość): ID etapu cyklu życia, jeśli chcesz go ustawić

Zapisz notatkę

PoleWartość
Nazwaadd_freshsales_note
Opis”Zapisz przy kontakcie, czego potrzebuje dzwoniąca osoba, zanim rozmowa się zakończy.”
MetodaPOST
URLhttps://BUNDLE_ALIAS/api/notes
Nagłówki żądaniaAuthorization (Secret): Token token=, po którym podajesz swój klucz API
Parametry treścinote (object, wymagane), z polami poniżej
Przypisz do agentówRecepcjonista

Dla każdego z tych pól wybierz Add field w note:

  • description (string, wymagane, z rozmowy): “Czego potrzebuje dzwoniąca osoba, w kilku zdaniach.”
  • targetable_type (string, stała wartość): Contact
  • targetable_id (integer, wymagane, z rozmowy): “id kontaktu z find_freshsales_contact lub create_freshsales_contact.”

Utwórz zadanie do wykonania

PoleWartość
Nazwacreate_freshsales_task
Opis”Utwórz dla zespołu zadanie do wykonania zawsze, gdy obiecasz dzwoniącej osobie oddzwonić.”
MetodaPOST
URLhttps://BUNDLE_ALIAS/api/tasks
Nagłówki żądaniaAuthorization (Secret): Token token=, po którym podajesz swój klucz API
Parametry treścitask (object, wymagane), z polami poniżej
Przypisz do agentówRecepcjonista

Dla każdego z tych pól wybierz Add field w task:

  • title (string, wymagane, z rozmowy): “Na przykład: Oddzwoń do Jane Doe w sprawie wyceny.”
  • description (string, z rozmowy): “Imię i nazwisko dzwoniącej osoby, numer telefonu oraz to, czego potrzebuje.”
  • due_date (string, wymagane, z rozmowy): “Kiedy zespół powinien oddzwonić — jako data i godzina ISO 8601, na przykład 2026-06-21T11:00:00Z.”
  • owner_id (integer, stała wartość): ID użytkownika obsługującego oddzwonienia
  • targetable_type (string, stała wartość): Contact
  • targetable_id (integer, wymagane, z rozmowy): “id kontaktu z find_freshsales_contact lub create_freshsales_contact.”

Właściciel i typy rekordów są stałymi wartościami, więc nowe kontakty i zadania zawsze trafiają do wskazanych osób, nawet jeśli AI wyśle inne wartości.

find_freshsales_contact zwraca wszystko, co zapisano w kontakcie. Dodaj regułę, która nakaże recepcjoniście, by nigdy nie odczytywał dzwoniącej osobie danych kontaktu i używał ich wyłącznie do jej rozpoznania.

Wybierz Enable przy każdym narzędziu, a potem przetestuj recepcjonistę jako nowa dzwoniąca osoba, która podaje adres e-mail i prosi o oddzwonienie. Kontakt, notatka i zadanie pojawią się w Freshsales.

Opcja 2: Zapier

1

Połącz Zapier

Jeśli jeszcze tego nie zrobiono, połącz Zapier w Reception.ai.

2

Dodaj akcje Freshsales

Na serwerze Zapier MCP pod adresem mcp.zapier.com dodaj akcje poniżej z aplikacji Freshsales Suite i połącz konto Freshsales. Dla każdego pola ustaw stałą wartość lub pozwól AI je wypełnić — zgodnie z poniższą listą.

3

Przypisz narzędzia

W Reception.ai otwórz kartę Tools integracji Zapier, wybierz Refresh tools i przypisz każdą akcję zgodnie z listą.

4

Przetestuj

Przetestuj recepcjonistę jako nowa dzwoniąca osoba, która prosi o oddzwonienie. Kontakt, notatka i zadanie pojawią się w Freshsales.

Akcje Zapier

Znajdź dzwoniącą osobę

PoleWartość
Akcja ZapierFind Contact by Unique Fields
Ustaw w ZapierPole wyszukiwania: numer telefonu.
Pozwól AI wypełnićSzukana wartość: numer telefonu dzwoniącej osoby.
Przypisz doKlient

Dodaj dzwoniącą osobę

PoleWartość
Akcja ZapierCreate Contact
Ustaw w ZapierWłaściciel sprzedaży, źródło leada, etap cyklu życia i wszelkie tagi.
Pozwól AI wypełnićImię, nazwisko, numer telefonu komórkowego i adres e-mail.
Przypisz doKlient

Zapisz notatkę

PoleWartość
Akcja ZapierAdd Note
Ustaw w ZapierModuł: Contact.
Pozwól AI wypełnićID kontaktu (z poprzednich akcji) i tekst notatki.
Przypisz doKlient

Utwórz zadanie do wykonania

PoleWartość
Akcja ZapierCreate Task
Ustaw w ZapierModuł (Contact) i właściciel obsługujący oddzwonienia.
Pozwól AI wypełnićTytuł, termin, opis i ID kontaktu.
Przypisz doKlient

Niezależnie od wybranej opcji dodaj procedurę, aby recepcjonista najpierw wyszukiwał dzwoniącą osobę i tworzył kontakt tylko wtedy, gdy nie znajdzie dopasowania.

Ograniczenia

  • Freshsales nie pozwala na dwa kontakty z tym samym numerem telefonu komórkowego lub adresem e-mail, więc utworzenie kontaktu dla osoby, która jest już zapisana, zakończy się błędem. Recepcjonista powinien najpierw wyszukać kontakt.
  • W narzędziach webhook recepcjonista znajduje dzwoniących tylko po adresie e-mail. Aby wyszukiwać ich po numerze telefonu, użyj akcji Find Contact by Unique Fields w Zapier.
  • Aplikacja Freshsales w Zapier nie może sprawdzać dostępności, więc recepcjonista nie może bezpiecznie rezerwować spotkań w Freshsales. Zamiast tego użyj zadania do wykonania albo własnej rezerwacji Reception z Google Calendar.
  • W Zapier każda akcja uruchomiona przez recepcjonistę zużywa zadania z planu Zapier. Zapier obecnie nalicza dwa zadania za każde udane połączenie; nieudane połączenia nie są naliczane. Gdy plan się wyczerpie, akcje zatrzymają się do jego odnowienia.

Rozwiązywanie problemów

ProblemCo sprawdzić
401 z FreshsalesNagłówek Authorization musi mieć wartość Token token=, po której podajesz klucz API, bez Bearer.
404 z FreshsalesSprawdź, czy każdy URL zaczyna się od https://, potem zawiera alias pakietu, a następnie /api/.
Akcja Freshsales nie pojawia się w Reception.aiPo dodaniu akcji w Zapier wybierz Refresh tools w integracji Zapier.
Akcja ma status Changed i nie jest używanaZostała edytowana w Zapier. Wybierz Update na karcie Tools.
Znane osoby dzwoniące nie są znajdowaneW narzędziach webhook adres e-mail musi być identyczny. W Zapier Freshsales dopasowuje numery telefonów w zapisanym formacie, więc zapisuj numery w jednym formacie albo wyszukuj też po e-mailu.
Utworzenie kontaktu kończy się błędemOsoba dzwoniąca może już być zapisana pod tym numerem telefonu komórkowego lub adresem e-mail. Najpierw ją wyszukaj.
Utworzenie zadania kończy się błędemdue_date musi być datą i godziną akceptowaną przez Freshsales. Jeśli wartość ISO 8601, taka jak 2026-06-21T11:00:00Z, zostanie odrzucona, opisz zamiast tego format z przykładu Freshsales, na przykład Tue Jun 21 2026 11:00:00 GMT+0000.
Notatki lub zadania nie są połączone z dzwoniącą osobąRecepcjonista potrzebuje ID kontaktu z narzędzia wyszukiwania lub tworzenia albo z akcji Find Contact by Unique Fields lub Create Contact w Zapier.