> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # 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](#option-1-webhook-tools-recommended)** rufen Attios API direkt auf, ohne Zapier-Konto und ohne Zapier-Task-Verbrauch. * **[Zapier](#option-2-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) ### 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. ### Webhook-Tools erstellen Gehen Sie für jedes [unten aufgeführte Tool](#find-the-caller) 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. ### Regel hinzufügen Fügen Sie eine [Regel](/docs/de/reception-ai/receptionist/rules-and-procedures) hinzu, die Ihrer Rezeption vorgibt, Attio nur zur Erkennung von Anrufern zu verwenden und ihnen niemals Datensätze oder Notizen vorzulesen. ### Anrufer finden | Feld | Wert | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `find_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." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Request Headers** | `Authorization` (Secret): `Bearer ` gefolgt von Ihrem Token | | **Body Parameters** | `filter` (Objekt, erforderlich), mit dem unten stehenden Feld `limit` (Ganzzahl, fester Wert): `5` | | **Agenten zuweisen** | **Receptionist** | 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 | Feld | Wert | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `create_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." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Request Headers** | `Authorization` (Secret): `Bearer ` gefolgt von Ihrem Token | | **Body Parameters** | `data` (Objekt, erforderlich), mit den unten stehenden Feldern | | **Agenten zuweisen** | **Receptionist** | 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 | Feld | Wert | | -------------------- | ------------------------------------------------------------------------------------- | | **Name** | `add_attio_note` | | **Beschreibung** | "Das Anliegen des Anrufers vor Ende des Anrufs in seinem Personendatensatz notieren." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Request Headers** | `Authorization` (Secret): `Bearer ` gefolgt von Ihrem Token | | **Body Parameters** | `data` (Objekt, erforderlich), mit den unten stehenden Feldern | | **Agenten zuweisen** | **Receptionist** | 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. > **Warning** > > `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](/docs/de/reception-ai/receptionist/testing) 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 ### Zapier verbinden Falls noch nicht geschehen, verbinden Sie [Zapier](/docs/de/reception-ai/integrations/zapier) in Reception.ai. ### Attio-Aktionen hinzufügen Fügen Sie in Ihrem Zapier-MCP-Server unter [mcp.zapier.com](https://mcp.zapier.com) die [unten aufgeführten Aktionen](#zapier-actions) 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. ### 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. ### Regel hinzufügen Fügen Sie eine [Regel](/docs/de/reception-ai/receptionist/rules-and-procedures) hinzu, die Ihrer Rezeption vorgibt, Attio nur zur Erkennung von Anrufern zu verwenden und ihnen niemals Datensätze oder Notizen vorzulesen. > **Warning** > > 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. ### Testen [Testen Sie Ihre Rezeption](/docs/de/reception-ai/receptionist/testing) 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 | Feld | Wert | | ------------------------------- | ------------------------------------------------------ | | **Zapier-Aktion** | **Find Records** | | **In Zapier festlegen** | Das Objekt: Personen. Das Suchattribut: Telefonnummer. | | **Von der KI ausfüllen lassen** | Der Suchwert: die Telefonnummer des Anrufers. | | **Zuweisen an** | **Client** | #### Anrufer hinzufügen | Feld | Wert | | ------------------------------- | ----------------------------------------------------------------------------------------- | | **Zapier-Aktion** | **Create Record** | | **In Zapier festlegen** | Das Objekt: Personen. Attribute, die immer gleich sein sollen, falls Sie diese verwenden. | | **Von der KI ausfüllen lassen** | Vorname, Nachname, Telefonnummer und E-Mail-Adresse. | | **Zuweisen an** | **Client** | #### Notiz protokollieren | Feld | Wert | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | **Zapier-Aktion** | **Create Note** | | **In Zapier festlegen** | Das übergeordnete Objekt: Personen. | | **Von der KI ausfüllen lassen** | Die übergeordnete Datensatz-ID (aus den vorherigen Aktionen), ein Titel und der Notiztext mit dem Anliegen des Anrufers. | | **Zuweisen an** | **Client** | > **Tip** > > Unabhängig von der gewählten Option fügen Sie eine [Prozedur](/docs/de/reception-ai/receptionist/rules-and-procedures) > 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 | Problem | Prüfen | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 oder 403 von Attio | Beginnen 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 angezeigt | Wählen Sie in der Zapier-Integration **Refresh tools**, nachdem Sie Aktionen in Zapier hinzugefügt haben. | | Eine Aktion zeigt **Changed** und wird nicht verwendet | Sie haben sie in Zapier bearbeitet. Wählen Sie im Tab **Tools** **Update**. | | Bekannte Anrufer werden nicht gefunden | Prü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 fehl | Die 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üpft | Ihre Rezeption benötigt die Datensatz-ID aus dem Such- oder Erstellungs-Tool bzw. aus **Find Records** oder **Create Record** in Zapier. |