> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio Je receptionist kan bellers herkennen die al in Attio staan, nieuwe bellers als personen toevoegen met hun naam en telefoonnummer, en een notitie achterlaten met wat ze wilden, zodat je team kan opvolgen. Er zijn twee manieren om verbinding te maken: * **[Webhooktools](#option-1-webhook-tools-recommended)** roepen de API van Attio rechtstreeks aan, zonder Zapier-account en zonder Zapier-taken te gebruiken. * **[Zapier](#option-2-zapier)**-acties loggen voor je in bij Attio, maar elke actie gebruikt taken uit je Zapier-abonnement. Gebruik webhooktools, tenzij je geen Attio-beheerder kunt vinden die een toegangstoken kan maken. ## Optie 1: Webhooktools (aanbevolen) ### Maak een toegangstoken Je moet Attio-beheerder zijn. Selecteer het dropdownmenu naast de naam van je workspace, open **Workspace settings**, ga naar het tabblad **Developers** en selecteer **New access token**. Geef het een naam, bijvoorbeeld `Reception.ai`, en geef het alleen de scopes die deze tools nodig hebben: objectconfiguratie lezen (`object_configuration:read`), records lezen en schrijven (`record_permission:read-write`) en notities lezen en schrijven (`note:read-write`). De labels in Attio kunnen enigszins afwijken van deze namen. Het token verloopt niet en kan elke persoon in je workspace zien. Verwijder het in Attio als het uitlekt. ### Maak de webhooktools Ga voor elke [onderstaande tool](#find-the-caller) naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**. Elke tool verstuurt dezelfde header: `Authorization` (Secret), ingesteld op `Bearer ` gevolgd door je token. ### Voeg een regel toe Voeg een [regel](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe die je receptionist vertelt Attio alleen te gebruiken om bellers te herkennen, en nooit records of notities aan hen voor te lezen. ### Zoek de beller | Veld | Waarde | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Naam** | `find_attio_person` | | **Beschrijving** | "Zoek de beller op tussen onze personen in Attio aan de hand van het telefoonnummer. Gebruik dit aan het begin van een gesprek. Geef de record_id van de persoon door aan de notitietool." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Requestheaders** | `Authorization` (Secret): `Bearer ` gevolgd door je token | | **Bodyparameters** | `filter` (object, verplicht), met het onderstaande veld `limit` (integer, vaste waarde): `5` | | **Toewijzen aan agents** | **Receptionist** | Selecteer **Add field** bij `filter` en voeg het volgende toe: * `phone_numbers` (string, verplicht, uit het gesprek): "Het telefoonnummer van de beller in internationale notatie, bijvoorbeeld +14155550123." Attio retourneert alleen personen van wie het opgeslagen nummer exact overeenkomt, dus sla nummers op met hun landcode. ### Voeg de beller toe | Veld | Waarde | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Naam** | `create_attio_person` | | **Beschrijving** | "Voeg de beller als persoon toe, alleen wanneer `find_attio_person` deze niet heeft gevonden. Geef de record_id van de nieuwe persoon door aan de notitietool." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Requestheaders** | `Authorization` (Secret): `Bearer ` gevolgd door je token | | **Bodyparameters** | `data` (object, verplicht), met de onderstaande velden | | **Toewijzen aan agents** | **Receptionist** | Selecteer **Add field** bij `data` en voeg `values` (object, verplicht) toe. Voeg bij `values` het volgende toe: * `name` (object, verplicht), met drie velden: * `first_name` (string, verplicht, uit het gesprek): "De voornaam van de beller." * `last_name` (string, verplicht, uit het gesprek): "De achternaam van de beller, of een lege string als deze niet is gegeven." * `full_name` (string, verplicht, uit het gesprek): "De voor- en achternaam van de beller." * `phone_numbers` (array, verplicht, uit het gesprek): "Precies één item, voor het telefoonnummer van de beller." Kies onder **Each item** `string`, met als beschrijving: "Het telefoonnummer van de beller in internationale notatie, bijvoorbeeld +14155550123." * `email_addresses` (array, uit het gesprek): "Precies één item, voor het e-mailadres van de beller. Laat dit weg als deze geen e-mailadres heeft gegeven." Kies onder **Each item** `string`, met als beschrijving: "Het e-mailadres van de beller." ### Leg een notitie vast | Veld | Waarde | | ------------------------ | ------------------------------------------------------------------------------- | | **Naam** | `add_attio_note` | | **Beschrijving** | "Noteer wat de beller wilde in het personenrecord voordat het gesprek eindigt." | | **Methode** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Requestheaders** | `Authorization` (Secret): `Bearer ` gevolgd door je token | | **Bodyparameters** | `data` (object, verplicht), met de onderstaande velden | | **Toewijzen aan agents** | **Receptionist** | Selecteer voor elk van deze opties **Add field** bij `data`: * `parent_object` (string, vaste waarde): `people` * `parent_record_id` (string, verplicht, uit het gesprek): "De record_id van de persoon uit `find_attio_person` of `create_attio_person`." * `title` (string, verplicht, uit het gesprek): "Een korte titel, bijvoorbeeld: Gesprek van Jane Doe over een offerte." * `format` (string, vaste waarde): `plaintext` * `content` (string, verplicht, uit het gesprek): "Wat de beller wilde, in enkele zinnen." Het bovenliggende object en de indeling zijn vaste waarden, zodat notities altijd bij een persoon terechtkomen, ook als de AI andere waarden verstuurt. > **Warning** > > `find_attio_person` retourneert alles wat bij de persoon is opgeslagen. Houd de regel actief zodat je > receptionist Attio alleen gebruikt om de beller te herkennen en bellers nooit de gegevens van een andere persoon > horen. Selecteer **Enable** bij elke tool en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) vervolgens met een gesprek vanaf een nummer dat bij een persoon in Attio is opgeslagen, en daarna als een nieuwe beller die om een terugbelverzoek vraagt. De nieuwe persoon en een notitie verschijnen in Attio. ## Optie 2: Zapier ### Verbind Zapier Als je dit nog niet hebt gedaan, verbind je [Zapier](/docs/nl/reception-ai/integrations/zapier) in Reception.ai. ### Voeg de Attio-acties toe Voeg in je Zapier MCP-server op [mcp.zapier.com](https://mcp.zapier.com) de [onderstaande acties](#zapier-actions) toe vanuit de app **Attio** en verbind je Attio-workspace. Stel voor elk veld een vaste waarde in of laat de AI het invullen, zoals aangegeven. ### Wijs de tools toe Open in Reception.ai het tabblad **Tools** van de Zapier-integratie, selecteer **Refresh tools** en wijs elke actie toe zoals aangegeven. ### Voeg een regel toe Voeg een [regel](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe die je receptionist vertelt Attio alleen te gebruiken om bellers te herkennen, en nooit records of notities aan hen voor te lezen. > **Warning** > > Zapier handelt namens de Attio-gebruiker die de workspace heeft verbonden en kan alles zien wat die gebruiker kan zien. > Verbind met een lid waarvan de toegang beperkt is tot de records die je receptionist nodig heeft, en houd de > regel actief zodat bellers nooit de gegevens van een andere persoon horen. ### Test dit [Test je receptionist](/docs/nl/reception-ai/receptionist/testing) met een gesprek vanaf een nummer dat bij een persoon in Attio is opgeslagen, en daarna als een nieuwe beller die om een terugbelverzoek vraagt. De nieuwe persoon en een notitie verschijnen in Attio. ### Zapier-acties #### Zoek de beller | Veld | Waarde | | ----------------------- | ------------------------------------------------------------------ | | **Zapier-actie** | **Find Records** | | **Instellen in Zapier** | Het object: People. Het attribuut waarop je zoekt: telefoonnummer. | | **Laat de AI invullen** | De waarde om naar te zoeken: het telefoonnummer van de beller. | | **Toewijzen aan** | **Client** | #### Voeg de beller toe | Veld | Waarde | | ----------------------- | ------------------------------------------------------------------------------------------ | | **Zapier-actie** | **Create Record** | | **Instellen in Zapier** | Het object: People. Alle attributen die altijd hetzelfde moeten zijn, als je die gebruikt. | | **Laat de AI invullen** | Voornaam, achternaam, telefoonnummer en e-mailadres. | | **Toewijzen aan** | **Client** | #### Leg een notitie vast | Veld | Waarde | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Zapier-actie** | **Create Note** | | **Instellen in Zapier** | Het bovenliggende object: People. | | **Laat de AI invullen** | De ID van het bovenliggende record (uit de vorige acties), een titel en de notitietekst met wat de beller nodig heeft. | | **Toewijzen aan** | **Client** | > **Tip** > > Welke optie je ook gebruikt, voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) > toe zodat je receptionist eerst naar de beller zoekt, alleen een persoon maakt wanneer er geen overeenkomst is gevonden, > en vervolgens een notitie vastlegt. ## Beperkingen * Attio controleert of telefoonnummers geldig zijn. Vertel je receptionist in de beschrijving van de tool of actie nummers in internationale notatie te versturen, zoals `+14155550123`. * Een persoon maken mislukt wanneer een andere persoon al dezelfde unieke waarde heeft, zoals een e-mailadres. Je receptionist moet eerst zoeken. * Taken die via Zapier worden gemaakt, kunnen niet aan een Attio-record worden gekoppeld. Gebruik daarom de notitie voor gespreksdetails. * Met Zapier gebruikt elke actie die je receptionist uitvoert taken uit je Zapier-abonnement. Zapier telt momenteel twee taken per succesvol gesprek; mislukte gesprekken worden niet geteld. Wanneer het abonnement op is, stoppen de acties totdat het wordt gereset. ## Problemen oplossen | Probleem | Wat je moet controleren | | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | 401 of 403 van Attio | Begin de headerwaarde met `Bearer ` en een spatie, en controleer of het token de bovenstaande scopes heeft en niet is verwijderd. | | Een Attio-actie verschijnt niet in Reception.ai | Selecteer **Refresh tools** bij de Zapier-integratie nadat je acties in Zapier hebt toegevoegd. | | Een actie toont **Changed** en wordt niet gebruikt | Je hebt deze in Zapier bewerkt. Selecteer **Update** op het tabblad **Tools**. | | Bekende bellers worden niet gevonden | Controleer of nummers met hun landcode zijn opgeslagen. Controleer met Zapier of **Find Records** in het People-object op telefoonnummer zoekt. | | Een persoon maken mislukt | Het telefoonnummer is mogelijk niet in internationale notatie, of het e-mailadres van de beller is al opgeslagen. | | Notities zijn niet gekoppeld aan de beller | Je receptionist heeft de record-ID nodig van de zoek- of maaktool, of van **Find Records** of **Create Record** in Zapier. |