> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio Twój recepcjonista może rozpoznawać dzwoniących, którzy są już w Attio, dodawać nowych dzwoniących jako osoby z imieniem, nazwiskiem i numerem telefonu oraz zostawiać notatkę o tym, czego potrzebowali, aby zespół mógł się z nimi skontaktować. Możesz połączyć się na dwa sposoby: * **[Narzędzia webhook](#option-1-webhook-tools-recommended)** wywołują API Attio bezpośrednio, bez konta Zapier i bez używania zadań Zapier. * Akcje **[Zapier](#option-2-zapier)** logują Cię do Attio, ale każda akcja używa zadań z Twojego planu Zapier. Użyj narzędzi webhook, chyba że nie możesz poprosić administratora Attio o utworzenie tokena dostępu. ## Opcja 1: Narzędzia webhook (zalecane) ### Utwórz token dostępu Musisz być administratorem Attio. Wybierz menu obok nazwy workspace'a, otwórz **Ustawienia workspace'a**, przejdź do karty **Deweloperzy** i wybierz **Nowy token dostępu**. Nadaj mu nazwę, na przykład `Reception.ai`, i przyznaj tylko zakresy potrzebne tym narzędziom: odczyt konfiguracji obiektów (`object_configuration:read`), odczyt i zapis rekordów (`record_permission:read-write`) oraz odczyt i zapis notatek (`note:read-write`). Etykiety w Attio mogą się nieco różnić od tych nazw. Token nie wygasa i ma dostęp do każdej osoby w Twoim workspace'ie. Usuń go w Attio, jeśli wycieknie. ### Utwórz narzędzia webhook Dla każdego [narzędzia poniżej](#find-the-caller) przejdź do **Integracje**, wybierz **Dodaj integrację**, a następnie **Narzędzie webhook**. Każde narzędzie wysyła ten sam nagłówek: `Authorization` (Secret), ustawiony na `Bearer `, a po nim Twój token. ### Dodaj regułę Dodaj [regułę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która mówi recepcjoniście, by używał Attio tylko do rozpoznawania dzwoniących i nigdy nie odczytywał im rekordów ani notatek. ### Znajdź dzwoniącego | Pole | Wartość | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `find_attio_person` | | **Opis** | "Znajdź dzwoniącego wśród naszych osób w Attio po numerze telefonu. Użyj na początku rozmowy. Przekaż record_id osoby do narzędzia notatek." | | **Metoda** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Nagłówki żądania** | `Authorization` (Secret): `Bearer `, a po nim Twój token | | **Parametry treści** | `filter` (object, wymagane), z polem poniżej `limit` (integer, stała wartość): `5` | | **Przypisz do agentów** | **Recepcjonista** | Wybierz **Dodaj pole** przy `filter` i dodaj: * `phone_numbers` (string, wymagane, z rozmowy): "Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123." Attio zwraca tylko osoby, których zapisany numer pasuje dokładnie, więc zapisuj numery z kodem kraju. ### Dodaj dzwoniącego | Pole | Wartość | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Nazwa** | `create_attio_person` | | **Opis** | "Dodaj dzwoniącego jako osobę tylko wtedy, gdy `find_attio_person` go nie znajdzie. Przekaż record_id nowej osoby do narzędzia notatek." | | **Metoda** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Nagłówki żądania** | `Authorization` (Secret): `Bearer `, a po nim Twój token | | **Parametry treści** | `data` (object, wymagane), z polami poniżej | | **Przypisz do agentów** | **Recepcjonista** | Wybierz **Dodaj pole** przy `data` i dodaj `values` (object, wymagane). Przy `values` dodaj: * `name` (object, wymagane), z trzema polami: * `first_name` (string, wymagane, z rozmowy): "Imię dzwoniącego." * `last_name` (string, wymagane, z rozmowy): "Nazwisko dzwoniącego lub pusty ciąg znaków, jeśli go nie podał." * `full_name` (string, wymagane, z rozmowy): "Imię i nazwisko dzwoniącego." * `phone_numbers` (array, wymagane, z rozmowy): "Dokładnie jeden element z numerem telefonu dzwoniącego." W sekcji **Każdy element** wybierz `string` z opisem: "Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123." * `email_addresses` (array, z rozmowy): "Dokładnie jeden element z adresem e-mail dzwoniącego. Pomiń, jeśli go nie podał." W sekcji **Każdy element** wybierz `string` z opisem: "Adres e-mail dzwoniącego." ### Zapisz notatkę | Pole | Wartość | | ----------------------- | ------------------------------------------------------------------------------------------------------- | | **Nazwa** | `add_attio_note` | | **Opis** | "Zapisz, czego potrzebował dzwoniący, w notatce przy jego rekordzie osoby, zanim rozmowa się zakończy." | | **Metoda** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Nagłówki żądania** | `Authorization` (Secret): `Bearer `, a po nim Twój token | | **Parametry treści** | `data` (object, wymagane), z polami poniżej | | **Przypisz do agentów** | **Recepcjonista** | Dla każdego z tych pól wybierz **Dodaj pole** przy `data`: * `parent_object` (string, stała wartość): `people` * `parent_record_id` (string, wymagane, z rozmowy): "record_id osoby z `find_attio_person` lub `create_attio_person`." * `title` (string, wymagane, z rozmowy): "Krótki tytuł, na przykład: Telefon od Jane Doe w sprawie wyceny." * `format` (string, stała wartość): `plaintext` * `content` (string, wymagane, z rozmowy): "Kilka zdań o tym, czego potrzebował dzwoniący." Obiekt nadrzędny i format to stałe wartości, więc notatki zawsze trafiają do osoby, nawet jeśli AI wyśle inne wartości. > **Warning** > > `find_attio_person` zwraca wszystko, co zapisano przy osobie. Zachowaj tę regułę, aby Twój > recepcjonista używał Attio wyłącznie do rozpoznawania dzwoniącego, a dzwoniący nigdy nie usłyszeli danych > innej osoby. Wybierz **Włącz** przy każdym narzędziu, a następnie [przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), dzwoniąc z numeru zapisanego przy osobie w Attio, a potem jako nowy dzwoniący, który prosi o oddzwonienie. Nowa osoba i notatka pojawią się w Attio. ## Opcja 2: Zapier ### Połącz Zapier Jeśli jeszcze tego nie zrobiłeś, połącz [Zapier](/docs/pl/reception-ai/integrations/zapier) w Reception.ai. ### Dodaj akcje Attio Na serwerze Zapier MCP pod adresem [mcp.zapier.com](https://mcp.zapier.com) dodaj [akcje poniżej](#zapier-actions) z aplikacji **Attio** i połącz swój workspace Attio. Dla każdego pola ustaw stałą wartość lub pozwól AI je wypełnić, zgodnie z listą. ### Przypisz narzędzia W Reception.ai otwórz kartę **Narzędzia** integracji Zapier, wybierz **Odśwież narzędzia** i przypisz każdą akcję zgodnie z listą. ### Dodaj regułę Dodaj [regułę](/docs/pl/reception-ai/receptionist/rules-and-procedures), która mówi recepcjoniście, by używał Attio tylko do rozpoznawania dzwoniących i nigdy nie odczytywał im rekordów ani notatek. > **Warning** > > Zapier działa jako użytkownik Attio, który połączył workspace, i widzi wszystko, co widzi ten użytkownik. > Połącz konto członka, którego dostęp jest ograniczony do rekordów potrzebnych recepcjoniście, i zachowaj > tę regułę, aby dzwoniący nigdy nie usłyszeli danych innej osoby. ### Przetestuj [Przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing), dzwoniąc z numeru zapisanego przy osobie w Attio, a potem jako nowy dzwoniący, który prosi o oddzwonienie. Nowa osoba i notatka pojawią się w Attio. ### Akcje Zapier #### Znajdź dzwoniącego | Pole | Wartość | | ---------------------- | ---------------------------------------------------- | | **Akcja Zapier** | **Znajdź rekordy** | | **Ustaw w Zapier** | Obiekt: Osoby. Atrybut wyszukiwania: numer telefonu. | | **Pozwól AI wypełnić** | Wyszukiwana wartość: numer telefonu dzwoniącego. | | **Przypisz do** | **Klient** | #### Dodaj dzwoniącego | Pole | Wartość | | ---------------------- | -------------------------------------------------------------------------------------- | | **Akcja Zapier** | **Utwórz rekord** | | **Ustaw w Zapier** | Obiekt: Osoby. Wszelkie atrybuty, które zawsze mają być takie same, jeśli ich używasz. | | **Pozwól AI wypełnić** | Imię, nazwisko, numer telefonu i adres e-mail. | | **Przypisz do** | **Klient** | #### Zapisz notatkę | Pole | Wartość | | ---------------------- | -------------------------------------------------------------------------------------------------------- | | **Akcja Zapier** | **Utwórz notatkę** | | **Ustaw w Zapier** | Obiekt nadrzędny: Osoby. | | **Pozwól AI wypełnić** | Identyfikator rekordu nadrzędnego (z poprzednich akcji), tytuł i treść notatki z potrzebami dzwoniącego. | | **Przypisz do** | **Klient** | > **Tip** > > Niezależnie od wybranej opcji dodaj [procedurę](/docs/pl/reception-ai/receptionist/rules-and-procedures), > aby recepcjonista najpierw wyszukiwał dzwoniącego, tworzył osobę tylko wtedy, gdy nie znajdzie dopasowania, > a następnie zapisywał notatkę. ## Ograniczenia * Attio sprawdza poprawność numerów telefonów. W opisie narzędzia lub akcji powiedz recepcjoniście, aby wysyłał numery w formacie międzynarodowym, na przykład `+14155550123`. * Utworzenie osoby nie powiedzie się, gdy inna osoba ma już tę samą unikalną wartość, na przykład adres e-mail. Recepcjonista powinien najpierw wyszukać. * Zadań utworzonych przez Zapier nie można połączyć z rekordem Attio, więc użyj notatki do zapisania szczegółów rozmowy. * W Zapier każda akcja uruchomiona przez recepcjonistę używa zadań z Twojego planu Zapier. Zapier obecnie nalicza dwa zadania za każdą udaną rozmowę; nieudane rozmowy nie są liczone. Gdy plan się wyczerpie, akcje zatrzymają się do czasu jego odnowienia. ## Rozwiązywanie problemów | Problem | Co sprawdzić | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | 401 lub 403 z Attio | Rozpocznij wartość nagłówka od `Bearer ` i spacji oraz sprawdź, czy token ma powyższe zakresy i nie został usunięty. | | Akcja Attio nie pojawia się w Reception.ai | Po dodaniu akcji w Zapier wybierz **Odśwież narzędzia** w integracji Zapier. | | Akcja ma status **Zmieniono** i nie jest używana | Została edytowana w Zapier. Wybierz **Aktualizuj** na karcie **Narzędzia**. | | Znani dzwoniący nie są znajdowani | Sprawdź, czy numery są zapisane z kodem kraju. W Zapier sprawdź, czy **Znajdź rekordy** przeszukuje obiekt Osoby według numeru telefonu. | | Utworzenie osoby się nie udaje | Numer telefonu może nie być w formacie międzynarodowym lub adres e-mail dzwoniącego jest już zapisany. | | Notatki nie są połączone z dzwoniącym | Recepcjonista potrzebuje identyfikatora rekordu z narzędzia wyszukiwania lub tworzenia albo z akcji **Znajdź rekordy** lub **Utwórz rekord** w Zapier. |