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

# ServiceTitan

Votre réceptionniste peut rechercher les appelants dans ServiceTitan, envoyer les nouvelles demandes sous forme de réservation pour vérification par vos standardistes et indiquer aux clients existants la date de leur prochain rendez-vous. L'API de ServiceTitan échange un ID et un secret client contre des jetons de courte durée, et nécessite également une clé d'application, ce que les outils webhook ne peuvent pas faire. Reception se connecte donc via [Zapier](/docs/fr/reception-ai/integrations/zapier).

## Avant de commencer

L'intégration Zapier de ServiceTitan est en bêta ouverte et ServiceTitan la fournit telle quelle. Pour la connecter :

1. Un administrateur ServiceTitan envoie le formulaire d'inscription Zapier de ServiceTitan. ServiceTitan vous contacte ensuite pour vous indiquer les prochaines étapes.
2. Dans ServiceTitan, accédez à **Settings** → **Integrations** → **API Application Access**, sélectionnez **Connect New App**, puis choisissez **Zapier 3.0.X**.
3. Vérifiez les portées, choisissez une option **Booking Provider**, puis sélectionnez **Allow Access**.
4. Générez un secret client et copiez-le, avec l'ID client et votre ID de locataire.

> **Warning**
>
> Le secret client donne accès à vos données ServiceTitan. Conservez-le en lieu sûr et ne le partagez pas.

## Configuration

### Connecter Zapier

Si ce n'est pas déjà fait, connectez [Zapier](/docs/fr/reception-ai/integrations/zapier) dans Reception.ai.

### Ajouter les actions ServiceTitan

Dans votre serveur MCP Zapier sur [mcp.zapier.com](https://mcp.zapier.com), ajoutez les [actions ci-dessous](#actions) depuis l'application **ServiceTitan (3.0.X)**. Pour vous connecter, saisissez votre ID de locataire, votre ID client et votre secret client, puis choisissez l'environnement de production. Pour chaque champ, définissez une valeur fixe ou laissez l'IA le renseigner, comme indiqué.

### Attribuer les outils

Dans Reception.ai, ouvrez l'onglet **Outils** de l'intégration Zapier, sélectionnez **Actualiser les outils**, puis attribuez chaque action au **Client** (réceptionniste).

### Tester

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en vous faisant passer pour un nouvel appelant ayant besoin d'une réparation. La réservation apparaît dans ServiceTitan pour vérification par votre équipe.

## Actions

### Rechercher l'appelant

| Champ                       | Valeur                                           |
| --------------------------- | ------------------------------------------------ |
| **Action Zapier**           | **Search Customers**                             |
| **Définir dans Zapier**     | Rien.                                            |
| **Laisser l'IA renseigner** | **Phone** (le numéro de l'appelant) ou **Name**. |
| **Attribuer à**             | **Client**                                       |

### Envoyer une réservation

Une réservation est le moyen le plus sûr d'envoyer une nouvelle demande. Vos standardistes la vérifient dans ServiceTitan et la transforment en intervention. Votre réceptionniste ne réserve ainsi jamais directement dans votre planning de répartition.

| Champ                       | Valeur                                                                                                                                                                                                                  |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Action Zapier**           | **Create Booking**                                                                                                                                                                                                      |
| **Définir dans Zapier**     | **Booking Provider**, **Source** (par exemple, `Reception`) et, éventuellement, **Business Unit**, **Job Type** et **Campaign**.                                                                                        |
| **Laisser l'IA renseigner** | **Name**, **Summary** (le problème, le numéro de téléphone de l'appelant et ses disponibilités), **Is First Time Client**, l'adresse de l'intervention, **Start** (l'horaire préféré de l'appelant) et **External Id**. |
| **Attribuer à**             | **Client**                                                                                                                                                                                                              |

**External Id** doit être unique pour chaque réservation. Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) demandant à votre réceptionniste d'utiliser le numéro de téléphone de l'appelant suivi de la date et de l'heure actuelles.

### Vérifier les rendez-vous d'un client

| Champ                       | Valeur                                         |
| --------------------------- | ---------------------------------------------- |
| **Action Zapier**           | **Search Appointments**                        |
| **Définir dans Zapier**     | Rien.                                          |
| **Laisser l'IA renseigner** | **Customer Id**, issu de **Search Customers**. |
| **Attribuer à**             | **Client**                                     |

## Limites

* L'application ServiceTitan de Zapier ne peut pas vérifier la capacité ni la disponibilité des techniciens. L'heure figurant sur une réservation correspond donc à la préférence de l'appelant, et non à un créneau confirmé.
* **Create Job** et **Create Appointment** nécessitent les ID du lieu, de l'unité opérationnelle, du type d'intervention et de la campagne, et réservent directement dans votre planning. Laissez ces actions à vos standardistes.
* L'intégration est en bêta ouverte et ServiceTitan ne la prend pas officiellement en charge.
* Chaque action exécutée par votre réceptionniste utilise des tâches de votre forfait Zapier. Zapier compte actuellement deux tâches par appel réussi, les appels échoués ne sont pas comptabilisés. Lorsque le forfait est épuisé, les actions s'arrêtent jusqu'à sa réinitialisation.

## Résolution des problèmes

| Problème                                                 | Vérification à effectuer                                                                                                              |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Une action ServiceTitan n'apparaît pas dans Reception.ai | Sélectionnez **Actualiser les outils** dans l'intégration Zapier après avoir ajouté des actions dans Zapier.                          |
| Une action affiche **Modifié** et n'est pas utilisée     | Vous l'avez modifiée dans Zapier. Sélectionnez **Mettre à jour** dans l'onglet **Outils**.                                            |
| Zapier ne peut pas se connecter à ServiceTitan           | Vérifiez que votre inscription a été approuvée et que vous avez utilisé un ID et un secret client 3.0.X, et non une ancienne clé API. |
| Erreur `UniqueConstraint` sur une réservation            | **External Id** reprend une réservation antérieure. Vérifiez qu'il contient la date et l'heure.                                       |
| Les clients connus ne sont pas trouvés                   | Essayez le nom de l'appelant en plus de son numéro de téléphone.                                                                      |