Funkcje niestandardowe #

Funkcje niestandardowe pozwalają Twojemu botowi AI łączyć się z innymi systemami podczas rozmów na żywo. Zamiast mówić „Sprawdzę to i wrócę z odpowiedzią”, bot może sprawdzić status zamówienia, zweryfikować stan magazynowy lub utworzyć rekord w Twoim systemie CRM (system zarządzania relacjami z klientami – oprogramowanie używane do śledzenia potencjalnych klientów i klientów, takie jak HubSpot lub Salesforce) – wszystko w czasie rzeczywistym, podczas gdy klient czeka.

Funkcje niestandardowe a webhooki #

Jest to najczęstszy punkt nieporozumień, więc warto go wyjaśnić, zanim zaczniesz cokolwiek budować.

Kiedy co wybrać: Jeśli musisz tylko poinformować inny system, że coś się wydarzyło, użyj webhooka – jednokierunkowej zautomatyzowanej wiadomości wysyłanej do innego systemu (zobacz Ustawienia → Integracje → Webhooki). Jeśli bot musi dowiedzieć się czegoś z innego systemu przed kontynuowaniem rozmowy, użyj funkcji niestandardowej.

Przykłady tego, co umożliwiają funkcje niestandardowe #

Ponieważ odpowiedź wraca do rozmowy, funkcje niestandardowe otwierają możliwości, których webhooki po prostu nie mają:

• Sprawdzanie stanów magazynowych w Shopify lub WooCommerce na żywo — Zanim bot poda cenę klientowi, sprawdza stan magazynowy w czasie rzeczywistym i odpowiada „Tak, mamy 12 sztuk w rozmiarze M” zamiast „sprawdzę to i wrócę z odpowiedzią”.
• Dynamiczne ceny z Arkuszy Google — Twój zespół sprzedaży aktualizuje ceny w arkuszu; bot odczytuje najnowszy wiersz w trakcie rozmowy i podaje aktualną cenę bez konieczności ingerencji w konfigurację AI.
• Agent oddzwaniający Voice-AI — Gdy bot zakwalifikuje potencjalnego klienta, uruchamia agenta głosowego (na przykład dzwoniącego opartego na ElevenLabs), aby oddzwonił do klienta w ciągu kilku minut, i potwierdza klientowi: „świetnie, proszę spodziewać się telefonu w ciągu najbliższych 5 minut”.
• Niestandardowa wycena w PDF, generowana i wysyłana e-mailem w trakcie czatu — Bot zbiera wymagania, wywołuje Twój generator wycen, otrzymuje adres URL do pliku PDF i mówi klientowi: „Właśnie wysłałem wycenę na Twój adres e-mail — sprawdź skrzynkę odbiorczą”.

Co mogą robić funkcje niestandardowe? #

Pomyśl o funkcjach niestandardowych jako o nadaniu botowi supermocy wykraczających poza zwykłe czatowanie. Oto przykłady z życia wzięte:

• Śledzenie zamówień - Klient pyta „Gdzie jest moje zamówienie?”, a bot sprawdza Twój system e-commerce i odpowiada, podając status przesyłki oraz link do śledzenia
• Sprawdzanie stanów magazynowych - „Czy macie to w rozmiarze 10?” Bot sprawdza Twój system magazynowy i udziela odpowiedzi w czasie rzeczywistym
• Aktualizacje CRM - Gdy bot zakwalifikuje potencjalnego klienta, automatycznie tworzy lub aktualizuje rekord w HubSpot, Salesforce lub dowolnym innym systemie CRM
• Generowanie wycen - Bot zbiera wymagania klienta i generuje spersonalizowaną wycenę z Twojego systemu cenników
• Rezerwacje - Bot tworzy spotkanie w Twoim zewnętrznym systemie rezerwacji
• Weryfikacja rabatów - „Czy ten kod kuponu jest ważny?” Bot sprawdza i potwierdza
• Wyszukiwanie konta - Powracający klient jest automatycznie rozpoznawany, a szczegóły jego konta są pobierane

Klient nigdy nie widzi tego, co dzieje się za kulisami. Po prostu doświadcza kontaktu z botem, który potrafi odpowiedzieć na jego pytania, korzystając z rzeczywistych, aktualnych informacji.

Jak działają funkcje niestandardowe (wersja uproszczona) #

Oto co dzieje się, gdy funkcja niestandardowa jest wyzwalana podczas rozmowy:

1. Klient pyta o coś, co wymaga danych w czasie rzeczywistym (np. „Gdzie jest moje zamówienie?”)
2. Bot rozpoznaje, że aby odpowiedzieć, musi użyć funkcji niestandardowej
3. Bot zbiera wszelkie brakujące informacje od klienta (np. „Jaki jest numer Twojego zamówienia?”)
4. Platforma wysyła żądanie do Twojego systemu (Twojej strony internetowej, CRM lub innego narzędzia) z odpowiednimi szczegółami
5. Twój system odpowiada danymi (np. statusem zamówienia, numerem śledzenia, datą dostawy)
6. Bot odczytuje odpowiedź i tworzy naturalną odpowiedź: „Twoje zamówienie ORD-4582 zostało wysłane i powinno dotrzeć do piątku!”

