> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Nutshell Ihr Rezeptionist kann Anrufer erkennen, die bereits in Nutshell vorhanden sind, und neue Anrufer als Personen mit einem Lead für Ihr Team zum Nachfassen hinzufügen. Zum Finden von Anrufern wird ein [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) verwendet. Personen und Leads werden über [Zapier](/docs/de/reception-ai/integrations/zapier) hinzugefügt, da die API von Nutshell zum Erstellen von Datensätzen Listen und verschachtelte Werte benötigt, die Webhook-Tools nicht senden können. ## Anrufer finden ### API-Schlüssel erstellen Wählen Sie in Nutshell unten links **Settings** und dann unter **Connections** die Option **API keys**. Wählen Sie **Add API key** und dann **API + user impersonation**, was auch Zapier benötigt. Kopieren Sie den Schlüssel. ### Authorization-Header erstellen Die API von Nutshell verwendet Ihre Nutshell-E-Mail-Adresse als Benutzernamen und den API-Schlüssel als Passwort. Kodieren Sie beides in einem Terminal, ersetzen Sie dabei beide Werte und behalten Sie den Doppelpunkt dazwischen bei: ```bash printf 'YOUR_EMAIL:YOUR_API_KEY' | base64 ``` Der Header-Wert ist `Basic ` gefolgt von der Ausgabe. > **Warning** > > Fügen Sie Ihren API-Schlüssel nicht in einen Online-Kodierer ein. Jeder, der den Schlüssel oder den kodierten Header hat, kann > Ihre Nutshell-Daten lesen und ändern. ### Webhook-Tool erstellen Gehen Sie zu **Integrations**, wählen Sie **Add integration** und dann **Webhook Tool**. | Feld | Wert | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `find_nutshell_person` | | **Beschreibung** | "Finde den Anrufer anhand von Telefonnummer, Name oder E-Mail-Adresse in unserem CRM. Verwende dies zu Beginn eines Anrufs, um zu prüfen, ob er bereits Kunde ist." | | **Methode** | GET | | **URL** | `https://app.nutshell.com/rest/contacts` | | **Request-Header** | `Authorization`: `Basic ` gefolgt vom kodierten Wert | | **Query-Parameter** | `q` (String, erforderlich): "Die Telefonnummer, der vollständige Name oder die E-Mail-Adresse des Anrufers." | | **Agenten zuweisen** | **Receptionist** | Wählen Sie **Enable**. ## Personen und Leads hinzufügen ### Zapier verbinden Falls noch nicht geschehen, verbinden Sie [Zapier](/docs/de/reception-ai/integrations/zapier) in Reception.ai. ### Nutshell-Aktionen hinzufügen Verbinden Sie in Ihrem Zapier-MCP-Server unter [mcp.zapier.com](https://mcp.zapier.com) Ihr Nutshell-Konto mit dem API-Schlüssel und fügen Sie diese Aktionen hinzu: * **Create Person**: Lassen Sie die KI Name, Telefonnummer und E-Mail-Adresse des Anrufers ausfüllen. * **Create Lead**: Legen Sie Quelle, Pipeline und Zuständigen als feste Werte fest und lassen Sie die KI eine Beschreibung dessen ausfüllen, was der Anrufer möchte und für wen es ist. > **Tip** > > Um den Anruf in der Zeitleiste der Person zu erfassen, fügen Sie außerdem **Log Activity** hinzu und lassen Sie die KI > eine kurze Zusammenfassung ausfüllen. ### Tools zuweisen Öffnen Sie in Reception.ai den Tab **Tools** der Zapier-Integration, wählen Sie **Refresh tools** und weisen Sie die Nutshell-Aktionen dem **Client** (Rezeptionisten) zu. ### Testen [Testen Sie Ihren Rezeptionisten](/docs/de/reception-ai/receptionist/testing) mit einem Anruf von einer Nummer, die bei einer Person in Nutshell gespeichert ist, und dann als neuer Anrufer, der ein Angebot möchte. Die neue Person und ihr Lead erscheinen in Nutshell. ## Einschränkungen * Die Nutshell-App von Zapier bietet keine Aktion zum Erstellen einer Folgeaufgabe. Stattdessen sieht der dem Lead zugewiesene Nutzer neue Leads in Nutshell. * Die Nutshell-App von Zapier kann die Verfügbarkeit von Personen nicht prüfen. Ihr Rezeptionist kann daher keine Meetings in Nutshell buchen. Verwenden Sie die eigene Terminbuchung von Reception mit [Google Calendar](/docs/de/reception-ai/integrations/google-calendar). * Jede Zapier-Aktion, die Ihr Rezeptionist ausführt, verbraucht Tasks aus Ihrem Zapier-Plan. Zapier zählt derzeit zwei Tasks pro erfolgreichem Anruf; fehlgeschlagene Anrufe werden nicht gezählt. Wenn Ihr Plan aufgebraucht ist, werden die Aktionen bis zur Zurücksetzung gestoppt. ## Fehlerbehebung | Problem | Prüfen Sie | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 von Nutshell | Kodieren Sie Ihre Nutshell-E-Mail-Adresse, einen Doppelpunkt und den Schlüssel und beginnen Sie den Header-Wert mit `Basic `. | | Bekannte Anrufer werden nicht gefunden | Testen Sie mit einem Anruf von einer Nummer, die bei einer Person in Nutshell gespeichert ist, oder fragen Sie den Anrufer stattdessen nach seinem Namen. | | Der Rezeptionist erstellt doppelte Personen | Sagen Sie ihm in der Beschreibung des Such-Tools, dass er eine Person nur hinzufügen soll, wenn der Anrufer nicht gefunden wurde. | | Eine Nutshell-Aktion wird nicht in Reception.ai angezeigt | Wählen Sie nach dem Hinzufügen von Aktionen in Zapier bei der Zapier-Integration **Refresh tools**. | | Zapier kann keine Verbindung zu Nutshell herstellen | Verwenden Sie einen API-Schlüssel mit **API + user impersonation**. |