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

# Workiz

Ihr Empfang kann einen Anrufer als neuen Lead mit Kontaktdaten, Serviceadresse und Anliegen zu Workiz hinzufügen. So kann Ihr Team nachfassen und die Arbeit einplanen. Die Workiz-API erwartet ihr Secret im Request-Body, wo Webhook-Tools es der KI offenlegen würden. Daher verbindet sich Reception über [Zapier](/docs/de/reception-ai/integrations/zapier).

Die Workiz-App von Zapier kann Leads und Jobs erstellen, aber keine Kunden suchen oder Ihren Zeitplan prüfen.

## Bevor Sie beginnen

Zapier verbindet sich mit Workiz über Ihr API-Token und API-Secret. Dafür benötigen Sie das Developer-API-Add-on:

1. Wählen Sie in Workiz in der Navigationsleiste **Feature Center**.
2. Wählen Sie unter **Add-ons** die Option **Developer API** und aktivieren Sie den Schalter.
3. Öffnen Sie die Seite **Developer** und kopieren Sie Ihr API-Token und API-Secret. Zapier fragt nach beiden, wenn Sie Workiz verbinden.

Wenn Sie **Feature Center** oder die Seite **Developer** nicht sehen, bitten Sie Ihren Kontoadministrator, die Berechtigung **Account Settings** für Ihren Nutzertyp unter **Roles & Permissions** zu aktivieren.

> **Warning**
>
> Das API-Token und das Secret ermöglichen Zugriff auf Ihr Workiz-Konto. Bewahren Sie sie sicher
> auf und geben Sie sie nicht weiter.

## Einrichtung

### Zapier verbinden

Falls noch nicht geschehen, verbinden Sie [Zapier](/docs/de/reception-ai/integrations/zapier) in Reception.ai.

### Workiz-Aktion hinzufügen

Fügen Sie auf Ihrem Zapier-MCP-Server unter [mcp.zapier.com](https://mcp.zapier.com) die Workiz-Aktion **Create Lead** hinzu und verbinden Sie Ihr Konto. Die Felder von Zapier stehen nicht in derselben Reihenfolge wie auf der Workiz-Seite **Developer**. Fügen Sie Token und Secret daher in die passenden Felder ein.

| Feld                   | Wert                                                                                                                                                                 |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zapier action**      | **Create Lead**                                                                                                                                                      |
| **Set in Zapier**      | Die Jobquelle, zum Beispiel `Reception`. Sie muss bereits als Anzeigenquelle in Workiz existieren.                                                                   |
| **Let the AI fill in** | Vor- und Nachname, Telefon, E-Mail, Serviceadresse und Lead-Notizen: was der Anrufer benötigt, wann er verfügbar ist und alles Weitere, das er Ihnen mitgeteilt hat. |
| **Assign to**          | **Client**                                                                                                                                                           |

### Tool zuweisen

Öffnen Sie in Reception.ai den Tab **Tools** der Zapier-Integration, wählen Sie **Refresh tools** und weisen Sie **Create Lead** dem **Client** (Empfang) zu.

### Testen

[Testen Sie Ihren Empfang](/docs/de/reception-ai/receptionist/testing) als neuer Anrufer, der eine Reparatur benötigt. Der Lead erscheint mit Ihrer Jobquelle in Workiz.

> **Tip**
>
> Fügen Sie eine [Prozedur](/docs/de/reception-ai/receptionist/rules-and-procedures) hinzu, die Ihrem Empfang vorgibt,
> vor dem Erstellen des Leads nach der vollständigen Adresse einschließlich Postleitzahl und nach einer
> zehnstelligen Telefonnummer zu fragen.

## Einschränkungen

* Ihr Empfang kann bestehende Kunden nicht finden. Daher kann ein wiederkehrender Anrufer als neuer Lead hinzugefügt werden. Filtern Sie in Workiz nach Ihrer Jobquelle, um neue Leads zu prüfen.
* Die Workiz-App von Zapier kann Ihren Zeitplan nicht prüfen. **Create Job** bucht einen Job zu einer festgelegten Zeit und benötigt einen Jobtyp. Überlassen Sie dies daher Ihrem Team, es sei denn, die Wunschtermin der Anrufer sollen direkt in Ihrem Kalender stehen.
* Jede Aktion, die Ihr Empfang 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, wird die Aktion bis zur Zurücksetzung angehalten.

## Fehlerbehebung

| Problem                                                      | Was Sie prüfen sollten                                                                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Create Lead** erscheint nicht in Reception.ai              | Wählen Sie nach dem Hinzufügen der Aktion in Zapier bei der Zapier-Integration **Refresh tools**.                                                       |
| Die Aktion zeigt **Changed** und wird nicht genutzt          | Sie haben sie in Zapier bearbeitet. Wählen Sie im Tab **Tools** die Option **Update**.                                                                  |
| Zapier meldet, dass die Authentifizierung fehlgeschlagen ist | Token und Secret befinden sich möglicherweise in den falschen Feldern oder sind nicht mehr gültig. Kopieren Sie sie erneut von der Seite **Developer**. |
| Feldvalidierungsfehler von Workiz                            | Die Jobquelle muss exakt mit einer Anzeigenquelle in Workiz übereinstimmen. Telefonnummern benötigen 10 Ziffern, Postleitzahlen 5.                      |