> 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

Grâce aux [outils webhook](/docs/fr/reception-ai/integrations/webhooks) 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](/docs/fr/reception-ai/receptionist/testing) 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](/docs/fr/reception-ai/integrations/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.                         |