JobNimbus | ElevenLabs Documentation

Mit dem unten beschriebenen Webhook-Tool kann Ihr Rezeptionist einen neuen Anrufer in JobNimbus als Kontakt in Ihrem Lead-Workflow hinzufügen – mit Telefonnummer, Adresse und Anliegen, damit Ihr Team nachfassen kann.

Bevor Sie beginnen

Wählen Sie in JobNimbus oben rechts Ihr Profilsymbol aus, dann Settings → API, und erstellen Sie einen neuen API-Schlüssel.
Wählen Sie ein Access Profile, das Kontakte erstellen kann und nur die Berechtigungen enthält, die Sie benötigen. Der Schlüssel behält die Berechtigungen, die das Profil bei seiner Erstellung hatte.
Kopieren Sie den vollständigen API-Schlüssel, nicht die Key ID. JobNimbus zeigt ihn nur einmal an.

Das Tool sendet den Schlüssel im Request-Header Authorization als Bearer YOUR_API_KEY.

Der API-Schlüssel ermöglicht Zugriff auf Ihre JobNimbus-Daten. Bewahren Sie ihn sicher auf und teilen Sie ihn nicht. Neue Schlüssel laufen nach einem Jahr ab. Erstellen Sie vorher einen Ersatzschlüssel.

Sie benötigen außerdem die exakten Namen des Kontakt-Workflows und des Status, in dem neue Leads landen sollen, so wie sie in Ihren JobNimbus-Einstellungen angezeigt werden, zum Beispiel Customer und Lead.

Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration, dann Webhook Tool, und füllen Sie die folgenden Felder aus.

Feld	Wert
Name	`create_jobnimbus_contact`
Beschreibung	”Füge den Anrufer als neuen Lead zu unserem CRM hinzu, wenn er Arbeiten benötigt und uns noch nicht genutzt hat.”
Methode	POST
URL	`https://app.jobnimbus.com/api1/contacts`
Request-Header	`Authorization`: `Bearer YOUR_API_KEY`
Body-Parameter	`first_name` (String, erforderlich): “Der Vorname des Anrufers.” `last_name` (String, erforderlich): “Der Nachname des Anrufers.” `record_type_name` (String, erforderlich): “Immer der exakte Wert `Customer`.” `status_name` (String, erforderlich): “Immer der exakte Wert `Lead`.” `mobile_phone` (String, erforderlich): “Die Telefonnummer des Anrufers, nur Ziffern.” `email` (String): “Die E-Mail-Adresse des Anrufers, falls er eine angegeben hat.” `address_line1` (String): “Die Straßenadresse, an der die Arbeiten benötigt werden.” `city` (String): “Die Stadt dieser Adresse.” `state_text` (String): “Das Bundesland als zweistelliger Code.” `zip` (String): “Die Postleitzahl.” `description` (String, erforderlich): “Was der Anrufer benötigt, wann er verfügbar ist und alles Weitere, was er Ihnen mitgeteilt hat.”
Agenten zuweisen	Receptionist

Ersetzen Sie Customer und Lead durch die Namen Ihres eigenen Workflows und Status.

Wählen Sie Enable und testen Sie Ihren Rezeptionisten als neuer Anrufer, der eine Dachinspektion benötigt. Der Kontakt erscheint in JobNimbus in Ihrem Lead-Status.

Fügen Sie eine Anweisung hinzu, die Ihrem Rezeptionisten sagt, vor dem Hinzufügen des Anrufers die vollständige Adresse zu erfassen.

Einschränkungen

Für die Suche nach JobNimbus-Kontakten ist ein JSON-Suchfilter erforderlich. Dieses Tool kann Anrufer daher nicht finden. Ein wiederkehrender Anrufer kann zweimal hinzugefügt werden.
Jobs, Aufgaben und Notizen werden über verschachtelte Felder mit einem Kontakt verknüpft, die Webhook-Tools nicht senden können. Die Kontaktbeschreibung enthält stattdessen die Anrufdetails.

Um Anrufer per E-Mail zu finden und Jobs zu erstellen, die mit ihrem Kontakt verknüpft sind, verwenden Sie die JobNimbus-Aktionen Find Contact by Email, Create Contact und Create Job über Zapier.

Fehlerbehebung

Problem	Prüfen Sie
401 oder 403 von JobNimbus	Der Header-Wert muss mit `Bearer` beginnen, gefolgt vom vollständigen API-Schlüssel, nicht der Key ID. Prüfen Sie, ob der Schlüssel abgelaufen ist.
Fehler zum Workflow oder Status	`record_type_name` und `status_name` müssen exakt mit einem Kontakt-Workflow und einem seiner Status übereinstimmen.
403 mit einer Berechtigungsmeldung	Das Access Profile des Schlüssels kann keine Kontakte erstellen. Erstellen Sie einen neuen Schlüssel mit einem Profil, das dies kann.
Kontakte haben keine Adresse	Lassen Sie die Beschreibung dem Rezeptionisten sagen, vor dem Hinzufügen des Anrufers nach der vollständigen Adresse zu fragen.