Zur Navigation springen

Nutshell

Finden Sie Anrufer und fügen Sie während Anrufen neue Personen und Leads zu Nutshell hinzu.

Ihre Rezeption kann Anrufende erkennen, die bereits in Nutshell vorhanden sind, und neue Anrufende als Personen mit einem Lead für die Nachverfolgung durch Ihr Team hinzufügen. Zum Nachschlagen von Anrufenden wird ein Webhook-Tool verwendet. Personen und Leads werden über Zapier hinzugefügt, da die API von Nutshell die Telefonnummer einer neuen Person auf der sechsten Ebene der Anfrage erwartet und Webhook-Tools höchstens fünf senden können. Auch das nachträgliche Hinzufügen der Nummer funktioniert nicht, da Nutshell Personen mit einer JSON-Patch-Liste aktualisiert und der Body eines Webhook-Tools immer ein Objekt ist.

Anrufende nachschlagen

1

API-Schlüssel erstellen

Wählen Sie in Nutshell unten links Settings und dann unter Connections API keys. Wählen Sie Add API key und anschließend API + user impersonation, das auch Zapier benötigt. Kopieren Sie den Schlüssel.

2

Autorisierungs-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 beide Werte und behalten Sie den Doppelpunkt dazwischen bei:

printf 'YOUR_EMAIL:YOUR_API_KEY' | base64

Der Header-Wert besteht aus Basic gefolgt von der Ausgabe.

Fügen Sie Ihren API-Schlüssel nicht in einen Online-Encoder ein. Jeder, der den Schlüssel oder den kodierten Header hat, kann Ihre Nutshell-Daten lesen und ändern.

3

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

FeldWert
Namefind_nutshell_person
Beschreibung”Sucht anhand von Telefonnummer, Name oder E-Mail nach der anrufenden Person in unserem CRM. Verwenden Sie es zu Beginn eines Anrufs, um zu prüfen, ob es sich um einen bestehenden Kunden handelt.”
MethodeGET
URLhttps://app.nutshell.com/rest/contacts
Request HeadersAuthorization (Secret): Basic gefolgt vom kodierten Wert
Query Parametersq (string, erforderlich): “Telefonnummer, vollständiger Name oder E-Mail-Adresse der anrufenden Person.”
Agenten zuweisenReceptionist

Wählen Sie Enable.

find_nutshell_person gibt alles zurück, was zu passenden Personen gespeichert ist, und eine anrufende Person kann darum bitten, nach dem Namen einer anderen Person zu suchen. Fügen Sie eine Regel hinzu, die Ihre Rezeption anweist, das Tool nur zur Erkennung der anrufenden Person zu verwenden und niemals Personendetails vorzulesen.

Personen und Leads hinzufügen

1

Zapier verbinden

Falls noch nicht geschehen, verbinden Sie Zapier in Reception.ai.

2

Nutshell-Aktionen hinzufügen

Verbinden Sie auf Ihrem Zapier-MCP-Server unter 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 der anrufenden Person ausfüllen.
  • Create Lead: Legen Sie Quelle, Pipeline und Zuständige als feste Werte fest. Lassen Sie die KI eine Beschreibung dessen ausfüllen, was die anrufende Person möchte, und für welche Person es gedacht ist.

Um den Anruf in der Zeitleiste der Person zu erfassen, fügen Sie auch Log Activity hinzu und lassen Sie die KI eine kurze Zusammenfassung ausfüllen.

3

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 (der Rezeption) zu.

4

Testen

Testen Sie Ihre Rezeption mit einem Anruf von einer Nummer, die bei einer Person in Nutshell gespeichert ist, und anschließend als neue anrufende Person, die ein Angebot möchte. Die neue Person und ihr Lead werden in Nutshell angezeigt.

Einschränkungen

  • Die Nutshell-App von Zapier hat keine Aktion zum Erstellen einer Folgeaufgabe. Die für den Lead zuständige Person sieht neue Leads stattdessen in Nutshell.
  • Die Nutshell-App von Zapier kann die Verfügbarkeit von niemandem prüfen. Ihre Rezeption kann daher keine Termine in Nutshell buchen. Verwenden Sie die eigene Terminbuchung von Reception mit Google Calendar.
  • Jede Zapier-Aktion, die Ihre Rezeption ausführt, verbraucht Tasks aus Ihrem Zapier-Tarif. Zapier zählt derzeit zwei Tasks pro erfolgreichem Anruf; fehlgeschlagene Anrufe werden nicht gezählt. Wenn der Tarif aufgebraucht ist, werden die Aktionen angehalten, bis er zurückgesetzt wird.

Fehlerbehebung

ProblemPrüfen Sie
401 von NutshellKodieren Sie Ihre Nutshell-E-Mail-Adresse, einen Doppelpunkt und den Schlüssel. Beginnen Sie den Header-Wert mit Basic .
Bekannte Anrufende werden nicht gefundenTesten Sie einen Anruf von einer Nummer, die bei einer Person in Nutshell gespeichert ist, oder fragen Sie die anrufende Person stattdessen nach ihrem Namen.
Die Rezeption erstellt doppelte PersonenWeisen Sie sie in der Beschreibung des Nachschlage-Tools an, eine Person nur hinzuzufügen, wenn die anrufende Person nicht gefunden wurde.
Eine Nutshell-Aktion wird nicht in Reception.ai angezeigtWählen Sie in der Zapier-Integration Refresh tools, nachdem Sie Aktionen in Zapier hinzugefügt haben.
Zapier kann keine Verbindung zu Nutshell herstellenVerwenden Sie einen API-Schlüssel mit API + user impersonation.