Hoppa till navigering

Twenty

Identifiera uppringare och lägg till nya leads i Twenty CRM via dess MCP-server.

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, som fungerar för Twenty Cloud och självhostade Twenty. Du kan också bygga webhook-verktyg 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

1

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.

2

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.

3

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.

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.

4

Lägg till MCP-servern

I Reception.ai går du till Integrations, väljer Add integration och väljer MCP Server.

FältVärde
NameTwenty
Server typeStreamable HTTP
Server URLDin arbetsyteadress följd av /mcp, enligt listan nedan
Secret TokenDin API-nyckel
Var Twenty körsServer-URL
Twenty CloudDin arbetsyte-URL, till exempel https://mycompany.twenty.com/mcp
SjälvhostadDen 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.

5

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.

6

Lägg till en procedur

Lägg till en procedur 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.

7

Testa

Testa din receptionist 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

ProblemKontrollera
Inga verktyg listasAnvä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örighetsfelNyckelns roll kan inte läsa eller skapa personer. Redigera rollen i Settings → Members → Roles.
Kända uppringare hittas inteSpara telefonnummer med landsnummer och i ett enhetligt format.
Samtalsorsaken är tomVä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 nyckelnRedigera integreringen och använd Rotate Secret Token (optional). Den sparade nyckeln visas aldrig igen.