Vue d'ensemble des webhooks
Chaque webhook que Veyra Intelligence reçoit et envoie (déclencheurs de routine, fournisseurs de chat, GitHub, e-mail, voix, plugins et réveils d'agents HTTP) et la façon dont chacun est authentifié.
Les webhooks font circuler des événements entre Veyra et d'autres systèmes sans interrogation périodique. Certains arrivent (votre système ou un fournisseur signale à Veyra qu'il s'est passé quelque chose) ; un seul part (Veyra réveille un agent qui tourne sur vos serveurs).
Entrants
| Webhook | Adresse | Authentifié par | Pour |
|---|---|---|---|
| Déclencheur de routine | POST /api/routine-triggers/public/{publicId}/fire |
Secret bearer, signature HMAC ou signature du fournisseur | Lancer une routine depuis vos systèmes, vos alertes ou votre CI. |
| Fournisseurs de chat | POST /api/chat-webhooks/{publicId}/{provider} |
La signature propre au fournisseur | Permettre à Slack, Teams, Discord, Telegram et GitHub de parler aux agents. |
| Revues de pull requests GitHub | Fournisseur de chat ou déclencheur de routine | Signature GitHub ou secret bearer | Faire relire des pull requests par des agents. |
POST /api/chat-webhooks/agentmail/{publicId} |
Signature Svix | Recevoir des e-mails dans la boîte d'un agent. | |
| Voix | POST /api/voice-webhooks/{publicId}/events et /tools |
La signature du fournisseur vocal | Les appels téléphoniques avec des agents. |
| Webhooks des plugins | POST /api/plugins/{pluginId}/webhooks/{endpointKey} |
Défini par le plugin | Transmettre des événements à un plugin. |
Tous les webhooks entrants sont envoyés à https://intelligence-api.veyra.so. La console affiche l'adresse exacte, avec son publicId, quand vous en configurez un. Gardez l'adresse privée : dans certains modes, elle fait partie du secret.
Sortants
| Webhook | Envoyé à | Pour |
|---|---|---|
| Réveils d'agents | L'URL définie dans les réglages d'exécution d'un agent HTTP | Exécuter le travail d'un agent sur vos propres serveurs. |
Règles communes à tous
- HTTPS uniquement. Le HTTP simple n'est pas accepté.
- Les signatures sont vérifiées sur le corps brut. Ne resérialisez pas le JSON entre la signature et l'envoi.
- Les charges utiles sont des données. Le contenu d'un webhook parvient aux agents marqué comme données, jamais comme instructions.
- Les relances sont sûres quand vous envoyez une clé d'idempotence stable (déclencheurs de routine) ou quand le fournisseur inclut son propre identifiant de livraison (GitHub, Svix). Les répétitions sont reconnues et ne s'exécutent pas deux fois.
- Chaque livraison est enregistrée, acceptée ou rejetée, dans le journal d'activité de l'organisation concernée.