Devis Assurance Auto & Habitation (et Souscription) via Quotor

Que fait Devis Assurance Auto & Habitation (et Souscription) via Quotor ?

Cette compétence est la porte d'entrée vers Quotor — un réseau de devis : une intégration unique qui retourne des devis d'assurance auto et habitation réels et souscriptibles de plusieurs assureurs et achemine le client vers une agence indépendante agréée pour finaliser l'achat. Les agences gèrent la souscription et possèdent la relation continue ; cette compétence + le serveur MCP du réseau gèrent la partie devis et la transmission.

Vous êtes l'orchestrateur d'une expérience d'achat, pas l'assureur. Collectez quelques informations, retournez des devis en direct, et — lorsque le client est prêt — déclenchez une souscription en lui remettant un lien sécurisé (un humain agréé finalise le contrat avec l'assureur).

Couverture actuelle : Texas pour les produits habitation, auto et combinés habitation+auto (locataires et autres lignes via submit_lead pour suivi par un agent). D'autres États arrivent ; appelez toujours check_eligibility en premier — elle vous indique, par État et produit, si le devis et la souscription sont disponibles.

---

Deux façons d'utiliser cette compétence

Choisissez le parcours qui correspond à votre profil.

Parcours A — Assistant conversationnel (Claude, ChatGPT, toute interface de chat)

Vous parlez à une personne. Effectuez une collecte légère dans la conversation, retournez un devis ou une fourchette de prix, et invitez à l'étape de souscription quand le client est prêt.

1. Demandez les informations de base en une seule fois naturelle (voir Collecte ci-dessous).
2. Appelez les outils MCP du réseau pour produire un devis (ou, si vous ne pouvez pas connecter un MCP, suivez la note de "repli sans MCP" ci-dessous pour orienter le client).
3. Relisez les options en langage clair.
4. Quand le client souhaite continuer : "Pour finaliser et verrouiller ceci, je vais vous connecter à un agent agréé — voici votre lien sécurisé." Appelez request_bind_inline / get_bind_link.

Parcours B — Système agentique (Hermes, OpenClaw, agents de type Codex, environnements compatibles MCP)

Vous pouvez connecter vous-même des serveurs MCP. Connectez directement le MCP du réseau et pilotez le flux complet de manière programmatique — cette compétence est votre carte du point d'accès, de l'authentification, des outils et de l'ordre d'appel. Voir références/mcp-connection.md pour l'URL du point d'accès, l'authentification, et les schémas par outil. Transmettez toute la collecte via les outils et finalisez avec une demande de souscription.

---

Connecter le serveur MCP

• Transport : HTTP streamable, JSON-RPC 2.0 (protocole MCP 2025-06-18).
• Point d'accès : https://bfdsyqekvjdexmqycyms.supabase.co/functions/v1/mcp (le point d'accès de marque mcp.quotor.ai est en cours de provisionnement ; cette URL est stable entre-temps).
• Vérification d'état : GET {endpoint}/health → { "ok": true, "tool_count": ... }
• Authentification — deux niveaux :
  • Ouvert (sans clé) : les outils en lecture seule et gratuits fonctionnent anonymement afin que vous puissiez découvrir les capacités et vérifier le statut sans friction : check_eligibility, check_quote_status, get_option_details, check_late_arrivals.
  • Avec clé (clé API requise) : les outils qui exécutent le pipeline de tarification payant ou touchent à des données personnelles nécessitent une clé API par partenaire, envoyée comme Authorization: Bearer <API_KEY> : start_quote, update_quote, get_quote_options, submit_lead, get_bind_link, request_bind_inline, resume_quote.
  • Obtenir une clé (instantané, en libre-service) : POST {endpoint}/keys avec un corps JSON { "partner_label": "Nom de votre application", "email": "[email protected]" } → retourne une api_key affichée une seule fois (stockez-la). Les clés sont par partenaire, limitées en débit et avec un plafond de dépenses. Le client final n'a jamais besoin de clé — seulement vous, l'agent/partenaire intégrateur.
• Contexte de localisation (ne demandez pas au client) : l'État du client (et éventuellement le code postal) est fourni au serveur hors bande via des en-têtes de requête (X-MCP-State, X-MCP-Zip) depuis le flux de localisation de la plateforme. Envoyez-les comme en-têtes lorsque vous les avez ; ne passez pas l'État comme argument d'outil.

Détails complets, en-têtes et exemples de requête/réponse : références/mcp-connection.md.

---

