Passer au contenu principal
Chaque requête de webhook d’intégration a la même enveloppe. L’objet data dépend de l’événement. Considérez les charges utiles comme compatibles avec les évolutions futures : ignorez les champs que vous n’utilisez pas au lieu de rejeter la requête. La livraison se fait au moins une fois et sans ordre garanti ; dédupliquez donc sur id.

Enveloppe

Les événements ne contiennent ni texte de prompt ou de réponse, ni sources citées, ni adresses email, ni noms de personnes, ni identifiants Stripe. Tous les horodatages des exemples sont synthétiques.

run.completed

Un run a atteint un état final réussi, qu’il soit manuel ou planifié. brandId est le workspace du run. Les événements de run sont envoyés dès qu’un run ne peut plus changer. Tant qu’un run contient une réponse en quarantaine dont la charge utile du fournisseur peut encore être rejouée, pendant 7 jours au plus, son événement attend. Pendant ce temps, Lister les runs peut déjà indiquer le run comme terminé. Cela vaut aussi pour run.failed et run.cancelled.

run.failed

Un run a échoué, y compris par un échec de planification. brandId est le workspace du run.

run.cancelled

Un run a été annulé. brandId est le workspace du run.

pitch_audit.completed

Le rapport d’un audit de prospection est prêt. Les audits de prospection appartiennent à l’équipe ; brandId vaut donc null.

pitch_audit.failed

Un audit de prospection a échoué définitivement. brandId vaut null.

site_audit.completed

Toutes les pages d’un audit de pages sont terminées. brandId est le workspace de l’audit.

prompt_suggestions.ready

Une génération de Prompt Studio s’est terminée. brandId est le workspace de la génération. recommendations est la valeur que Obtenir une génération de suggestions renvoyait pour ce run au moment de l’enregistrement de l’événement. Une lecture ultérieure du run peut différer, car les prompts suivis, les concurrents et les générations plus récentes la font évoluer. Elle vaut null quand le run ne correspond à aucune recommandation : une préparation profile, un pool qui n’est plus le dernier pool utilisable, ou un topic supprimé. Seuls les runs de Prompt Studio des clients produisent ces événements, pas les outils publics de génération de prospects.

prompt_suggestions.failed

Une génération de Prompt Studio a échoué. brandId est le workspace de la génération.

webhook.test

Envoyé uniquement par Envoyer un événement de test, à un seul endpoint, même s’il est désactivé. brandId vaut null.