ServiceM8 | ElevenLabs Documentation

Grâce aux outils webhook ci-dessous, votre réceptionniste peut créer un devis ou une intervention dans ServiceM8 lorsqu’un appelant a besoin d’une prestation, et ajouter de nouveaux appelants comme clients.

Avant de commencer

Dans ServiceM8, ouvrez Settings → API Keys et créez une clé. Chaque outil ci-dessous l’envoie dans l’en-tête de requête X-Api-Key. Toute personne disposant de cette clé peut lire et modifier vos données ServiceM8. Ne la conservez donc pas dans des documents partagés.

Créer les outils

Pour chaque outil, accédez à Integrations, sélectionnez Add integration, choisissez Webhook Tool, puis définissez Assign to agents sur Receptionist.

Créer une intervention

Champ	Valeur
Nom	`create_servicem8_job`
Description	”Créez une intervention lorsqu’un appelant a besoin d’une prestation ou souhaite un devis.”
Méthode	POST
URL	`https://api.servicem8.com/api_1.0/job.json`
En-têtes de requête	`X-Api-Key` : votre clé API
Paramètres du corps	`status` (chaîne, obligatoire) : “Toujours la valeur exacte `Quote`.” `job_address` (chaîne, obligatoire) : “L’adresse complète où la prestation est nécessaire, code postal inclus.” `job_description` (chaîne, obligatoire) : “Le nom et le numéro de téléphone de l’appelant, puis ce qu’il souhaite faire réaliser et les informations qu’il a fournies.”

Utilisez Work Order au lieu de Quote si les appels doivent être directement transformés en interventions planifiées.

Ajouter un nouveau client

Champ	Valeur
Nom	`create_servicem8_client`
Description	”Ajoutez l’appelant comme nouveau client lorsqu’il indique n’avoir jamais fait appel à nous.”
Méthode	POST
URL	`https://api.servicem8.com/api_1.0/company.json`
En-têtes de requête	`X-Api-Key` : votre clé API
Paramètres du corps	`name` (chaîne, obligatoire) : “Le nom complet de l’appelant ou le nom de son entreprise.” `address` (chaîne) : “L’adresse du client, code postal inclus.”

Sélectionnez Enable pour chaque outil, puis testez votre réceptionniste en demandant un devis. Le nouveau devis apparaît dans ServiceM8.

Limites

ServiceM8 répond aux deux outils uniquement par OK. L’ID du nouvel enregistrement se trouve dans un en-tête de réponse que votre réceptionniste ne peut pas lire. Il ne peut donc pas lier l’intervention au client. Votre équipe les associe dans ServiceM8.
ServiceM8 enregistre les numéros de téléphone et les emails dans les contacts d’un client, un enregistrement distinct que l’outil client ne peut pas créer. La description de l’intervention contient donc le numéro de l’appelant.
La recherche d’un client existant nécessite un paramètre $filter, et les noms de paramètres des outils webhook ne peuvent pas contenir $. Votre réceptionniste ne peut donc pas rechercher les appelants.

Pour créer des clients et des interventions liés, utilisez les actions Create Client et Create Job de ServiceM8 via Zapier.

Résolution des problèmes

Problème	Vérification à effectuer
401 de ServiceM8	L’en-tête doit s’appeler `X-Api-Key` et contenir une clé actuelle.
400 concernant le statut	`status` doit être exactement `Quote`, `Work Order`, `Unsuccessful` ou `Completed`.
L’intervention n’a pas d’adresse	Indiquez dans la description que le réceptionniste doit demander l’adresse complète avant de créer l’intervention.
429 de ServiceM8	Vous avez atteint la limite de requêtes de ServiceM8. Attendez une minute, puis réessayez.