> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Din receptionist kan identifiera uppringare som redan finns i Twenty och lägga till nya uppringare som personer med namn, telefonnummer och anledning till samtalet, så att säljteamet kan följa upp. Reception ansluter till Twentys inbyggda [MCP-server](/docs/sv/reception-ai/integrations/mcp-server), som fungerar för Twenty Cloud och självhostade Twenty. Du kan också bygga [webhook-verktyg](/docs/sv/reception-ai/integrations/webhooks) för Twentys REST API, men MCP-servern kräver mindre konfigurering: den ger receptionisten färdiga verktyg för att hitta och lägga till personer, redan anpassade till fälten i din arbetsyta, inklusive fältet för samtalsorsak nedan. ## Konfigurera ### Lägg till ett fält för samtalsorsaken Personer i Twenty har inget eget anteckningsfält. För att spara varför uppringaren ringde i personens post går du till **Settings** → **Data model**, öppnar **People** och lägger till ett **Text**-fält med namnet `Call reason`. Endast arbetsyteadministratörer kan ändra datamodellen. ### Skapa en roll för Reception.ai Gå till **Settings** → **Members** → **Roles** och skapa en roll som endast kan läsa och skapa personer. Du tilldelar API-nyckeln till rollen i nästa steg. ### Skapa en API-nyckel Gå till **Settings** → **Developers** → **API** och välj **+ Create key**. Ge den ett namn, till exempel `Reception.ai`, och kopiera den direkt: Twenty visar den bara en gång. Öppna sedan rollen du skapade, gå till fliken **Assignment** och tilldela nyckeln till den. > **Warning** > > API-nyckeln kan läsa och ändra allt som rollen tillåter. Förvara den inte i delade dokument och > radera den i Twenty om den läcker. ### Lägg till MCP-servern I Reception.ai går du till **Integrations**, väljer **Add integration** och väljer **MCP Server**. | Fält | Värde | | ---------------- | -------------------------------------------------------- | | **Name** | Twenty | | **Server type** | Streamable HTTP | | **Server URL** | Din arbetsyteadress följd av `/mcp`, enligt listan nedan | | **Secret Token** | Din API-nyckel | | Var Twenty körs | Server-URL | | --------------- | --------------------------------------------------------------------------------- | | Twenty Cloud | Din arbetsyte-URL, till exempel `https://mycompany.twenty.com/mcp` | | Självhostad | Den offentliga URL:en för din instans, till exempel `https://crm.example.com/mcp` | Du kan kopiera den exakta adressen från **Settings** → **AI** → **MCP** i Twenty. Lägg inte till `?mode=meta` i URL:en: det läget ger receptionisten ett enda verktyg som kan köra valfri åtgärd. Välj **Enable**. Reception.ai skickar nyckeln som en bearer-token och listar Twentys verktyg. ### Tilldela verktyg Twenty listar ett verktyg för varje åtgärd på varje objekt. Öppna fliken **Tools** och tilldela endast dessa till **Client** (receptionisten): * `find_many_people`: hitta uppringaren via telefonnummer. * `create_one_person`: lägg till en ny uppringare med namn, telefonnummer och samtalsorsak. Lämna verktygen för uppdatering och borttagning, samt verktygen för andra objekt, otilldelade. ### Lägg till en procedur Lägg till en [procedur](/docs/sv/reception-ai/receptionist/rules-and-procedures) för nya leads: sök först efter uppringaren via telefonnummer, skapa bara en person när ingen matchning hittas och fyll alltid i förnamn, efternamn, telefonnummer och samtalsorsak. Lägg till en regel om att receptionisten aldrig läser upp CRM-poster för uppringare. ### Testa [Testa din receptionist](/docs/sv/reception-ai/receptionist/testing) genom att ringa från ett nummer som sparats på en person i Twenty och sedan som en ny uppringare som vill ha en offert. Den nya personen visas under **People** med ifylld samtalsorsak. ## Begränsningar * Twenty lagrar landsnumret separat från resten av numret. Uppringare som sparats utan landsnummer, eller i ett annat format, kanske inte hittas, så en återkommande uppringare kan läggas till två gånger. * Receptionisten skapar inte anteckningar, uppgifter eller affärsmöjligheter i den här konfigurationen. Ditt team hanterar nya personer från listan **People**, till exempel med en vy filtrerad på **Call reason**. * Självhostade instanser behöver en Twenty-version som innehåller MCP-servern, och den offentliga URL:en måste vara åtkomlig från internet via HTTPS. * Twentys API tillåter 100 förfrågningar per minut. Upptagna arbetsytor med andra integreringar kan nå gränsen. ## Felsökning | Problem | Kontrollera | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Inga verktyg listas | Använd servertypen **Streamable HTTP** och kontrollera att URL:en slutar med `/mcp`. För självhostade installationer måste inställningen `SERVER_URL` vara din offentliga URL. | | Ett verktyg returnerar ett behörighetsfel | Nyckelns roll kan inte läsa eller skapa personer. Redigera rollen i **Settings** → **Members** → **Roles**. | | Kända uppringare hittas inte | Spara telefonnummer med landsnummer och i ett enhetligt format. | | Samtalsorsaken är tom | Välj **Refresh tools** efter att du har lagt till fältet `Call reason`, och välj sedan **Update** för det ändrade verktyget. | | Du har ändrat nyckeln | Redigera integreringen och använd **Rotate Secret Token (optional)**. Den sparade nyckeln visas aldrig igen. |