Naar navigatie springen

Attio

Herken bellers, voeg nieuwe personen toe en leg tijdens gesprekken gespreksnotities vast in 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 roepen de API van Attio rechtstreeks aan, zonder Zapier-account en zonder Zapier-taken te gebruiken.
  • 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)

1

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.

2

Maak de webhooktools

Ga voor elke onderstaande tool naar Integrations, selecteer Add integration en kies Webhook Tool. Elke tool verstuurt dezelfde header: Authorization (Secret), ingesteld op Bearer gevolgd door je token.

3

Voeg een regel toe

Voeg een regel 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

VeldWaarde
Naamfind_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.”
MethodePOST
URLhttps://api.attio.com/v2/objects/people/records/query
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Bodyparametersfilter (object, verplicht), met het onderstaande veld
limit (integer, vaste waarde): 5
Toewijzen aan agentsReceptionist

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

VeldWaarde
Naamcreate_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.”
MethodePOST
URLhttps://api.attio.com/v2/objects/people/records
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Bodyparametersdata (object, verplicht), met de onderstaande velden
Toewijzen aan agentsReceptionist

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

VeldWaarde
Naamadd_attio_note
Beschrijving”Noteer wat de beller wilde in het personenrecord voordat het gesprek eindigt.”
MethodePOST
URLhttps://api.attio.com/v2/notes
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Bodyparametersdata (object, verplicht), met de onderstaande velden
Toewijzen aan agentsReceptionist

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.

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

1

Verbind Zapier

Als je dit nog niet hebt gedaan, verbind je Zapier in Reception.ai.

2

Voeg de Attio-acties toe

Voeg in je Zapier MCP-server op mcp.zapier.com de onderstaande acties 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.

3

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.

4

Voeg een regel toe

Voeg een regel toe die je receptionist vertelt Attio alleen te gebruiken om bellers te herkennen, en nooit records of notities aan hen voor te lezen.

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.

5

Test dit

Test je receptionist 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

VeldWaarde
Zapier-actieFind Records
Instellen in ZapierHet object: People. Het attribuut waarop je zoekt: telefoonnummer.
Laat de AI invullenDe waarde om naar te zoeken: het telefoonnummer van de beller.
Toewijzen aanClient

Voeg de beller toe

VeldWaarde
Zapier-actieCreate Record
Instellen in ZapierHet object: People. Alle attributen die altijd hetzelfde moeten zijn, als je die gebruikt.
Laat de AI invullenVoornaam, achternaam, telefoonnummer en e-mailadres.
Toewijzen aanClient

Leg een notitie vast

VeldWaarde
Zapier-actieCreate Note
Instellen in ZapierHet bovenliggende object: People.
Laat de AI invullenDe ID van het bovenliggende record (uit de vorige acties), een titel en de notitietekst met wat de beller nodig heeft.
Toewijzen aanClient

Welke optie je ook gebruikt, voeg een procedure 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

ProbleemWat je moet controleren
401 of 403 van AttioBegin 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.aiSelecteer Refresh tools bij de Zapier-integratie nadat je acties in Zapier hebt toegevoegd.
Een actie toont Changed en wordt niet gebruiktJe hebt deze in Zapier bewerkt. Selecteer Update op het tabblad Tools.
Bekende bellers worden niet gevondenControleer of nummers met hun landcode zijn opgeslagen. Controleer met Zapier of Find Records in het People-object op telefoonnummer zoekt.
Een persoon maken misluktHet telefoonnummer is mogelijk niet in internationale notatie, of het e-mailadres van de beller is al opgeslagen.
Notities zijn niet gekoppeld aan de bellerJe receptionist heeft de record-ID nodig van de zoek- of maaktool, of van Find Records of Create Record in Zapier.