Zur Navigation springen

Attio

Erkennen Sie Anrufer, fügen Sie neue Personen hinzu und protokollieren Sie während Anrufen Gesprächsnotizen in Attio.

Ihre Rezeption kann Anrufer erkennen, die bereits in Attio vorhanden sind, neue Anrufer mit Name und Telefonnummer als Personen hinzufügen und eine Notiz zu ihrem Anliegen hinterlassen, damit Ihr Team nachfassen kann. Es gibt zwei Verbindungsmöglichkeiten:

  • Webhook-Tools rufen Attios API direkt auf, ohne Zapier-Konto und ohne Zapier-Task-Verbrauch.
  • Zapier-Aktionen melden Sie bei Attio an, aber jede Aktion verbraucht Tasks aus Ihrem Zapier-Plan.

Verwenden Sie Webhook-Tools, sofern Sie keinen Attio-Admin für die Erstellung eines Zugriffstokens gewinnen können.

Option 1: Webhook-Tools (empfohlen)

1

Zugriffstoken erstellen

Sie benötigen Admin-Rechte in Attio. Wählen Sie das Dropdown neben Ihrem Workspace-Namen, öffnen Sie Workspace settings, wechseln Sie zum Tab Developers und wählen Sie New access token. Geben Sie ihm einen Namen, zum Beispiel Reception.ai, und erteilen Sie nur die Berechtigungen, die diese Tools benötigen: Objektkonfiguration lesen (object_configuration:read), Datensätze lesen und schreiben (record_permission:read-write) sowie Notizen lesen und schreiben (note:read-write). Die Bezeichnungen in Attio können leicht von diesen Namen abweichen.

Das Token läuft nicht ab und kann alle Personen in Ihrem Workspace sehen. Löschen Sie es in Attio, falls es kompromittiert wird.

2

Webhook-Tools erstellen

Gehen Sie für jedes unten aufgeführte Tool zu Integrations, wählen Sie Add integration und dann Webhook Tool. Jedes Tool sendet denselben Header: Authorization (Secret), festgelegt auf Bearer gefolgt von Ihrem Token.

3

Regel hinzufügen

Fügen Sie eine Regel hinzu, die Ihrer Rezeption vorgibt, Attio nur zur Erkennung von Anrufern zu verwenden und ihnen niemals Datensätze oder Notizen vorzulesen.

Anrufer finden

FeldWert
Namefind_attio_person
Beschreibung”Den Anrufer anhand seiner Telefonnummer unter unseren Personen in Attio finden. Zu Beginn eines Anrufs verwenden. Die record_id der Person an das Notiz-Tool übergeben.”
MethodePOST
URLhttps://api.attio.com/v2/objects/people/records/query
Request HeadersAuthorization (Secret): Bearer gefolgt von Ihrem Token
Body Parametersfilter (Objekt, erforderlich), mit dem unten stehenden Feld
limit (Ganzzahl, fester Wert): 5
Agenten zuweisenReceptionist

Wählen Sie bei filter Add field und fügen Sie Folgendes hinzu:

  • phone_numbers (String, erforderlich, aus dem Gespräch): “Die Telefonnummer des Anrufers im internationalen Format, zum Beispiel +14155550123.”

Attio gibt nur Personen zurück, deren gespeicherte Nummer exakt übereinstimmt. Speichern Sie Nummern daher mit Landesvorwahl.

Anrufer hinzufügen

FeldWert
Namecreate_attio_person
Beschreibung”Den Anrufer als Person hinzufügen, nur wenn find_attio_person ihn nicht gefunden hat. Die record_id der neuen Person an das Notiz-Tool übergeben.”
MethodePOST
URLhttps://api.attio.com/v2/objects/people/records
Request HeadersAuthorization (Secret): Bearer gefolgt von Ihrem Token
Body Parametersdata (Objekt, erforderlich), mit den unten stehenden Feldern
Agenten zuweisenReceptionist

