Connecter un webhook

Regardez d'abord

Ce qu'il vous faut

• Une adresse qui accepte un POST avec du JSON, commençant par https://. La plupart des outils d'automatisation vous en fournissent une (voir Exemples).
• Des droits d'administrateur dans votre espace de travail UAT Studio.

Connectez votre webhook

2

Ajoutez le webhook dans UAT Studio

Ouvrez votre espace de travail, cliquez sur Connections, choisissez Webhook sous Add a connection et cliquez sur Add. Renseignez ensuite :

• Webhook address : l'adresse de l'étape 1.
• Send automatically :
  • Only when I click Send on an issue (par défaut) : un administrateur décide quelles anomalies sont envoyées.
  • Every new issue and every status change, by itself : tout est envoyé immédiatement.

Cliquez sur Save settings. Le choix sous Send automatically est enregistré dès que vous le modifiez.

{ "event": "test", "message": "Test message from UAT Studio" }

Quand il envoie

Une anomalie fusionnée dans une autre comme doublon n'envoie pas de nouveau issue.created.

Ce qu'il envoie

Un POST avec Content-Type: application/json. Tous les événements d'anomalie ont la même forme :

{
  "event": "issue.status_changed",
  "project": { "id": "6b1f…", "name": "CRM UAT" },
  "issue": {
    "id": "a41c…",
    "key": "ISS-012",
    "title": "Save button greyed out",
    "description": "After changing the phone number, Save stays grey.",
    "severity": "High",
    "priority": "High",
    "status": "Ready for retest",
    "assignee": "Dev team",
    "ticket": "PORTAL-41",
    "ticket_url": "https://acme.atlassian.net/browse/PORTAL-41"
  },
  "test_case": { "num": 4, "title": "Edit a contact", "step": 3 },
  "reported_by": "Tess Tester",
  "from": "In progress",
  "to": "Ready for retest",
  "url": "https://app.uat.studio/p/6b1f…/issues"
}

Les champs peuvent être null et nous pourrons ajouter des champs plus tard : faites donc ignorer par votre flux ce qu'il ne connaît pas. Les captures d'écran et les fichiers ne sont jamais envoyés ; ils restent dans UAT Studio.

Construire la partie réceptrice

Power Automate

1. Créez un Instant cloud flow avec le déclencheur When an HTTP request is received, pour Anyone.
2. Sous Request Body JSON Schema, cliquez sur Use sample payload to generate schema et collez l'exemple ci-dessus.
3. Ajoutez une Condition sur event (par exemple : n'est pas égal à test), puis les actions souhaitées : une tâche Planner, une ligne dans Excel, un email, un élément dans SharePoint.
4. Enregistrez le flux. Le déclencheur affiche maintenant l'HTTP URL : c'est l'adresse du webhook.

Remarque : le déclencheur HTTP est un connecteur premium dans Power Automate. Pour publier dans un canal Teams, vous n'en avez pas besoin : utilisez la connexion Microsoft Teams.

Zapier

Créez un Zap avec le déclencheur Webhooks by Zapier › Catch Hook, copiez l'adresse, cliquez sur Test connection dans UAT Studio puis envoyez une anomalie, pour que Zapier apprenne les champs. Ajoutez ensuite l'action souhaitée, par exemple un message dans Slack.

Make

Démarrez un scénario avec Webhooks › Custom webhook, copiez l'adresse et cliquez sur Redetermine data structure avant d'envoyer une anomalie depuis UAT Studio.

Votre propre service

Acceptez un POST avec du JSON, comparez l'en-tête Authorization à votre secret, répondez 200 rapidement et faites le travail lent ensuite. Les messages ne sont pas renvoyés après un échec : journalisez donc ce que vous recevez.

En cas de problème

Toujours bloqué ? Écrivez à [email protected] avec le message que vous voyez. Ne nous envoyez jamais le secret lui-même.

Ce qui sort d'UAT Studio

• Les messages sont envoyés uniquement via HTTPS.
• Ils contiennent le texte de l'anomalie, le test et le nom du testeur, jamais de fichiers ni de captures d'écran. Envoyez-les uniquement à un service auquel votre organisation confie ces informations.
• Le secret est stocké chiffré (AES-256), la clé étant conservée à part de la base de données. Personne ne peut le relire.
• Passez la connexion sur Off ou supprimez-la, et plus rien n'est envoyé.