Ile kosztuje wywołanie funkcji niestandardowej #

Każde wywołanie funkcji niestandardowej jest rozliczane zgodnie z poziomem jakości AI Twojego Agenta:

Konfigurowanie funkcji niestandardowej (krok po kroku) #

1. W głównym pasku bocznym, w sekcji AI Studio, kliknij Custom Functions.

2. Kliknij zielony przycisk + Add Function (lub New function) w prawym górnym rogu.

Lista funkcji niestandardowych wyświetla tabelę z następującymi kolumnami:

Dzięki temu łatwo jest przejrzeć swoje funkcje i szybko znaleźć tę, której potrzebujesz.

Krok 1: Nadaj nazwę i opis #

Wskazówka: Bądź bardzo precyzyjny w opisie i celu. Im jaśniej określisz, kiedy funkcja powinna być użyta, tym bardziej niezawodnie bot będzie z niej korzystał we właściwym momencie.

Krok 2: Skonfiguruj połączenie #

Musisz wskazać aplikacji, gdzie wysłać żądanie:

Którą metodę wybrać:

Jeśli nie masz pewności, której użyć, skonsultuj się z programistą lub sprawdź dokumentację systemu, z którym się łączysz. GET (do wyszukiwania) i POST (do tworzenia rekordów) są najczęściej używane.

Krok 3: Dodaj nagłówki uwierzytelniania #

Większość systemów wymaga uwierzytelnienia, aby zaakceptować żądania. Dodaj wszelkie wymagane nagłówki:

Wskazówka dotycząca bezpieczeństwa: Używaj dedykowanego klucza API z ograniczonymi uprawnieniami. Nie używaj danych logowania na poziomie administratora.

Gdzie znaleźć klucze API: Sprawdź ustawienia lub sekcję dla programistów w systemie, z którym się łączysz (np. CRM, platforma e-commerce lub narzędzie do rezerwacji).

Krok 4: Zdefiniuj dane wejściowe (co wysyła bot) #

Parametry wejściowe to informacje, które bot zbiera podczas rozmowy i wysyła do Twojego systemu.

Dla każdego parametru określasz:

Dostępne typy parametrów:

Każdy parametr posiada również opcjonalne pole Ścieżka treści żądania (Request body path). Zazwyczaj parametr jest wysyłany jako pole najwyższego poziomu w treści żądania (lub jako wartość ciągu zapytania dla typu query_param). Jeśli Twój punkt końcowy oczekuje zagnieżdżenia — np. {"order": {"id": "ORD-123"}} — ustaw ścieżkę na order.id, a platforma automatycznie zagnieździ tam wartość.

Przykład: Dla wyszukiwania statusu zamówienia możesz zdefiniować:

• order_number (string, wymagane): „Numer zamówienia klienta. Zazwyczaj zaczyna się od ORD- i następuje po nim ciąg cyfr. Zapytaj klienta o ten numer, jeśli go nie podał.”
• email (string, opcjonalne): „Adres e-mail klienta do dodatkowej weryfikacji. Potrzebny tylko wtedy, gdy sam numer zamówienia nie pozwala na znalezienie dopasowania.”

Co Twój system otrzymuje automatycznie #

Oprócz zdefiniowanych przez Ciebie parametrów wejściowych, platforma automatycznie dołącza dane systemowe do każdego żądania. Twój punkt końcowy otrzymuje je w polu system:

Jest to przydatne, jeśli Twój system musi zidentyfikować kontakt, sprawdzić, która kampania wywołała funkcję, lub zachowywać się inaczej podczas testów.

Nie potrzebujesz danych systemowych? Włącz przełącznik Pomiń dane systemowe (Skip System Data) w kreatorze funkcji. Bot wyśle wtedy tylko zdefiniowane przez Ciebie parametry wejściowe — bez danych kontaktu czy kampanii. Użyj tego, jeśli Twój punkt końcowy odrzuca nieoczekiwane pola lub po prostu chcesz uzyskać mniejszy ładunek danych (payload).

Krok 5: Przetestuj, a następnie pozwól botowi odczytać odpowiedź #

Zazwyczaj nie musisz w ogóle mapować pól odpowiedzi. Gdy Twój punkt końcowy odpowie, bot odczyta całą odpowiedź JSON i użyje Opisu oraz Celu (Działanie AI) Twojej funkcji — wraz z opisem każdego parametru — aby ustalić, co jest istotne i przedstawić to w naturalny sposób. Jasny opis samej funkcji („Pobiera aktualny status zamówienia klienta, w tym informacje o wysyłce i śledzeniu”) wykonuje tutaj więcej pracy niż mapowanie pole po polu.

