FieldPulse | ElevenLabs Documentation

Grâce aux outils webhook 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 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.

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

Ajoutez une procédure 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.