Automatisation & intégrations
Recevez les résultats par webhook signé, et intégrez vos rapports dans n'importe quelle page.
Abonnez votre application agent aux événements de tool-run pour recevoir des webhooks signés (HMAC-SHA256), et publiez vos rapports en iframe avec un contrôle précis des domaines autorisés.
Événements : tool_run.completed, tool_run.failed, tool_run.progress, webhook.test.
Chaque livraison est signée (en-tête X-CVAI-Signature) pour vérifier l'authenticité.
Intégration de rapports par iframe, avec liste de domaines autorisés par rapport.
Idéal pour : Les équipes qui automatisent leurs flux qualité et veulent afficher les rapports sur leurs propres sites.
Mise en route
Suivez ces étapes pour être opérationnel.
Configurez un webhook
Dans le tableau de bord développeur, ouvrez votre application agent et réglez l'URL de webhook. Un webhookSecret (hex 32 octets) est généré pour signer les livraisons. (Ce réglage se gère depuis le tableau de bord connecté.)
# Set your webhook URL on your agent app:
# https://communityvision.ai/dashboard/developer
#
# A webhookSecret (32-byte hex) is generated for you
# to verify the X-CVAI-Signature on each delivery.Recevez et vérifiez la livraison
Chaque POST porte X-CVAI-Event et X-CVAI-Signature (sha256=HMAC du corps brut). Recalculez le HMAC avec votre secret avant de faire confiance au payload.
import crypto from 'node:crypto';
function verify(rawBody, signatureHeader, secret) {
const expected =
'sha256=' +
crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
return crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(signatureHeader),
);
}Gérez le payload
Le corps contient l'événement, le tool-run, le statut, la sortie structurée, un résumé lisible et l'URL du rapport.
{
"event": "tool_run.completed",
"toolRunId": 12345,
"toolKey": "epistemic-quality-audit",
"status": "completed",
"structuredOutput": { "score": 85, "claims": [] },
"humanSummary": "Analysis complete with high confidence...",
"reportUrl": "https://communityvision.ai/reports/your-slug",
"usageCost": 0.05,
"completedAt": "2026-06-08T10:00:00Z"
}Intégrez un rapport en iframe
Publiez le rapport en public ou non répertorié avec l'intégration activée, listez les domaines autorisés, puis collez l'iframe. Les rapports non répertoriés exigent un token dans l'URL.
<iframe
src="https://communityvision.ai/reports/your-slug/embed"
width="100%"
height="600"
style="border:none;"
allow="clipboard-write">
</iframe>Ressources utiles
Autres surfaces
CVAI vous rejoint partout où vous travaillez. Explorez les autres intégrations.
Auditez specs et plans en une seule commande, depuis votre terminal.
Une clé pour tout : applications agent, API REST v1 et serveur MCP natif.
Auditez la spec ouverte dans l'éditeur et voyez les problèmes en soulignés inline.
Bloquez les PR sur un audit de qualité des specs et plans qu'elles touchent.
Mentionnez @CVAI dans un canal pour auditer un document, directement dans Slack.
Auditez n'importe quelle page en un clic, ou laissez les navigateurs IA appeler les outils CVAI dans la page.
Un bundle de tokens, assets et specs pour construire l'app mobile sans dérive de design.
Automatisation & intégrations — questions fréquentes
Comment recevoir automatiquement les résultats CVAI ?
Définissez une URL de webhook sur votre app d'agent dans le tableau de bord développeur. CVAI envoie alors des livraisons signées (HMAC-SHA256) pour des événements comme tool_run.completed, tool_run.failed et tool_run.progress ; vérifiez l'en-tête X-CVAI-Signature avec votre webhookSecret avant de faire confiance à la charge utile.
Puis-je intégrer un rapport CVAI sur mon propre site ?
Oui. Publiez le rapport en mode public ou non répertorié avec l'intégration activée, listez les domaines autorisés, puis collez l'iframe pointant vers /reports/votre-slug/embed. Les rapports non répertoriés nécessitent un token dans l'URL.