Jeśli Twój punkt końcowy zwraca dużą odpowiedź, a chcesz, aby bot widział tylko kilka konkretnych wartości, otwórz sekcję Mapowanie odpowiedzi (domyślnie zwiniętą, tuż nad przyciskiem Test). Każdy wiersz wybiera jedno pole najwyższego poziomu z odpowiedzi: Pole odpowiedzi to nazwa pola w odpowiedzi JSON Twojego API, a Pole wyjściowe to nazwa, pod którą bot je otrzymuje. Po wypełnieniu co najmniej jednego wiersza bot otrzyma tylko zmapowane wartości zamiast pełnej treści odpowiedzi. Pozostaw sekcję pustą, aby zachować domyślne zachowanie pełnej odpowiedzi.

Zanim zapiszesz, użyj sekcji Test na dole kreatora, aby wysłać żądanie dokładnie tak, jak zostało skonfigurowane, i zobaczyć rzeczywistą odpowiedź bez opuszczania aplikacji:

Odpowiedź, którą tutaj widzisz, to surowa odpowiedź punktu końcowego. Jeśli powyżej skonfigurowano Mapowanie odpowiedzi, bot w rzeczywistym czacie otrzyma tylko te zmapowane pola — test zawsze pokazuje pełną, surową odpowiedź, aby można było zobaczyć, co jest dostępne do zmapowania. Jeśli coś wygląda nie tak (nieoczekiwane nazwy pól, dodatkowe zagnieżdżenie), popraw to w swoim punkcie końcowym lub dostosuj mapowanie.

Przypisywanie funkcji do agenta #

Po utworzeniu funkcji niestandardowej musisz wskazać każdemu agentowi, z jakich funkcji może korzystać:

1. Otwórz Agenta w sekcji AI Studio → Agenci AI.
2. Przejdź do karty Możliwości AI. (W przypadku kampanii, która nadal posiada własne ustawienia AI bezpośrednio, a nie za pośrednictwem oddzielnego agenta, ta sama lista pojawia się w kroku Możliwości AI danej kampanii).
3. Zobaczysz listę wszystkich utworzonych funkcji niestandardowych. Włącz każdą funkcję, której bot tego agenta ma móc używać.
4. Kliknij Zapisz zmiany na dole. Wybory zostaną zastosowane dopiero po zapisaniu.

Dla bota danego agenta dostępne są tylko przypisane funkcje. Zapobiega to przypadkowemu użyciu przez bota funkcji, które nie są istotne.

Testowanie funkcji niestandardowych #

Przed uruchomieniem przetestuj wszystko dokładnie:

1. Uruchom wbudowany test - Użyj sekcji Test wewnątrz kreatora funkcji (patrz wyżej), aby szybko sprawdzić działanie bez opuszczania aplikacji — wpisz realistyczne wartości i kliknij Uruchom test.
2. Przetestuj bezpośrednio punkt końcowy swojego systemu - W przypadku pełnej listy kontrolnej poniżej, dedykowane narzędzie takie jak Postman (lub Twój programista) pozwala na głębszą analizę niż pojedynczy test.
3. Przetestuj w trybie wypróbowania (Try Out) - Zasymuluj rozmowę, w której klient pyta o coś, co powinno wywołać funkcję.
4. Sprawdź odpowiedź - Upewnij się, że bot poprawnie odczytuje i prezentuje dane.
5. Przetestuj scenariusze błędów - Co się stanie, jeśli klient poda nieprawidłowy numer zamówienia? Co jeśli Twój system jest tymczasowo niedostępny?

Gdy test zwraca błąd 401 lub 403 #

Błąd 401 lub 403 oznacza, że Twój punkt końcowy otrzymał żądanie, ale je odrzucił. Wskazówką jest to, że w Twoich logach nic się nie pojawia — większość narzędzi odrzuca nieautoryzowane wywołanie, zanim jeszcze rozpocznie przepływ pracy, więc po Twojej stronie nic nie widać i wygląda to tak, jakby żądanie nigdy nie dotarło.

Prawie zawsze jest to niedopasowanie uwierzytelniania: Twój punkt końcowy wymaga jednego rodzaju poświadczeń, a funkcja wysyła inne. Sprawdź, czy nagłówek dodany w Kroku 3 jest dokładnie tym, którego oczekuje Twój system.

Najczęstszą wersją tego problemu jest webhook chroniony za pomocą Basic Auth (n8n, Make i większość narzędzi hostowanych samodzielnie oferuje to jako pole wyboru w samym webhooku), podczas gdy funkcja wysyła niestandardowy nagłówek z kluczem tajnym, taki jak X-My-Secret. Basic Auth akceptuje tylko nagłówek Authorization, więc niestandardowy nagłówek jest ignorowany, a wywołanie odrzucane. Masz dwie opcje:

