> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio Din receptionist kan känna igen uppringare som redan finns i Attio, lägga till nya uppringare som personer med deras namn och telefonnummer och lämna en anteckning om vad de ville, så att ditt team kan följa upp. Det finns två sätt att ansluta: * **[Webhook-verktyg](#option-1-webhook-tools-recommended)** anropar Attios API direkt, utan Zapier-konto och utan användning av Zapier-uppgifter. * **[Zapier](#option-2-zapier)**-åtgärder loggar in på Attio åt dig, men varje åtgärd använder uppgifter från din Zapier-plan. Använd webhook-verktyg om du inte kan få en Attio-administratör att skapa en åtkomsttoken. ## Alternativ 1: Webhook-verktyg (rekommenderas) ### Skapa en åtkomsttoken Du måste vara Attio-administratör. Välj rullgardinsmenyn bredvid namnet på din arbetsyta, öppna **Workspace settings**, gå till fliken **Developers** och välj **New access token**. Ge den ett namn, till exempel `Reception.ai`, och ge den bara de scopes som dessa verktyg behöver: läsning av objektkonfiguration (`object_configuration:read`), läsning och skrivning av poster (`record_permission:read-write`) och läsning och skrivning av anteckningar (`note:read-write`). Etiketterna i Attio kan skilja sig något från dessa namn. Tokenen upphör inte att gälla och kan se alla personer i din arbetsyta. Ta bort den i Attio om den läcker. ### Skapa webhook-verktygen För varje [verktyg nedan](#find-the-caller), gå till **Integrations**, välj **Add integration** och välj **Webhook Tool**. Alla verktyg skickar samma header: `Authorization` (Secret), inställd på `Bearer ` följt av din token. ### Lägg till en regel Lägg till en [regel](/docs/sv/reception-ai/receptionist/rules-and-procedures) som säger åt din receptionist att endast använda Attio för att känna igen uppringare och aldrig läsa upp poster eller anteckningar för dem. ### Hitta uppringaren | Fält | Värde | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Namn** | `find_attio_person` | | **Beskrivning** | "Hitta uppringaren bland våra personer i Attio med hjälp av telefonnummer. Använd det i början av ett samtal. Skicka personens record_id till anteckningsverktyget." | | **Metod** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Request Headers** | `Authorization` (Secret): `Bearer ` följt av din token | | **Body Parameters** | `filter` (objekt, krävs), med fältet nedan `limit` (heltal, fast värde): `5` | | **Tilldela till agenter** | **Receptionist** | Välj **Add field** på `filter` och lägg till: * `phone_numbers` (sträng, krävs, från konversationen): "Uppringarens telefonnummer i internationellt format, till exempel +14155550123." Attio returnerar endast personer vars sparade nummer matchar exakt, så spara nummer med landskod. ### Lägg till uppringaren | Fält | Värde | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **Namn** | `create_attio_person` | | **Beskrivning** | "Lägg till uppringaren som person, endast när `find_attio_person` inte hittade dem. Skicka den nya personens record_id till anteckningsverktyget." | | **Metod** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Request Headers** | `Authorization` (Secret): `Bearer ` följt av din token | | **Body Parameters** | `data` (objekt, krävs), med fälten nedan | | **Tilldela till agenter** | **Receptionist** | Välj **Add field** på `data` och lägg till `values` (objekt, krävs). På `values`, lägg till: * `name` (objekt, krävs), med tre fält: * `first_name` (sträng, krävs, från konversationen): "Uppringarens förnamn." * `last_name` (sträng, krävs, från konversationen): "Uppringarens efternamn, eller en tom sträng om de inte angav det." * `full_name` (sträng, krävs, från konversationen): "Uppringarens för- och efternamn." * `phone_numbers` (array, krävs, från konversationen): "Exakt ett objekt, för uppringarens telefonnummer." Under **Each item**, välj `string`, med beskrivningen "Uppringarens telefonnummer i internationellt format, till exempel +14155550123." * `email_addresses` (array, från konversationen): "Exakt ett objekt, för uppringarens e-postadress. Utelämna det om de inte angav någon." Under **Each item**, välj `string`, med beskrivningen "Uppringarens e-postadress." ### Logga en anteckning | Fält | Värde | | ------------------------- | ---------------------------------------------------------------------------- | | **Namn** | `add_attio_note` | | **Beskrivning** | "Anteckna vad uppringaren ville i deras personpost innan samtalet avslutas." | | **Metod** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Request Headers** | `Authorization` (Secret): `Bearer ` följt av din token | | **Body Parameters** | `data` (objekt, krävs), med fälten nedan | | **Tilldela till agenter** | **Receptionist** | Välj **Add field** på `data` för vart och ett av dessa: * `parent_object` (sträng, fast värde): `people` * `parent_record_id` (sträng, krävs, från konversationen): "Personens record_id från `find_attio_person` eller `create_attio_person`." * `title` (sträng, krävs, från konversationen): "En kort rubrik, till exempel: Samtal från Jane Doe om en offert." * `format` (sträng, fast värde): `plaintext` * `content` (sträng, krävs, från konversationen): "Vad uppringaren ville, i några meningar." Det överordnade objektet och formatet är fasta värden, så anteckningar hamnar alltid på en person, även om AI:n skickar andra värden. > **Warning** > > `find_attio_person` returnerar allt som sparats på personen. Behåll regeln så att din > receptionist endast använder Attio för att känna igen uppringaren och uppringare aldrig hör en annan persons > uppgifter. Välj **Enable** för varje verktyg och [testa din receptionist](/docs/sv/reception-ai/receptionist/testing) med ett samtal från ett nummer som sparats på en Attio-person, och sedan som en ny uppringare som ber om att bli uppringd. Den nya personen och en anteckning visas i Attio. ## Alternativ 2: Zapier ### Anslut Zapier Om du inte redan har gjort det, anslut [Zapier](/docs/sv/reception-ai/integrations/zapier) i Reception.ai. ### Lägg till Attio-åtgärderna I din Zapier MCP-server på [mcp.zapier.com](https://mcp.zapier.com), lägg till [åtgärderna nedan](#zapier-actions) från appen **Attio** och anslut din Attio-arbetsyta. För varje fält anger du antingen ett fast värde eller låter AI:n fylla i det, enligt listan. ### Tilldela verktygen I Reception.ai öppnar du Zapier-integrationens flik **Tools**, väljer **Refresh tools** och tilldelar varje åtgärd enligt listan. ### Lägg till en regel Lägg till en [regel](/docs/sv/reception-ai/receptionist/rules-and-procedures) som säger åt din receptionist att endast använda Attio för att känna igen uppringare och aldrig läsa upp poster eller anteckningar för dem. > **Warning** > > Zapier agerar som den Attio-användare som anslöt arbetsytan och kan se allt som den användaren kan se. > Anslut med en medlem vars åtkomst är begränsad till de poster som din receptionist behöver, och behåll > regeln så att uppringare aldrig hör en annan persons uppgifter. ### Testa [Testa din receptionist](/docs/sv/reception-ai/receptionist/testing) med ett samtal från ett nummer som sparats på en Attio-person, och sedan som en ny uppringare som ber om att bli uppringd. Den nya personen och en anteckning visas i Attio. ### Zapier-åtgärder #### Hitta uppringaren | Fält | Värde | | -------------------- | ------------------------------------------------------------- | | **Zapier-åtgärd** | **Find Records** | | **Ange i Zapier** | Objektet: Personer. Attributet att söka efter: telefonnummer. | | **Låt AI:n fylla i** | Värdet att söka efter: uppringarens telefonnummer. | | **Tilldela till** | **Klient** | #### Lägg till uppringaren | Fält | Värde | | -------------------- | ---------------------------------------------------------------------------------- | | **Zapier-åtgärd** | **Create Record** | | **Ange i Zapier** | Objektet: Personer. Alla attribut som alltid ska vara desamma, om du använder dem. | | **Låt AI:n fylla i** | Förnamn, efternamn, telefonnummer och e-postadress. | | **Tilldela till** | **Klient** | #### Logga en anteckning | Fält | Värde | | -------------------- | ---------------------------------------------------------------------------------------------------------------------- | | **Zapier-åtgärd** | **Create Note** | | **Ange i Zapier** | Det överordnade objektet: Personer. | | **Låt AI:n fylla i** | ID:t för den överordnade posten (från tidigare åtgärder), en rubrik och anteckningstexten med vad uppringaren behöver. | | **Tilldela till** | **Klient** | > **Tip** > > Oavsett vilket alternativ du använder, lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) > så att din receptionist först söker efter uppringaren, bara skapar en person när ingen matchning hittas > och sedan loggar en anteckning. ## Begränsningar * Attio kontrollerar att telefonnummer är giltiga. Be din receptionist, i verktygets eller åtgärdens beskrivning, att skicka nummer i internationellt format, till exempel `+14155550123`. * Det går inte att skapa en person om en annan person redan har samma unika värde, till exempel en e-postadress. Din receptionist bör söka först. * Uppgifter som skapas via Zapier kan inte länkas till en Attio-post, så använd anteckningen för samtalsuppgifter. * Med Zapier använder varje åtgärd som din receptionist kör uppgifter från din Zapier-plan. Zapier räknar för närvarande två uppgifter per lyckat samtal; misslyckade samtal räknas inte. När planen är slut stoppas åtgärderna tills den återställs. ## Felsökning | Problem | Vad du ska kontrollera | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | 401 eller 403 från Attio | Börja headervärdet med `Bearer ` och ett mellanslag, och kontrollera att tokenen har scopes ovan och inte har tagits bort. | | En Attio-åtgärd visas inte i Reception.ai | Välj **Refresh tools** på Zapier-integrationen efter att du har lagt till åtgärder i Zapier. | | En åtgärd visar **Changed** och används inte | Du har redigerat den i Zapier. Välj **Update** på fliken **Tools**. | | Kända uppringare hittas inte | Kontrollera att nummer sparas med landskod. Med Zapier kontrollerar du att **Find Records** söker i objektet Personer efter telefonnummer. | | Det går inte att skapa en person | Telefonnumret kanske inte är i internationellt format, eller så är uppringarens e-postadress redan sparad. | | Anteckningar länkas inte till uppringaren | Din receptionist behöver post-ID:t från verktyget för att hitta eller skapa, eller från **Find Records** eller **Create Record** i Zapier. |