Twenty
Herken bellers en voeg nieuwe leads toe aan Twenty CRM via de MCP-server.
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 van Twenty, die werkt voor Twenty Cloud en zelfgehoste Twenty. Je kunt ook webhooktools 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.
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.
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 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 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.