> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Je receptionist kan bellers herkennen die al in Twenty staan en nieuwe bellers als personen toevoegen, met hun naam, telefoonnummer en de reden waarom ze belden, zodat je salesteam opvolging kan geven. Reception maakt verbinding met de ingebouwde [MCP-server](/docs/nl/reception-ai/integrations/mcp-server) van Twenty, die werkt voor Twenty Cloud en zelfgehoste Twenty. Je kunt ook [webhooktools](/docs/nl/reception-ai/integrations/webhooks) bouwen voor de REST API van Twenty, maar de MCP-server vereist minder configuratie: deze geeft je receptionist kant-en-klare tools om personen te vinden en toe te voegen, die al zijn afgestemd op de velden van je workspace, waaronder het onderstaande veld voor de reden van het gesprek. ## Instellen ### Voeg een veld toe voor de reden van het gesprek Personen in Twenty hebben geen eigen notitieveld. Ga naar **Instellingen** → **Datamodel**, open **Personen** en voeg een **Tekst**-veld toe met de naam `Call reason` om de reden waarom de beller belde in diens record te bewaren. Alleen workspacebeheerders kunnen het datamodel wijzigen. ### Maak een rol voor Reception.ai Ga naar **Instellingen** → **Leden** → **Rollen** en maak een rol die alleen Personen kan lezen en maken. In de volgende stap wijs je de API-sleutel eraan toe. ### Maak een API-sleutel Ga naar **Instellingen** → **Ontwikkelaars** → **API** en selecteer **+ Sleutel maken**. Geef deze bijvoorbeeld de naam `Reception.ai` en kopieer hem meteen: Twenty toont hem maar één keer. Open daarna de rol die je hebt gemaakt, ga naar het tabblad **Toewijzing** en wijs de sleutel eraan toe. > **Warning** > > De API-sleutel kan alles lezen en wijzigen wat de rol toestaat. Bewaar hem niet in gedeelde documenten en > verwijder hem in Twenty als hij uitlekt. ### Voeg de MCP-server toe Ga in Reception.ai naar **Integraties**, selecteer **Integratie toevoegen** en kies **MCP Server**. | Veld | Waarde | | ---------------- | -------------------------------------------------------------- | | **Naam** | Twenty | | **Servertype** | Streamable HTTP | | **Server-URL** | Je workspaceadres gevolgd door `/mcp`, zoals hieronder vermeld | | **Secret Token** | Je API-sleutel | | Waar Twenty draait | Server-URL | | ------------------ | --------------------------------------------------------------------------- | | Twenty Cloud | Je workspace-URL, bijvoorbeeld `https://mycompany.twenty.com/mcp` | | Zelfgehost | De openbare URL van je instance, bijvoorbeeld `https://crm.example.com/mcp` | Je kunt het exacte adres kopiëren uit **Instellingen** → **AI** → **MCP** in Twenty. Voeg `?mode=meta` niet toe aan de URL: die modus geeft je receptionist één tool waarmee elke actie kan worden uitgevoerd. Selecteer **Inschakelen**. Reception.ai verzendt de sleutel als bearer token en toont de tools van Twenty. ### Wijs tools toe Twenty toont een tool voor elke actie op elk object. Open het tabblad **Tools** en wijs alleen deze toe aan de **Client** (receptionist): * `find_many_people`: zoek de beller op telefoonnummer. * `create_one_person`: voeg een nieuwe beller toe met naam, telefoonnummer en reden van het gesprek. Laat de tools voor bijwerken en verwijderen, en de tools voor andere objecten, niet toegewezen. ### Voeg een procedure toe Voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe voor nieuwe leads: zoek de beller eerst op telefoonnummer, maak alleen een persoon als er geen overeenkomst wordt gevonden, en vul altijd de voornaam, achternaam, het telefoonnummer en de reden van het gesprek in. Voeg een regel toe dat je receptionist CRM-records nooit aan bellers voorleest. ### Testen [Test je receptionist](/docs/nl/reception-ai/receptionist/testing) door te bellen vanaf een nummer dat is opgeslagen bij een persoon in Twenty, en daarna als een nieuwe beller die een offerte wil. De nieuwe persoon verschijnt onder **Personen** met de ingevulde reden van het gesprek. ## Beperkingen * Twenty slaat de landcode apart van de rest van het nummer op. Bellers die zonder landcode of in een andere indeling zijn opgeslagen, worden mogelijk niet gevonden, waardoor een terugkerende beller twee keer kan worden toegevoegd. * In deze configuratie maakt je receptionist geen notities, taken of verkoopkansen. Je team pakt nieuwe personen op vanuit de lijst **Personen**, bijvoorbeeld met een weergave gefilterd op **Call reason**. * Zelfgehoste instances hebben een Twenty-versie nodig die de MCP-server bevat, en de openbare URL moet via HTTPS bereikbaar zijn vanaf het internet. * De API van Twenty staat 100 requests per minuut toe. Drukke workspaces met andere integraties kunnen de limiet bereiken. ## Problemen oplossen | Probleem | Wat je moet controleren | | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Er worden geen tools weergegeven | Gebruik het servertype **Streamable HTTP** en controleer of de URL eindigt op `/mcp`. Bij zelfhosting moet de instelling `SERVER_URL` je openbare URL zijn. | | Een tool geeft een rechtenfout | De rol van de sleutel kan Personen niet lezen of maken. Bewerk de rol via **Instellingen** → **Leden** → **Rollen**. | | Bekende bellers worden niet gevonden | Sla telefoonnummers op met de landcode en in één indeling. | | De reden van het gesprek is leeg | Selecteer **Tools vernieuwen** nadat je het veld `Call reason` hebt toegevoegd en selecteer daarna **Bijwerken** bij de gewijzigde tool. | | Je hebt de sleutel gewijzigd | Bewerk de integratie en gebruik **Secret Token roteren (optioneel)**. De opgeslagen sleutel wordt nooit meer getoond. |