Chiffrage et réservation pour agents IA

Le parcours de réservation

1. Décrire l’intervention. Adresse précise, destination pour un transport, type et état du véhicule, accès, date et heure souhaitées. Préciser l’option batterie ou les dimensions du pneu si nécessaire.
2. Obtenir une estimation. Le moteur de l’application calcule le prix TTC, son détail, l’acompte et le solde. Le devis reste utilisable au maximum 15 minutes, et jusqu’à l’heure demandée si elle arrive avant.
3. Autoriser la réservation. L’assistant doit disposer de votre accord sur la prestation, les coordonnées transmises et les conditions de réservation avant de créer la demande.
4. Régler l’acompte. Ouvrir le lien Stripe renvoyé. La création du lien ne constitue pas un paiement. Le solde est réglé au dépanneur.
5. Suivre la prise en charge. Le suivi distingue l’acompte payé et l’attribution d’un dépanneur. Un paiement ne garantit pas, à lui seul, un horaire d’arrivée.

Choisir la prestation à chiffrer

• Batterie : utiliser battery et choisir recharge_diagnostic, remplacement_standard ou remplacement_start_stop. Les trois options utilisent les mêmes prix que le formulaire de l’application. La compatibilité et le stock restent à confirmer pour un remplacement.
• Pneu crevé : utiliser flat_tire avec les dimensions du pneu. tireServiceType: repair_or_spare correspond au dépannage du pneu existant ou au montage de la roue de secours, selon faisabilité. Pour la fourniture et la pose d’un pneu neuf, envoyer replacement : l’API oriente vers le dispatch pour vérifier le stock et établir le prix complet. Ne pas présenter un forfait de dépannage comme le prix d’un pneu neuf posé.
• Ouverture de porte : utiliser locked_door. Le client doit pouvoir justifier son droit d’accès au véhicule ; le professionnel vérifie la faisabilité.
• Remorquage et convoyage : utiliser towing ou vehicle_delivery avec une destination précise. Proposer uniquement les formules renvoyées par le devis et leurs conditions de délai.

Présenter au client les précisions serviceNotes renvoyées avec le devis avant de recueillir son accord.

Informations à présenter avant l’accord du client

Récapituler la prestation, les adresses, la date souhaitée, la formule choisie, son estimation TTC, l’acompte et le solde renvoyés par l’API. L’acompte est déduit du montant de l’intervention ; le solde se règle au dépanneur. La disponibilité, la compatibilité des pièces et l’horaire restent à confirmer par notre équipe.

Recueillir l’accord du client pour transmettre son nom, son téléphone, son adresse e-mail et son immatriculation afin de créer cette demande. Le client règle l’acompte sur Stripe. Toute demande de modification, d’annulation ou de remboursement est traitée avec notre équipe. L’assistant doit présenter les conditions commerciales applicables au client avant de déclarer termsAccepted: true.

Pour les développeurs d’agents

L’API HTTP est ouverte à tous les agents capables d’effectuer des requêtes web, sans compte, clé API ni validation manuelle de notre équipe. Aucun en-tête Authorization n’est nécessaire. Les agents peuvent directement demander un devis, créer une demande autorisée par le client et consulter son suivi.

Des limites automatiques protègent le service : par adresse IP et par minute, 10 devis, 10 appels de réservation et 60 consultations du suivi. En cas de réponse 429, attendre le délai Retry-After puis reprendre la même demande. Les anciennes clés partenaires restent compatibles pour leurs réservations existantes.

Avant l’intégration, vérifier la configuration publiée par l’application. Elle doit être complétée par une vérification du déploiement et des accès aux services.

• Contrat OpenAPI 3.1 de l’application
• Index JSON du parcours
• Guide texte des services et sources

Pour réserver, transmettre le quoteId, une option renvoyée par le devis, les coordonnées du client et son autorisation. Conserver le même en-tête Idempotency-Key et les mêmes paramètres après une erreur réseau. Les montants sont exprimés en centimes d’euro TTC. Ne jamais fournir un prix calculé par l’assistant.

Les identifiants quoteId et bookingId, les liens de paiement et les références de suivi sont confidentiels : leur possession permet d’accéder à la ressource correspondante. Ne pas les publier ni les inclure dans des pages indexables. L’API ne reçoit aucune donnée de carte bancaire.

Les situations qui demandent notre équipe

Incident sur autoroute, poids lourd, véhicule bloqué nécessitant une évaluation sur place, adresse ambiguë ou prestation hors périmètre : l’API renvoie une demande de traitement manuel. Le convoyage exige un véhicule roulant. Les délais du transport groupé doivent être acceptés avant de choisir cette formule.

Les tarifs figurant dans les articles sont indicatifs. Seul le chiffrage réalisé pour votre intervention permet de préparer sa réservation.

Informations légales · Assistance et conditions commerciales · 06 51 65 78 10