> 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.

# JobNimbus

Mit dem unten beschriebenen [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) 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

1. Wählen Sie in JobNimbus oben rechts Ihr Profilsymbol aus, dann **Settings** → **API**, und erstellen Sie einen neuen API-Schlüssel.
2. 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.
3. 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`.

> **Warning**
>
> 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](/docs/de/reception-ai/receptionist/testing) als neuer Anrufer, der eine Dachinspektion benötigt. Der Kontakt erscheint in JobNimbus in Ihrem Lead-Status.

> **Tip**
>
> Fügen Sie eine [Anweisung](/docs/de/reception-ai/receptionist/rules-and-procedures) 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](/docs/de/reception-ai/integrations/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.                         |