Zur Navigation springen

Twenty

Anrufer erkennen und über den MCP-Server neue Leads zu Twenty CRM hinzufügen.

Ihre Rezeptionistin kann Anrufer erkennen, die bereits in Twenty vorhanden sind, und neue Anrufer als Personen mit Name, Telefonnummer und Anrufgrund hinzufügen, damit Ihr Vertriebsteam nachfassen kann. Reception stellt eine Verbindung zu Twentys integriertem MCP-Server her, der mit Twenty Cloud und selbst gehostetem Twenty funktioniert. Sie können auch Webhook-Tools für Twentys REST API erstellen, doch der MCP-Server benötigt weniger Einrichtung: Er stellt Ihrer Rezeptionistin sofort einsatzbereite Tools zum Finden und Hinzufügen von Personen bereit, die bereits den Feldern Ihres Workspace zugeordnet sind, einschließlich des unten genannten Felds für den Anrufgrund.

Einrichtung

1

Feld für den Anrufgrund hinzufügen

Personen in Twenty haben kein eigenes Notizfeld. Um den Anrufgrund im Datensatz zu speichern, gehen Sie zu Einstellungen → Datenmodell, öffnen Sie Personen und fügen Sie ein Text-Feld namens Call reason hinzu. Nur Workspace-Administratoren können das Datenmodell ändern.

2

Rolle für Reception.ai erstellen

Gehen Sie zu Einstellungen → Mitglieder → Rollen und erstellen Sie eine Rolle, die Personen nur lesen und erstellen darf. Im nächsten Schritt weisen Sie ihr den API-Schlüssel zu.

3

API-Schlüssel erstellen

Gehen Sie zu Einstellungen → Entwickler → API und wählen Sie + Schlüssel erstellen. Benennen Sie ihn beispielsweise Reception.ai und kopieren Sie ihn sofort: Twenty zeigt ihn nur einmal an. Öffnen Sie dann die erstellte Rolle, gehen Sie zum Tab Zuweisung und weisen Sie ihr den Schlüssel zu.

Der API-Schlüssel kann alles lesen und ändern, was seine Rolle erlaubt. Speichern Sie ihn nicht in freigegebenen Dokumenten und löschen Sie ihn in Twenty, falls er offengelegt wird.

4

MCP-Server hinzufügen

Gehen Sie in Reception.ai zu Integrationen, wählen Sie Integration hinzufügen und dann MCP-Server.

FeldWert
NameTwenty
ServertypStreamable HTTP
Server-URLIhre Workspace-Adresse gefolgt von /mcp, wie unten aufgeführt
Secret TokenIhr API-Schlüssel
Ausführungsort von TwentyServer-URL
Twenty CloudIhre Workspace-URL, zum Beispiel https://mycompany.twenty.com/mcp
Selbst gehostetDie öffentliche URL Ihrer Instanz, zum Beispiel https://crm.example.com/mcp

Die genaue Adresse können Sie in Twenty unter Einstellungen → KI → MCP kopieren. Fügen Sie ?mode=meta nicht zur URL hinzu: Dieser Modus gibt Ihrer Rezeptionistin ein einzelnes Tool, das jede Aktion ausführen kann.

Wählen Sie Aktivieren. Reception.ai sendet den Schlüssel als Bearer-Token und listet die Tools von Twenty auf.

5

Tools zuweisen

Twenty listet für jede Aktion auf jedem Objekt ein Tool auf. Öffnen Sie den Tab Tools und weisen Sie dem Client (der Rezeptionistin) nur diese zu:

  • find_many_people: Anrufer anhand der Telefonnummer finden.
  • create_one_person: neuen Anrufer mit Name, Telefonnummer und Anrufgrund hinzufügen.

Lassen Sie die Tools zum Aktualisieren und Löschen sowie die Tools für andere Objekte nicht zugewiesen.

6

Vorgehensweise hinzufügen

Fügen Sie für neue Leads eine Vorgehensweise hinzu: Suchen Sie zuerst anhand der Telefonnummer nach dem Anrufer, erstellen Sie nur dann eine Person, wenn keine Übereinstimmung gefunden wird, und füllen Sie immer Vorname, Nachname, Telefonnummer und Anrufgrund aus. Fügen Sie eine Regel hinzu, dass Ihre Rezeptionistin CRM-Datensätze niemals Anrufern vorliest.

7

Testen

Testen Sie Ihre Rezeptionistin, indem Sie von einer Nummer anrufen, die bei einer Twenty-Person gespeichert ist, und anschließend als neuer Anrufer, der ein Angebot anfordert. Die neue Person erscheint unter Personen mit ausgefülltem Anrufgrund.

Einschränkungen

  • Twenty speichert die Ländervorwahl getrennt vom Rest der Nummer. Anrufer, die ohne Ländervorwahl oder in einem anderen Format gespeichert sind, werden möglicherweise nicht gefunden. Dadurch kann ein wiederkehrender Anrufer doppelt hinzugefügt werden.
  • Ihre Rezeptionistin erstellt in dieser Einrichtung keine Notizen, Aufgaben oder Verkaufschancen. Ihr Team übernimmt neue Personen aus der Liste Personen, beispielsweise mit einer Ansicht, die nach Call reason gefiltert ist.
  • Selbst gehostete Instanzen benötigen eine Twenty-Version mit MCP-Server, und die öffentliche URL muss über HTTPS aus dem Internet erreichbar sein.
  • Twentys API erlaubt 100 Anfragen pro Minute. Ausgelastete Workspaces mit anderen Integrationen können das Limit erreichen.

Fehlerbehebung

ProblemPrüfen
Es werden keine Tools aufgelistetVerwenden Sie den Servertyp Streamable HTTP und prüfen Sie, ob die URL auf /mcp endet. Bei selbst gehosteten Instanzen muss die Einstellung SERVER_URL Ihre öffentliche URL sein.
Ein Tool gibt einen Berechtigungsfehler zurückDie Rolle des Schlüssels kann Personen nicht lesen oder erstellen. Bearbeiten Sie die Rolle unter Einstellungen → Mitglieder → Rollen.
Bekannte Anrufer werden nicht gefundenSpeichern Sie Telefonnummern mit Ländervorwahl und in einem einheitlichen Format.
Der Anrufgrund ist leerWählen Sie nach dem Hinzufügen des Felds Call reason Tools aktualisieren und dann beim geänderten Tool Aktualisieren.
Sie haben den Schlüssel geändertBearbeiten Sie die Integration und verwenden Sie Secret Token rotieren (optional). Der gespeicherte Schlüssel wird nie wieder angezeigt.