ServiceM8 | ElevenLabs Documentation

Mit den folgenden Webhook-Tools 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, 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.

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.