> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty 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](/docs/de/reception-ai/integrations/mcp-server) her, der mit Twenty Cloud und selbst gehostetem Twenty funktioniert. Sie können auch [Webhook-Tools](/docs/de/reception-ai/integrations/webhooks) 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 ### 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. ### 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. ### 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. > **Warning** > > 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. ### MCP-Server hinzufügen Gehen Sie in Reception.ai zu **Integrationen**, wählen Sie **Integration hinzufügen** und dann **MCP-Server**. | Feld | Wert | | ---------------- | --------------------------------------------------------------- | | **Name** | Twenty | | **Servertyp** | Streamable HTTP | | **Server-URL** | Ihre Workspace-Adresse gefolgt von `/mcp`, wie unten aufgeführt | | **Secret Token** | Ihr API-Schlüssel | | Ausführungsort von Twenty | Server-URL | | ------------------------- | ----------------------------------------------------------------------------- | | Twenty Cloud | Ihre Workspace-URL, zum Beispiel `https://mycompany.twenty.com/mcp` | | Selbst gehostet | Die ö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. ### 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. ### Vorgehensweise hinzufügen Fügen Sie für neue Leads eine [Vorgehensweise](/docs/de/reception-ai/receptionist/rules-and-procedures) 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. ### Testen [Testen Sie Ihre Rezeptionistin](/docs/de/reception-ai/receptionist/testing), 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 | Problem | Prüfen | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Es werden keine Tools aufgelistet | Verwenden 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ück | Die Rolle des Schlüssels kann Personen nicht lesen oder erstellen. Bearbeiten Sie die Rolle unter **Einstellungen** → **Mitglieder** → **Rollen**. | | Bekannte Anrufer werden nicht gefunden | Speichern Sie Telefonnummern mit Ländervorwahl und in einem einheitlichen Format. | | Der Anrufgrund ist leer | Wä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ändert | Bearbeiten Sie die Integration und verwenden Sie **Secret Token rotieren (optional)**. Der gespeicherte Schlüssel wird nie wieder angezeigt. |