Wählen Sie bei data Add field und fügen Sie values (Objekt, erforderlich) hinzu. Fügen Sie bei values Folgendes hinzu:

  • name (Objekt, erforderlich), mit drei Feldern:
    • first_name (String, erforderlich, aus dem Gespräch): “Der Vorname des Anrufers.”
    • last_name (String, erforderlich, aus dem Gespräch): “Der Nachname des Anrufers oder ein leerer String, wenn er ihn nicht angegeben hat.”
    • full_name (String, erforderlich, aus dem Gespräch): “Vor- und Nachname des Anrufers.”
  • phone_numbers (Array, erforderlich, aus dem Gespräch): “Genau ein Element für die Telefonnummer des Anrufers.” Wählen Sie unter Each item string, beschrieben als “Die Telefonnummer des Anrufers im internationalen Format, zum Beispiel +14155550123.”
  • email_addresses (Array, aus dem Gespräch): “Genau ein Element für die E-Mail-Adresse des Anrufers. Auslassen, wenn er keine angegeben hat.” Wählen Sie unter Each item string, beschrieben als “Die E-Mail-Adresse des Anrufers.”

Notiz protokollieren

FeldWert
Nameadd_attio_note
Beschreibung”Das Anliegen des Anrufers vor Ende des Anrufs in seinem Personendatensatz notieren.”
MethodePOST
URLhttps://api.attio.com/v2/notes
Request HeadersAuthorization (Secret): Bearer gefolgt von Ihrem Token
Body Parametersdata (Objekt, erforderlich), mit den unten stehenden Feldern
Agenten zuweisenReceptionist

Wählen Sie für jedes dieser Elemente bei data Add field:

  • parent_object (String, fester Wert): people
  • parent_record_id (String, erforderlich, aus dem Gespräch): “Die record_id der Person aus find_attio_person oder create_attio_person.”
  • title (String, erforderlich, aus dem Gespräch): “Ein kurzer Titel, zum Beispiel: Anruf von Jane Doe wegen eines Angebots.”
  • format (String, fester Wert): plaintext
  • content (String, erforderlich, aus dem Gespräch): “Das Anliegen des Anrufers in wenigen Sätzen.”

Das übergeordnete Objekt und das Format sind feste Werte. Daher werden Notizen immer bei einer Person hinterlegt, auch wenn die KI andere Werte sendet.

find_attio_person gibt alles zurück, was bei der Person gespeichert ist. Lassen Sie die Regel bestehen, damit Ihre Rezeption Attio nur zur Erkennung des Anrufers verwendet und Anrufer niemals die Daten einer anderen Person hören.

Wählen Sie bei jedem Tool Enable und testen Sie Ihre Rezeption anschließend mit einem Anruf von einer Nummer, die bei einer Attio-Person gespeichert ist, und dann als neuer Anrufer, der um einen Rückruf bittet. Die neue Person und eine Notiz werden in Attio angezeigt.

Option 2: Zapier

1

Zapier verbinden

Falls noch nicht geschehen, verbinden Sie Zapier in Reception.ai.

2

Attio-Aktionen hinzufügen

Fügen Sie in Ihrem Zapier-MCP-Server unter mcp.zapier.com die unten aufgeführten Aktionen aus der App Attio hinzu und verbinden Sie Ihren Attio-Workspace. Legen Sie für jedes Feld entweder einen festen Wert fest oder lassen Sie es von der KI ausfüllen, wie angegeben.

3

Tools zuweisen

Öffnen Sie in Reception.ai den Tab Tools der Zapier-Integration, wählen Sie Refresh tools und weisen Sie jede Aktion wie angegeben zu.

4

Regel hinzufügen

Fügen Sie eine Regel hinzu, die Ihrer Rezeption vorgibt, Attio nur zur Erkennung von Anrufern zu verwenden und ihnen niemals Datensätze oder Notizen vorzulesen.

Zapier handelt als Attio-Nutzer, der den Workspace verbunden hat, und kann alles sehen, was dieser Nutzer sehen kann. Verbinden Sie einen Nutzer, dessen Zugriff auf die Datensätze beschränkt ist, die Ihre Rezeption benötigt, und lassen Sie die Regel bestehen, damit Anrufer niemals die Daten einer anderen Person hören.

