Passer au contenu principal
Préparez l’audit d’un prospect depuis une conversation : l’assistant crée l’audit et prépare les prompts, vous les relisez, et vous confirmez avant toute consommation de crédits. Ce guide utilise MCP. L’API REST propose le même cycle de vie dans Créer un audit de prospection.

Avant de commencer

  • Une équipe agence sur une offre Business, Agency Business ou Enterprise active. Les outils d’écriture des audits de prospection ne sont pas disponibles autrement.
  • Un rôle de Manager ou de Propriétaire dans l’équipe agence.
  • Une connexion avec le scope write:pitch-audits pour les outils d’écriture et read:pitch-audits pour lire l’audit. Consultez Authentification OAuth.
  • Des crédits pour l’audit. L’aperçu indique le montant avant que vous confirmiez.

Étapes

1

Trouver votre équipe agence

Demandez l’identifiant de l’équipe à l’assistant. list_brands le renvoie dans l’objet team de chaque workspace. Les audits précédents renvoyés par list_pitch_audits indiquent aussi leur workspace.
2

Créer l’audit

L’assistant appelle create_pitch_audit :
Qwairy prépare les prompts et ne consomme aucun crédit à ce stade. Laissez autoStartResponses non défini : il supprime la relecture des prompts.
3

Attendre l’état de relecture

L’assistant lit l’audit avec list_pitch_audits jusqu’à ce que son statut soit AWAITING_PROMPTS, puis l’ouvre avec get_pitch_audit. Le rapport renvoie les prompts et la version de l’audit.
4

Relire et enregistrer les prompts

Lisez les prompts avec l’assistant. Retirez ou réécrivez ceux qui ne conviennent pas au prospect, puis enregistrez la liste complète avec save_pitch_audit_prompts, en passant la version lue comme expectedVersion :
L’appel remplace tout l’ensemble de prompts. Un conflit de version signifie que l’audit a changé : relisez-le.
5

Prévisualiser le coût

Demandez à l’assistant d’appeler confirm_pitch_audit avec dryRun défini sur true, ou de l’appeler sans jeton. Qwairy renvoie les crédits que l’audit consommera, d’éventuels avertissements et un confirmationToken. Rien n’a démarré.
6

Confirmer

Si le coût est acceptable, approuvez-le. L’assistant appelle de nouveau confirm_pitch_audit avec les mêmes arguments et le jeton. Le jeton est à usage unique et valable 10 minutes, et il est rejeté si les prompts ou le coût ont changé depuis l’aperçu. Votre client MCP peut aussi demander sa propre approbation.
7

Lire le rapport

Interrogez get_pitch_audit jusqu’à ce que le statut soit COMPLETED. Pour comparer un co-concurrent, réutilisez un subjectId de coCompetitors. Consultez Outils de lecture des audits de prospection. Une intégration REST peut s’abonner à pitch_audit.completed au lieu d’interroger.

Exemple de conversation

Limites

  • Relancer un audit échoué et exporter un rapport restent des actions du tableau de bord.
  • Le contenu du site du prospect peut parvenir à l’assistant via le rapport. Lisez les aperçus avant de confirmer. Consultez Sécurité.

Voir aussi