Przejdź do nawigacji

Attio

Rozpoznawaj dzwoniących, dodawaj nowe osoby i zapisuj notatki z rozmów w Attio podczas połączeń.

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 wywołują API Attio bezpośrednio, bez konta Zapier i bez używania zadań Zapier.
  • Akcje 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)

1

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.

2

Utwórz narzędzia webhook

Dla każdego narzędzia poniżej 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.

3

Dodaj regułę

Dodaj regułę, 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

PoleWartość
Nazwafind_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.”
MetodaPOST
URLhttps://api.attio.com/v2/objects/people/records/query
Nagłówki żądaniaAuthorization (Secret): Bearer , a po nim Twój token
Parametry treścifilter (object, wymagane), z polem poniżej
limit (integer, stała wartość): 5
Przypisz do agentówRecepcjonista

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

PoleWartość
Nazwacreate_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.”
MetodaPOST
URLhttps://api.attio.com/v2/objects/people/records
Nagłówki żądaniaAuthorization (Secret): Bearer , a po nim Twój token
Parametry treścidata (object, wymagane), z polami poniżej
Przypisz do agentówRecepcjonista

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ę

PoleWartość
Nazwaadd_attio_note
Opis”Zapisz, czego potrzebował dzwoniący, w notatce przy jego rekordzie osoby, zanim rozmowa się zakończy.”
MetodaPOST
URLhttps://api.attio.com/v2/notes
Nagłówki żądaniaAuthorization (Secret): Bearer , a po nim Twój token
Parametry treścidata (object, wymagane), z polami poniżej
Przypisz do agentówRecepcjonista

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.

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ę, 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

1

Połącz Zapier

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

2

Dodaj akcje Attio

Na serwerze Zapier MCP pod adresem mcp.zapier.com dodaj akcje poniżej 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ą.

3

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ą.

4

Dodaj regułę

Dodaj regułę, która mówi recepcjoniście, by używał Attio tylko do rozpoznawania dzwoniących i nigdy nie odczytywał im rekordów ani notatek.

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.

5

Przetestuj

Przetestuj recepcjonistę, 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

PoleWartość
Akcja ZapierZnajdź rekordy
Ustaw w ZapierObiekt: Osoby. Atrybut wyszukiwania: numer telefonu.
Pozwól AI wypełnićWyszukiwana wartość: numer telefonu dzwoniącego.
Przypisz doKlient

Dodaj dzwoniącego

PoleWartość
Akcja ZapierUtwórz rekord
Ustaw w ZapierObiekt: 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 doKlient

Zapisz notatkę

PoleWartość
Akcja ZapierUtwórz notatkę
Ustaw w ZapierObiekt nadrzędny: Osoby.
Pozwól AI wypełnićIdentyfikator rekordu nadrzędnego (z poprzednich akcji), tytuł i treść notatki z potrzebami dzwoniącego.
Przypisz doKlient

Niezależnie od wybranej opcji dodaj procedurę, 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

ProblemCo sprawdzić
401 lub 403 z AttioRozpocznij 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.aiPo dodaniu akcji w Zapier wybierz Odśwież narzędzia w integracji Zapier.
Akcja ma status Zmieniono i nie jest używanaZostała edytowana w Zapier. Wybierz Aktualizuj na karcie Narzędzia.
Znani dzwoniący nie są znajdowaniSprawdź, czy numery są zapisane z kodem kraju. W Zapier sprawdź, czy Znajdź rekordy przeszukuje obiekt Osoby według numeru telefonu.
Utworzenie osoby się nie udajeNumer 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ącymRecepcjonista potrzebuje identyfikatora rekordu z narzędzia wyszukiwania lub tworzenia albo z akcji Znajdź rekordy lub Utwórz rekord w Zapier.