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

# FieldPulse

Grâce aux [outils webhook](/docs/fr/reception-ai/integrations/webhooks) ci-dessous, votre réceptionniste peut reconnaître les appelants déjà présents dans FieldPulse, ajouter de nouveaux appelants en tant que prospects et laisser un commentaire sur le client indiquant ses besoins, afin que votre équipe puisse assurer le suivi.

## Avant de commencer

FieldPulse fournit des clés API sur demande. Contactez l'assistance FieldPulse à l'adresse [support@fieldpulse.com](mailto:support@fieldpulse.com) ou via le chat intégré à l'application, puis demandez une clé API. Chaque outil ci-dessous l'envoie dans l'en-tête de requête `x-api-key`.

> **Warning**
>
> La clé API peut lire et modifier vos données FieldPulse. Conservez-la en lieu sûr et ne la partagez pas.

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

### Trouver un appelant

| Champ                     | Valeur                                                                                                                                                          |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                   | `find_fieldpulse_customer`                                                                                                                                      |
| **Description**           | "Recherchez l'appelant dans notre liste de clients par son nom ou son numéro de téléphone. Utilisez cet outil au début d'un appel concernant une intervention." |
| **Méthode**               | GET                                                                                                                                                             |
| **URL**                   | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                        |
| **En-têtes de requête**   | `x-api-key` : votre clé API                                                                                                                                     |
| **Paramètres de requête** | `search` (chaîne, obligatoire) : "Le nom complet ou le numéro de téléphone de l'appelant."                                                                      |

### Ajouter un nouveau client

| Champ                   | Valeur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                 | `create_fieldpulse_customer`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Description**         | "Ajoutez l'appelant comme nouveau client lorsque `find_fieldpulse_customer` ne l'a pas trouvé."                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Méthode**             | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **URL**                 | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **En-têtes de requête** | `x-api-key` : votre clé API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **Paramètres du corps** | `first_name` (chaîne, obligatoire) : "Le prénom de l'appelant."  `last_name` (chaîne, obligatoire) : "Le nom de famille de l'appelant."  `phone` (chaîne, obligatoire) : "Le numéro de téléphone de l'appelant, y compris l'indicatif régional."  `email` (chaîne) : "L'adresse email de l'appelant, s'il en a fourni une."  `status` (chaîne, obligatoire) : "Toujours la valeur exacte `lead`."  `service_address_1` (chaîne) : "L'adresse où l'intervention est nécessaire."  `service_address_city` (chaîne) : "La ville de cette adresse."  `service_address_state` (chaîne) : "L'État."  `service_address_zip_code` (chaîne) : "Le code postal." |

### Enregistrer les détails de l'appel

| Champ                   | Valeur                                                                                                                                                                                                                                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                 | `add_fieldpulse_comment`                                                                                                                                                                                                                                                                                                                         |
| **Description**         | "Laissez un commentaire dans le dossier client de l'appelant indiquant ses besoins. Utilisez cet outil lorsque vous disposez de son identifiant client."                                                                                                                                                                                         |
| **Méthode**             | POST                                                                                                                                                                                                                                                                                                                                             |
| **URL**                 | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`                                                                                                                                                                                                                                                                          |
| **En-têtes de requête** | `x-api-key` : votre clé API                                                                                                                                                                                                                                                                                                                      |
| **Paramètres du corps** | `commentable_type` (chaîne, obligatoire) : "Toujours la valeur exacte `customer`."  `commentable_id` (nombre, obligatoire) : "L'identifiant du client, provenant de `find_fieldpulse_customer` ou de `create_fieldpulse_customer`."  `text` (chaîne, obligatoire) : "Les besoins de l'appelant, ses disponibilités et la manière de le joindre." |

Sélectionnez **Enable** pour chaque outil, puis [testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en vous faisant passer pour un nouvel appelant ayant besoin d'une réparation. Le client apparaît dans FieldPulse comme prospect, avec le commentaire de votre réceptionniste.

> **Tip**
>
> Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) pour les nouvelles interventions : recherchez
> l'appelant, ajoutez-le s'il n'est pas trouvé, puis enregistrez les détails de l'appel.

## Limites

* Les interventions nécessitent un type d'intervention, un statut et des informations de facturation issues de votre compte FieldPulse. Votre réceptionniste ne les crée donc pas. Votre équipe transforme le prospect en intervention.
* Votre réceptionniste ne peut pas vérifier la disponibilité des techniciens ni planifier un créneau.
* Les outils webhook ne peuvent pas envoyer de listes. Ils ne peuvent donc pas ajouter de tags ni de champs personnalisés à un client.

## Résolution des problèmes

| Problème                                 | Vérification à effectuer                                                                                                                  |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Erreur 401 de FieldPulse                 | L'en-tête doit s'appeler `x-api-key` et contenir une clé active.                                                                          |
| Erreur 400 de FieldPulse                 | Consultez la liste des erreurs dans la réponse. `status` doit être exactement `lead`, et les numéros de téléphone doivent être valides.   |
| Les appelants connus ne sont pas trouvés | FieldPulse recherche les valeurs telles qu'elles sont enregistrées. Essayez le nom de l'appelant ainsi que son numéro de téléphone.       |
| Le commentaire n'est pas ajouté          | `commentable_id` doit être l'identifiant d'un client existant. Vérifiez que l'outil de recherche ou de création a été exécuté en premier. |
| Erreur 429 de FieldPulse                 | Vous avez atteint la limite de requêtes de FieldPulse. Attendez avant de réessayer.                                                       |