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

# ServiceM8

Mit den folgenden [Webhook-Tools](/docs/de/reception-ai/integrations/webhooks) kann Ihre Rezeption in ServiceM8 ein Angebot oder einen Auftrag erstellen, wenn ein Anrufer Arbeiten benötigt, und neue Anrufer als Kunden hinzufügen.

## Bevor Sie beginnen

Öffnen Sie in ServiceM8 **Einstellungen** → **API-Schlüssel** und erstellen Sie einen Schlüssel. Jedes folgende Tool sendet ihn im Request-Header `X-Api-Key`. Jeder mit diesem Schlüssel kann Ihre ServiceM8-Daten lesen und ändern. Bewahren Sie ihn daher nicht in freigegebenen Dokumenten auf.

## Tools erstellen

Gehen Sie für jedes Tool zu **Integrationen**, wählen Sie **Integration hinzufügen**, dann **Webhook-Tool** und setzen Sie **Agenten zuweisen** auf **Rezeption**.

### Auftrag erstellen

| Feld                | Wert                                                                                                                                                                                                                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**            | `create_servicem8_job`                                                                                                                                                                                                                                                                                                                           |
| **Beschreibung**    | "Erstellen Sie einen Auftrag, wenn ein Anrufer Arbeiten benötigt oder ein Angebot möchte."                                                                                                                                                                                                                                                       |
| **Methode**         | POST                                                                                                                                                                                                                                                                                                                                             |
| **URL**             | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                                                                                                                                                     |
| **Request-Headers** | `X-Api-Key`: Ihr API-Schlüssel                                                                                                                                                                                                                                                                                                                   |
| **Body-Parameter**  | `status` (String, erforderlich): "Immer exakt der Wert `Quote`."  `job_address` (String, erforderlich): "Die vollständige Adresse einschließlich Postleitzahl, an der die Arbeiten benötigt werden."  `job_description` (String, erforderlich): "Name und Telefonnummer des Anrufers, dann die gewünschten Arbeiten und alle genannten Details." |

Verwenden Sie statt `Quote` den Wert `Work Order`, wenn Anrufe direkt zu geplanten Arbeiten führen sollen.

### Neuen Kunden hinzufügen

| Feld                | Wert                                                                                                                                                     |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `create_servicem8_client`                                                                                                                                |
| **Beschreibung**    | "Fügen Sie den Anrufer als neuen Kunden hinzu, wenn er sagt, dass er uns noch nicht genutzt hat."                                                        |
| **Methode**         | POST                                                                                                                                                     |
| **URL**             | `https://api.servicem8.com/api_1.0/company.json`                                                                                                         |
| **Request-Headers** | `X-Api-Key`: Ihr API-Schlüssel                                                                                                                           |
| **Body-Parameter**  | `name` (String, erforderlich): "Vollständiger Name des Anrufers oder Firmenname."  `address` (String): "Adresse des Kunden einschließlich Postleitzahl." |

Wählen Sie bei jedem Tool **Aktivieren** und [testen Sie Ihre Rezeption](/docs/de/reception-ai/receptionist/testing), indem Sie nach einem Angebot fragen. Das neue Angebot wird in ServiceM8 angezeigt.

## Einschränkungen

* ServiceM8 antwortet auf beide Tools nur mit `OK`. Die ID des neuen Datensatzes befindet sich in einem Response-Header, den Ihre Rezeption nicht lesen kann. Daher kann sie den Auftrag nicht mit dem Kunden verknüpfen. Ihr Team verknüpft sie in ServiceM8.
* ServiceM8 speichert Telefonnummern und E-Mail-Adressen in den Kontakten eines Kunden, einem separaten Datensatz, den das Kundentool nicht erstellen kann. Stattdessen enthält die Auftragsbeschreibung die Nummer des Anrufers.
* Die Suche nach einem bestehenden Kunden erfordert einen `$filter`-Parameter. Da Parameternamen von Webhook-Tools kein `$` enthalten dürfen, kann Ihre Rezeption Anrufer nicht suchen.

Um verknüpfte Kunden und Aufträge zu erstellen, verwenden Sie die Aktionen **Create Client** und **Create Job** von ServiceM8 über [Zapier](/docs/de/reception-ai/integrations/zapier).

## Fehlerbehebung

| Problem                       | Prüfen Sie                                                                                                                                |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 401 von ServiceM8             | Der Header muss `X-Api-Key` heißen und einen aktuellen Schlüssel enthalten.                                                               |
| 400 wegen des Status          | `status` muss exakt `Quote`, `Work Order`, `Unsuccessful` oder `Completed` sein.                                                          |
| Der Auftrag hat keine Adresse | Stellen Sie sicher, dass die Beschreibung die Rezeption anweist, vor dem Erstellen des Auftrags nach der vollständigen Adresse zu fragen. |
| 429 von ServiceM8             | Sie haben das Anfragelimit von ServiceM8 erreicht. Warten Sie eine Minute und versuchen Sie es erneut.                                    |