• Wyłącz Basic Auth w webhooku i sprawdź swój niestandardowy nagłówek bezpośrednio wewnątrz przepływu pracy.
• Pozostaw włączone Basic Auth i dodaj do funkcji nagłówek Authorization, którego wartością jest słowo Basic, a po nim Twój zakodowany w base64 username:password.

Oba rozwiązania działają — po prostu upewnij się, że obie strony są ze sobą zgodne.

Gdy test zwraca błąd 404 #

Adres URL punktu końcowego jest nieprawidłowy lub przepływ pracy nie został opublikowany. W przypadku n8n każdy webhook ma oddzielny adres URL Test oraz Production, a ten testowy nasłuchuje tylko wtedy, gdy masz otwarty edytor. Skopiuj adres URL wersji produkcyjnej (Production) i upewnij się, że przepływ pracy jest aktywny.

Wyświetlanie błędów w Try Out i Chats #

Gdy sztuczna inteligencja wywołuje funkcję niestandardową podczas rozmowy, a wywołanie kończy się niepowodzeniem — błędne dane uwierzytelniające, niedostępny punkt końcowy, przekroczenie limitu czasu — rozmowa teraz to pokazuje: w wątku pojawia się czerwony znacznik „(nazwa funkcji) failed”, zarówno w karcie Try Out agenta, jak i w rzeczywistych rozmowach w Chats. Kliknij znacznik, aby rozwinąć szczegóły: kod stanu zwrócony przez Twój punkt końcowy oraz treść odpowiedzi, co zazwyczaj wystarcza, aby dokładnie określić, co należy naprawić (komunikat 401 z informacją „unauthorized” oznacza problem z nagłówkiem uwierzytelniania, a przekroczenie limitu czasu oznacza, że Twój punkt końcowy odpowiadał dłużej niż 30 sekund).

Pomyślne wywołania również wyświetlają znacznik — kliknij go, aby zobaczyć, co faktycznie zwrócił Twój punkt końcowy. Jest to najszybszy sposób na debugowanie integracji od początku do końca: przeprowadź rozmowę testową w Try Out, a następnie kliknij znacznik funkcji, aby zobaczyć rzeczywisty wynik żądania bez opuszczania strony.

Pełny przykład: Wyszukiwanie statusu zamówienia #

Oto w pełni skonfigurowany przykład, którego możesz użyć jako szablonu:

Podstawowe informacje:

• Nazwa: check_order_status
• Opis: “Pobiera aktualny status zamówienia klienta, w tym informacje o wysyłce i śledzeniu”
• Działanie AI: “Wywołaj to, gdy klient pyta o status swojego zamówienia, gdzie znajduje się jego paczka lub kiedy dotrze. Zawsze najpierw pytaj o numer zamówienia.”

Połączenie:

• URL: https://api.mystore.com/orders/lookup
• Metoda: POST

Nagłówki:

• Authorization: Bearer sk_live_abc123
• Content-Type: application/json

Parametry wejściowe:

• order_number (tekst, wymagane): „Numer zamówienia podany przez klienta”
• customer_email (tekst, opcjonalne): „Adres e-mail klienta do dodatkowej weryfikacji”

Mapowanie odpowiedzi nie jest wymagane — dzięki jasnemu opisowi i ustawionej powyżej akcji AI, bot odczytuje dowolny plik JSON zwracany przez Twój punkt końcowy (status, numer śledzenia, data dostawy, przedmioty) i samodzielnie decyduje, jak o tym poinformować.

Jak wygląda konwersacja:

Klient: Hej, gdzie jest moje zamówienie?

Bot: Cześć! Chętnie sprawdzę Twoje zamówienie. Czy możesz podać mi numer zamówienia?

Klient: To ORD-78234

Bot: Już sprawdzam…

Twoje zamówienie ORD-78234 zostało wysłane i jest w drodze! Przewidywana data dostawy to 10 marca. Możesz śledzić przesyłkę tutaj: https://tracking.example.com/1Z999AA1

Czy mogę pomóc w czymś jeszcze?

Kompletny przykład: Status zamówienia w Shopify #

Jeśli sklep działa na platformie Shopify, nie potrzebujesz programisty do stworzenia punktu końcowego wyszukiwania — własny system Shopify może bezpośrednio odpowiadać na pytania dotyczące zamówień. (W przypadku pytań o produkty i stany magazynowe w sklepie Shopify w ogóle nie potrzebujesz niestandardowej funkcji: połącz się z wbudowanym serwerem sklepu — zobacz Połącz sklep Shopify.)