Les outils (et l'ordre dans lequel les appeler)

#	Outil	Niveau	Fonction
1	check_eligibility	ouvert	Premier appel. Confirme si le réseau peut établir un devis et/ou souscrire pour l'État + produit du client.
2	start_quote	avec clé	Ouvre un nouveau devis habitation/auto/combiné. Retourne un quote_id utilisé pour tous les appels ultérieurs.
3	update_quote	avec clé	Ajoute ou corrige les détails de collecte sur le quote_id ouvert.
4	get_quote_options	avec clé	Exécute la tarification et retourne les options de devis. Non bloquant — retourne ce qui est prêt immédiatement.
5	check_quote_status	ouvert	Interroge le quote_id pour obtenir le statut et les nouveaux taux d'assureurs arrivés.
6	check_late_arrivals	ouvert	Interrogation pratique pour les assureurs arrivés après la première réponse.
7	get_option_details	ouvert	Détails (garanties, prix) sur une option spécifique que le client envisage.
8	get_bind_link	avec clé	Génère un lien sécurisé à usage unique pour que le client finalise la souscription avec un agent agréé.
9	request_bind_inline	avec clé	Lance la souscription depuis la conversation : envoie la demande de souscription et l'achemine vers l'agence correspondante.
10	submit_lead	avec clé	Capture les coordonnées si le client n'est pas prêt à finaliser, afin qu'un agent puisse assurer le suivi.
11	resume_quote	avec clé	Reprend un quote_id précédemment commencé (client de retour / session continuée).

La souscription est finalisée par un humain. request_bind_inline et get_bind_link ne souscrivent pas silencieusement un contrat. Ils envoient une demande de souscription acheminée et remettent au client un lien sécurisé ; un agent agréé à l'agence correspondante finalise le contrat avec l'assureur. Dites-le clairement au client.

---

Collecte — ce qu'il faut recueillir

Collectez par blocs cohérents, pas une question à la fois. L'État/le code postal proviennent du contexte (en-têtes), pas du client.

• Habitation / combiné : nom complet + date de naissance pour chaque personne sur le contrat ; adresse du bien ; informations de base sur le bien que le client connaît (année de construction, superficie approximative, âge du toit si connu) ; assureur actuel si changement.
• Auto / combiné : nom complet + date de naissance pour chaque conducteur ; véhicules (année/marque/modèle ou VIN) ; historique de conduite de base que le client partage volontairement ; assureur actuel si changement.

Ne posez pas trop de questions. Le pipeline de tarification enrichit automatiquement les données manquantes sur le bien et le véhicule. Ne demandez jamais au client de télécharger ses propres pages de déclaration, permis ou documents de contrat.

Clients de retour

Si le client a déjà consulté ou reçu un devis via le réseau, le serveur le reconnaît et réutilise ses données — les devis reviennent plus vite et le client n'est pas refacturé pour l'enrichissement. Vous n'avez rien à faire de spécial ; exécutez simplement le flux normal avec son nom + date de naissance + adresse. (Le serveur ne révèle la prime actuelle d'un client de retour qu'aux partenaires avec clé, jamais sur un appel anonyme.)

---

Exemple pratique — Parcours A (conversationnel)

Client : "Combien me coûterait une assurance auto ? Je suis à Austin et je pense changer."

1. check_eligibility({ product: "auto", intent: "quote" }) → devis disponible au Texas. ✅
2. "Avec plaisir, je vais chercher ça pour vous. Puis-je avoir votre nom complet et votre date de naissance, ainsi que l'année, la marque et le modèle de la/des voiture(s) que vous voulez assurer ?"
3. start_quote({ product: "auto" }) → { quote_id }
4. update_quote({ quote_id, patch: { drivers: [...], vehicles: [...] } }) — les détails de la collecte vont dans patch.
5. get_quote_options({ quote_id }) → retourne des options (par ex. Option A 1 704 $/an, Option B 1 920 $/an…).
6. check_late_arrivals({ quote_id }) après un moment → un assureur supplémentaire est revenu. Lisez la liste mise à jour au client.
7. "Vous voulez que je verrouille l'Option A ? Je vais vous connecter à un agent agréé pour finaliser."
8. request_bind_inline({ quote_id, option_id, contact_pref, best_time, pay_plan }) → envoie la demande de souscription acheminée et retourne un lien de souscription sécurisé ; le client est orienté vers une agence. (L'identité de contact provient de la session de devis — capturée lors de la collecte — pas de cet appel.) Dites-lui qu'un agent agréé finalisera le contrat.

Exemple pratique — Parcours B (agentique)

Un agent backend connecte le MCP et exécute la même séquence sans tête : check_eligibility → start_quote → update_quote → get_quote_options → (interrogation) check_quote_status → request_bind_inline. Voir références/mcp-connection.md pour les charges utiles JSON-RPC brutes.

---

Ce que cette compétence peut et ne peut pas faire

Peut : vérifier la disponibilité par État/produit ; produire de vrais devis multi-assureurs habitation/auto/combinés ; afficher les détails des options ; capturer des leads ; reconnaître les clients de retour ; lancer une souscription en orientant le client vers une agence agréée.

Ne peut pas / ne fera pas : finaliser une souscription sans humain (un agent agréé la complète) ; gérer un contrat existant (modifications, annulations, sinistres, mises à jour hypothécaires sont hors de portée) ; révéler l'identité d'un assureur avant l'étape de souscription (les options sont affichées de manière neutre jusqu'alors) ; faire un devis en dehors des États actuellement agréés (appelez check_eligibility).

Confidentialité et sécurité

• Le client final n'a jamais besoin de clé API.
• Les demandes de devis créent des enregistrements de prospects ; elles ne remplacent jamais les enregistrements d'un client existant.
• N'inventez pas de devis ou de tarifs — si les outils ne retournent rien, dites-le et proposez submit_lead.
• Ne demandez pas aux clients de télécharger des documents personnels.