5

Testen

Testen Sie Ihre Rezeption mit einem Anruf von einer Nummer, die bei einer Attio-Person gespeichert ist, und dann als neuer Anrufer, der um einen Rückruf bittet. Die neue Person und eine Notiz werden in Attio angezeigt.

Zapier-Aktionen

Anrufer finden

FeldWert
Zapier-AktionFind Records
In Zapier festlegenDas Objekt: Personen. Das Suchattribut: Telefonnummer.
Von der KI ausfüllen lassenDer Suchwert: die Telefonnummer des Anrufers.
Zuweisen anClient

Anrufer hinzufügen

FeldWert
Zapier-AktionCreate Record
In Zapier festlegenDas Objekt: Personen. Attribute, die immer gleich sein sollen, falls Sie diese verwenden.
Von der KI ausfüllen lassenVorname, Nachname, Telefonnummer und E-Mail-Adresse.
Zuweisen anClient

Notiz protokollieren

FeldWert
Zapier-AktionCreate Note
In Zapier festlegenDas übergeordnete Objekt: Personen.
Von der KI ausfüllen lassenDie übergeordnete Datensatz-ID (aus den vorherigen Aktionen), ein Titel und der Notiztext mit dem Anliegen des Anrufers.
Zuweisen anClient

Unabhängig von der gewählten Option fügen Sie eine Prozedur hinzu, damit Ihre Rezeption zuerst nach dem Anrufer sucht, nur dann eine Person erstellt, wenn keine Übereinstimmung gefunden wird, und anschließend eine Notiz protokolliert.

Einschränkungen

  • Attio prüft, ob Telefonnummern gültig sind. Weisen Sie Ihre Rezeption in der Beschreibung des Tools oder der Aktion an, Nummern im internationalen Format wie +14155550123 zu senden.
  • Das Erstellen einer Person schlägt fehl, wenn eine andere Person bereits denselben eindeutigen Wert hat, etwa eine E-Mail-Adresse. Ihre Rezeption sollte zuerst suchen.
  • Über Zapier erstellte Tasks können nicht mit einem Attio-Datensatz verknüpft werden. Verwenden Sie daher die Notiz für Anrufdetails.
  • Mit Zapier verbraucht jede von Ihrer Rezeption ausgeführte Aktion Tasks aus Ihrem Zapier-Plan. Zapier zählt derzeit zwei Tasks pro erfolgreichem Anruf; fehlgeschlagene Anrufe werden nicht gezählt. Wenn der Plan aufgebraucht ist, werden die Aktionen bis zur Zurücksetzung angehalten.

Fehlerbehebung

ProblemPrüfen
401 oder 403 von AttioBeginnen Sie den Header-Wert mit Bearer und einem Leerzeichen. Prüfen Sie, ob das Token die oben genannten Berechtigungen hat und nicht gelöscht wurde.
Eine Attio-Aktion wird nicht in Reception.ai angezeigtWählen Sie in der Zapier-Integration Refresh tools, nachdem Sie Aktionen in Zapier hinzugefügt haben.
Eine Aktion zeigt Changed und wird nicht verwendetSie haben sie in Zapier bearbeitet. Wählen Sie im Tab Tools Update.
Bekannte Anrufer werden nicht gefundenPrüfen Sie, ob Nummern mit Landesvorwahl gespeichert sind. Prüfen Sie bei Zapier, ob Find Records das Objekt Personen anhand der Telefonnummer durchsucht.
Das Erstellen einer Person schlägt fehlDie Telefonnummer ist möglicherweise nicht im internationalen Format oder die E-Mail-Adresse des Anrufers ist bereits gespeichert.
Notizen sind nicht mit dem Anrufer verknüpftIhre Rezeption benötigt die Datensatz-ID aus dem Such- oder Erstellungs-Tool bzw. aus Find Records oder Create Record in Zapier.