Najpierw utwórz token dostępu w Shopify. Shopify wprowadziło zmiany w 2026 roku: aplikacji nie można już tworzyć w panelu administracyjnym Shopify, a nowy ekran tworzenia aplikacji udostępnia identyfikator klienta (Client ID) oraz klucz tajny klienta (Client secret) zamiast gotowego tokena. Poniższe kroki pozwolą przekształcić je w stały token. Przeznacz na to około dziesięciu minut, raz na sklep. (Jeśli sklep ma już starszą aplikację utworzoną w poprzedni sposób, istniejący token będzie nadal działał — przejdź od razu do funkcji niestandardowej poniżej.)

1. Przejdź do pulpitu nawigacyjnego Shopify Dev pod adresem dev.shopify.com, otwórz swoją organizację i kliknij Apps → Create app. Nazwij ją np. Order lookup.
2. Nadaj aplikacji uprawnienie read_orders, opublikuj wersję i zainstaluj aplikację w sklepie.
3. Otwórz Ustawienia aplikacji i dodaj adres internetowy sklepu (na przykład https://www.yourstore.com/) do dozwolonych adresów URL przekierowania. Zapisz.
4. Nadal w Ustawieniach skopiuj Client ID oraz Client secret.
5. W przeglądarce, w której jesteś zalogowany do panelu administracyjnego Shopify tego sklepu, otwórz poniższy adres, zastępując nazwę sklepu, identyfikator klienta i adres przekierowania własnymi danymi: https://YOUR-STORE.myshopify.com/admin/oauth/authorize?client_id=YOUR-CLIENT-ID&scope=read_orders&redirect_uri=https://www.yourstore.com/&state=12345 Zatwierdź ekran, który się pojawi. Przeglądarka przekieruje Cię na Twój adres przekierowania, a pasek adresu będzie teraz zawierał code= oraz długą wartość — skopiuj tę wartość. Jest ona ważna tylko przez kilka minut, więc przejdź od razu do następnego kroku.
6. Wymień ten kod na token, co możesz zrobić wewnątrz Your AI Connector. W kreatorze funkcji niestandardowych ustaw Metodę na POST, a URL na https://YOUR-STORE.myshopify.com/admin/oauth/access_token, dodaj trzy tekstowe parametry wejściowe o nazwach client_id, client_secret i code, a następnie kliknij Test, wypełnij trzy wartości i uruchom go. Odpowiedź zawiera access_token — to Twój stały token. Skopiuj go w bezpieczne miejsce, a następnie wyczyść kreator i skonfiguruj właściwą funkcję poniżej.

Następnie skonfiguruj funkcję niestandardową:

Podstawowe informacje:

• Nazwa: check_shopify_order
• Opis: “Wyszukuje zamówienie w systemie Shopify sklepu i zwraca jego status, informacje o śledzeniu oraz pozycje”
• Akcja AI: “Wywołaj to, gdy klient zapyta o status swojego zamówienia lub dostawę. Zawsze najpierw poproś o numer zamówienia.”

Połączenie:

• URL: https://YOUR-STORE.myshopify.com/admin/api/2026-01/orders.json?status=any — zastąp YOUR-STORE nazwą .myshopify.com sklepu (ten adres używa technicznej domeny Shopify, a nie niestandardowej domeny sklepu)
• Metoda: GET

Nagłówki:

• X-Shopify-Access-Token: shpat_... (token uzyskany powyżej)

Parametry wejściowe:

• name (query_param, wymagane): “Numer zamówienia klienta dokładnie w takiej formie, w jakiej widnieje w potwierdzeniu zamówienia, włącznie ze znakiem # — na przykład #1001. Jeśli klient go nie podał, poproś go o to.”

Mapowanie odpowiedzi nie jest wymagane — bot odczytuje zwrócone zamówienie (status płatności, status realizacji, śledzenie, pozycje) i odpowiada w naturalny sposób.

Warto wiedzieć: token utworzony w ten sposób może widzieć zamówienia z ostatnich 60 dni — to wystarczająco dużo do codziennych pytań wsparcia, ale nie stanowi pełnej historii zamówień.

Kompletny przykład: Rezerwacja wizyty #

Podstawowe informacje:

• Nazwa: create_booking
• Opis: „Tworzy nową wizytę w naszym systemie rezerwacji”
• Akcja AI: „Użyj tego po potwierdzeniu daty, godziny i danych kontaktowych z klientem. Nie wywołuj funkcji, dopóki klient wyraźnie nie potwierdzi chęci rezerwacji.”

Połączenie:

• URL: https://booking.mycompany.com/api/appointments
• Metoda: POST

Parametry wejściowe:

• date (tekst, wymagane): „Data wizyty w formacie RRRR-MM-DD”
• time (tekst, wymagane): „Godzina wizyty w formacie GG:MM”
• name (tekst, wymagane): „Imię i nazwisko klienta”
• phone (tekst, wymagane): „Numer telefonu klienta”
• service_type (tekst, wymagane): „Rodzaj rezerwowanej usługi”

Kompletny przykład: Dodawanie subskrybenta newslettera do systemu CRM #

Bardzo powszechny schemat: bot kończy odpowiadać, oferuje newsletter, kontakt odpowiada swoim adresem e-mail, a ten adres powinien natychmiast trafić do Twojego narzędzia e-mailowego. Większość systemów CRM (FluentCRM, ActiveCampaign, MailerLite, Brevo i inne) akceptuje w tym celu proste żądanie POST, więc nie jest potrzebna żadna platforma automatyzacji pomiędzy nimi.

Ten przykład wykorzystuje FluentCRM na WordPressie. Schemat jest taki sam dla każdego innego narzędzia, które udostępnia „przychodzący webhook” lub punkt końcowy „utwórz subskrybenta”.

Najpierw pobierz adres URL ze swojego systemu CRM. W WordPressie otwórz FluentCRM → Ustawienia → Przychodzące webhooki (Incoming Webhooks) i utwórz webhook. Wybierz listę, tagi i status subskrypcji, które powinny otrzymać nowe kontakty, a następnie skopiuj wygenerowany adres URL webhooka. Wszystko, co tutaj ustawisz, zostanie zastosowane automatycznie, więc bot musi jedynie wysłać adres e-mail.

Następnie skonfiguruj funkcję niestandardową:

Podstawowe informacje:

• Nazwa: add_newsletter_subscriber
• Opis: “Dodaje osobę do naszej listy newslettera przy użyciu adresu e-mail podanego na czacie”
• Akcja AI: “Użyj tego w momencie, gdy kontakt wyrazi zgodę na subskrypcję newslettera i poda swój adres e-mail. Nie wywołuj tej funkcji, zanim użytkownik faktycznie poda adres, i nie wywołuj jej dwukrotnie dla tej samej osoby.”

Połączenie:

• URL: adres URL webhooka skopiowany z Twojego CRM
• Metoda: POST

Parametry wejściowe:

• email (ciąg znaków, wymagane): “Adres e-mail podany przez kontakt w rozmowie”
• first_name (ciąg znaków, opcjonalne): “Imię kontaktu, jeśli zostało podane”

Pomiń dane systemowe: włącz tę opcję (on). Twój CRM potrzebuje tylko powyższych pól, a mniejszy ładunek danych pozwala uniknąć błędów w narzędziach, które odrzucają nieoczekiwane pola.

Mapowanie odpowiedzi: tutaj nie jest potrzebne. Nic nie musi wracać, aby bot mógł kontynuować działanie.

Nie zapomnij włączyć funkcji dla Agenta, który prowadzi konwersację (zobacz Przypisywanie funkcji do Agenta). Jest to najczęstszy powód, dla którego poprawnie zbudowana funkcja nigdy nie jest wyzwalana.

Wskazówki dotyczące niezawodnych funkcji niestandardowych #

1. Upewnij się, że powtarzane żądania są bezpieczne. Jeśli to samo żądanie zostanie przypadkowo wysłane dwukrotnie, nie powinno to tworzyć zduplikowanych rekordów. Problemy z siecią mogą czasami to powodować.

2. Zwracaj jasne komunikaty o błędach. Jeśli coś pójdzie nie tak po stronie Twojego systemu, zwróć czytelny dla człowieka błąd. Bot przekaże go klientowi w uprzejmy sposób.

3. Utrzymuj czas odpowiedzi poniżej 10 sekund. Jeśli Twój system potrzebuje więcej czasu, rozważ najpierw zwrócenie szybkiego potwierdzenia przyjęcia zgłoszenia.

4. Obsługuj wygasłe lub nieprawidłowe dane uwierzytelniające. Jeśli Twój klucz API wygaśnie, upewnij się, że komunikat o błędzie jest jasny, aby bot wiedział, że powinien powiadomić człowieka zamiast ponawiać próbę.

5. Pisz szczegółowe opisy. AI wykorzystuje Twoje opisy, aby ustalić, kiedy wywołać funkcję i jak wyodrębnić odpowiednie informacje z konwersacji. Niejasne opisy prowadzą do błędów.

6. Testuj na rzeczywistych konwersacjach. Funkcja „Try Out” jest świetna do wstępnych testów, ale monitoruj swoje pierwsze kilka konwersacji na żywo, aby upewnić się, że wszystko działa poprawnie przy rzeczywistych zapytaniach klientów.

7. Przechowuj logi po swojej stronie. Poproś programistę o logowanie żądań przychodzących z aplikacji, aby można było szybko debugować wszelkie problemy.

8. Użyj publicznego, ostatecznego adresu URL. Adres URL Twojej funkcji musi być publicznym adresem internetowym (HTTP/HTTPS). Adresy wewnętrzne, localhost oraz te z sieci prywatnych są odrzucane ze względów bezpieczeństwa, a platforma nie śledzi przekierowań — kieruj funkcję bezpośrednio na ostateczny adres URL, a nie na taki, który do niego przekierowuje.

Limity wykonania #

Każda funkcja niestandardowa posiada opcjonalną sekcję Limity wykonania na dole edytora. Kontroluje ona, jak często sztuczna inteligencja może uruchamiać funkcję oraz czy wcześniejszy wynik może zostać użyty ponownie. Wszystkie te ustawienia są opcjonalne — pozostawienie ich pustych sprawia, że funkcja działa dokładnie tak, jak wcześniej.

Funkcja tylko do odczytu. Włącz tę opcję, jeśli Twoja funkcja jedynie odczytuje dane — np. wyszukiwanie zapasów, sprawdzanie ceny, wyszukiwanie statusu zamówienia — i nigdy nie tworzy ani nie zmienia żadnych informacji. Gdy chwilowy problem z siecią przerwie odpowiedź AI, platforma może bezpiecznie ponowić próbę w ramach tej samej tury konwersacji, zamiast pozostawiać klienta bez odpowiedzi. Włączaj tę opcję tylko wtedy, gdy funkcja rzeczywiście nigdy niczego nie zapisuje: funkcja tworząca rekordy musi mieć tę opcję wyłączoną, aby ponowna próba nigdy przypadkowo nie uruchomiła jej dwukrotnie.

Serwuj wynik z pamięci podręcznej przy powtórnych wywołaniach. Gdy AI wywoła funkcję ponownie z tymi samymi danymi wejściowymi (na przykład klient zada to samo pytanie dwa razy), zamiast ponownie wywoływać Twój punkt końcowy, zostanie użyty poprzedni wynik. Wyniki z pamięci podręcznej są przechowywane do 24 godzin, a wywołanie z innymi danymi wejściowymi zawsze trafia bezpośrednio do Twojego punktu końcowego.

Maks. liczba uruchomień na konwersację. Sztywny limit liczby uruchomień funkcji w ramach jednej konwersacji. Ustaw wartość 1 dla funkcji, które powinny zostać wywołane tylko raz na czat — np. generowanie wyceny, wyzwalanie oddzwonienia, uruchamianie automatyzacji. Po osiągnięciu limitu AI otrzymuje informację, że funkcja została już uruchomiona, wraz z ostatnim uzyskanym wynikiem, dzięki czemu nadal może odpowiedzieć klientowi, zamiast milczeć.

Maks. liczba uruchomień w oknie czasowym. Limit częstotliwości w czasie: na przykład maksymalnie 5 uruchomień w ciągu 60 minut. Przydatne dla funkcji, które wywołują płatne usługi stron trzecich lub uruchamiają bardziej obciążające automatyzacje. Oba pola muszą zostać wypełnione razem (liczba uruchomień oraz okno czasowe w minutach, do 7 dni).

Kilka rzeczy, o których warto wiedzieć:

• Limity zliczają tylko udane uruchomienia. Wywołanie, które zakończyło się niepowodzeniem po stronie Twojego punktu końcowego, nie zużywa limitu.
• Gdy uruchomienie jest blokowane przez limit, klient nigdy nie pozostaje bez odpowiedzi — AI otrzymuje informację o przyczynie i pracuje z informacjami, które już posiada.
• Limity mają zastosowanie wszędzie tam, gdzie działa funkcja: w regularnych czatach na każdym kanale oraz w funkcjach zarządzanych przez automatyzację. Konwersacje testowe w trybie „Wypróbuj” nie są zliczane ani limitowane.

Wbudowane narzędzia bota #

Oprócz niestandardowych funkcji, które tworzysz samodzielnie, platforma jest dostarczana z biblioteką gotowych narzędzi, z których bot AI może korzystać podczas rozmowy. Obejmują one najczęstsze zadania, jakie musi wykonać bot — powiadamianie członka zespołu, umawianie spotkań, tagowanie kontaktu, przeszukiwanie witryny, planowanie działań następczych i inne — dzięki czemu nie musisz ich konfigurować od zera.

Bot decyduje, kiedy użyć każdego narzędzia, w oparciu o to, co dzieje się w rozmowie oraz jak skonfigurowany jest Twój Agent (i przypisana do niego kampania). Większość tych narzędzi włącza się automatycznie po aktywacji powiązanej funkcji (na przykład narzędzia do rezerwacji stają się dostępne dopiero po połączeniu kalendarza i włączeniu rezerwacji).

Koszt w kredytach: Każde wywołanie narzędzia jest rozliczane zgodnie z poziomem jakości AI Twojego Agenta, a samodzielnie utworzone funkcje niestandardowe są rozliczane w ten sam sposób:

Narzędzia dla zespołu i zadań #

Narzędzia kontaktu #

Narzędzia spotkań i rezerwacji #

Te narzędzia są dostępne tylko wtedy, gdy rezerwacje są włączone w kampanii powiązanej z Twoim Agentem oraz gdy skonfigurowano typ wydarzenia w kalendarzu.

Narzędzia wiedzy i internetowe #

Narzędzia do działań następczych (Follow-Up) #

Te narzędzia wymagają włączenia działań następczych w kampanii powiązanej z Twoim Agentem.

Uruchamianie funkcji niestandardowych #

Narzędzia do rezerwacji w restauracjach (Zenchef i Formitable) #

Te narzędzia są dostępne tylko wtedy, gdy połączona jest integracja Zenchef lub Formitable. Pozwalają one botowi na kompleksowe zarządzanie rezerwacjami w restauracji.

Włączanie i wyłączanie narzędzi #

Większość narzędzi jest kontrolowana na karcie Możliwości AI Agenta (lub w kroku Możliwości AI kampanii, jeśli pracujesz w klasycznej kampanii):

• Narzędzia do rezerwacji włączają się, gdy aktywujesz rezerwacje i połączysz kalendarz — na razie jest to ustawienie dla każdej kampanii z osobna, z bezpośrednim linkiem do kroku tej kampanii z karty Możliwości AI Agenta
• Narzędzia do działań następczych włączają się, gdy aktywujesz działania następcze
• Narzędzia restauracyjne włączają się, gdy połączysz konto Zenchef lub Formitable
• Wyszukiwanie w sieci ma własny przełącznik na karcie FAQ i wiedza
• Narzędzia zadań można wyłączyć dla każdego Agenta za pomocą przełącznika Pozwól AI tworzyć zadania (są domyślnie włączone; ogólnokontowy przełącznik Zadań w Ustawienia → Profil → Funkcje wyłącza cały system zadań wszędzie)
• Narzędzia do aktualizacji kontaktów są kontrolowane na tej samej karcie Możliwości AI — określają, czy AI może zmieniać nazwy kontaktów lub zapisywać na nich dodatkowe zebrane informacje
• Narzędzia alertów są zawsze dostępne; tagowanie działa automatycznie po każdej odpowiedzi bota (nie jest to narzędzie, które bot wybiera do wywołania)

Jeśli chcesz, aby bot przestał używać konkretnego wbudowanego narzędzia, najczystszym sposobem jest wyłączenie podstawowej funkcji (na przykład wyłącz rezerwacje, aby wyłączyć wszystkie narzędzia do rezerwacji).

Funkcje zarządzane przez automatyzację #

Niektóre wpisy na stronie Funkcji niestandardowych mogą być oznaczone etykietą Zarządzane przez automatyzację. Nie zostały one utworzone w tym miejscu — pochodzą z automatyzacji z wyzwalaczem Funkcja agenta AI, który nadaje agentowi umiejętność, której kroki budujesz wizualnie na kanwie automatyzacji, zamiast wskazywać zewnętrzny adres internetowy.

Zarządzana funkcja jest obsługiwana automatycznie: jej nazwa, opis i pola zawsze odpowiadają ustawieniom wyzwalacza automatyzacji, dlatego nie można jej edytować ani usuwać z tej strony — użyj linku Otwórz automatyzację, aby wprowadzić zmiany w samej automatyzacji. Nadal możesz jednak w standardowy sposób wybierać, którzy agenci mają do niej dostęp: na karcie Zdolności AI danego agenta pojawia się ona obok innych zdolności wraz ze zwykłym przełącznikiem włączania/wyłączania (jeśli automatyzacja jest wstrzymana, w wierszu pojawi się stosowna informacja — zdolność stanie się aktywna po włączeniu automatyzacji). Wszystkie pozostałe aspekty jej działania są identyczne jak w przypadku każdej innej funkcji niestandardowej: sztuczna inteligencja decyduje, kiedy ją wywołać, zbiera zdefiniowane przez Ciebie szczegóły i może wykorzystać odpowiedź automatyzacji w tej samej konwersacji.

Jeśli wybierasz między tymi dwoma rozwiązaniami: skieruj zwykłą funkcję niestandardową do systemu, który ma już adres do wywołania; zbuduj automatyzację z wyzwalaczem funkcji Agenta AI, gdy wolisz złożyć pracę z kilku kroków — wyszukać coś w arkuszu kalkulacyjnym lub bazie danych, rozgałęzić warunek, utworzyć rekordy — bez konieczności uruchamiania własnego serwera. Zobacz Automatyzacje.

Wymagania planu #

Funkcje niestandardowe są dostępne w planach, które zawierają tę funkcjonalność. Sprawdź swoją subskrypcję, aby potwierdzić dostępność.

Następne kroki #

• Podłączanie serwerów MCP do Twojego bota — gotowy zestaw narzędzi zamiast pojedynczych funkcji.
• Agenci AI — strona główna grupy AI Studio, w której znajdują się funkcje niestandardowe i gdzie są one przypisywane do bota.