Połączenie z webhookiem

Najpierw obejrzyj

Co będzie potrzebne

• Adres przyjmujący POST z JSON, zaczynający się od https://. Większość narzędzi do automatyzacji go udostępnia (zob. Przykłady).
• Uprawnienia administratora w przestrzeni roboczej UAT Studio.

Połączenie z webhookiem

2

Dodanie webhooka w UAT Studio

Otworzyć przestrzeń roboczą, kliknąć Connections, wybrać Webhook w Add a connection i kliknąć Add. Następnie uzupełnić:

• Webhook address: adres z kroku 1.
• Send automatically:
  • Only when I click Send on an issue (domyślnie): administrator decyduje, które zgłoszenia są wysyłane.
  • Every new issue and every status change, by itself: wszystko jest wysyłane od razu.

Kliknąć Save settings. Wybór w Send automatically zapisuje się od razu po zmianie.

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

Kiedy wysyła

Zgłoszenie scalone z innym jako duplikat nie wysyła nowego issue.created.

Co wysyła

POST z Content-Type: application/json. Wszystkie zdarzenia zgłoszeń mają tę samą postać:

{
  "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"
}

Pola mogą mieć wartość null, a w przyszłości możemy dodać nowe pola, dlatego przepływ powinien ignorować to, czego nie zna. Zrzuty ekranu i pliki nigdy nie są wysyłane; pozostają w UAT Studio.

Budowa strony odbierającej

Power Automate

1. Utworzyć Instant cloud flow z wyzwalaczem When an HTTP request is received dla Anyone.
2. W Request Body JSON Schema kliknąć Use sample payload to generate schema i wkleić powyższy przykład.
3. Dodać Condition dla event (np. is not equal to test), a potem wybrane akcje: zadanie w Planner, wiersz w Excelu, e-mail, element w SharePoint.
4. Zapisać przepływ. Wyzwalacz pokazuje teraz HTTP URL: to jest adres webhooka.

Uwaga: wyzwalacz HTTP jest w Power Automate łącznikiem premium. Do publikowania na kanale Teams nie jest potrzebny: wystarczy połączenie z Microsoft Teams.

Zapier

Utworzyć Zap z wyzwalaczem Webhooks by Zapier › Catch Hook, skopiować adres, kliknąć Test connection w UAT Studio, a potem wysłać jedno zgłoszenie, aby Zapier poznał pola. Następnie dodać wybraną akcję, np. wiadomość w Slacku.

Make

Rozpocząć scenariusz od Webhooks › Custom webhook, skopiować adres i kliknąć Redetermine data structure przed wysłaniem zgłoszenia z UAT Studio.

Własna usługa

Usługa powinna przyjmować POST z JSON, sprawdzać nagłówek Authorization z sekretem, szybko odpowiadać 200 i dopiero potem wykonywać czasochłonne operacje. Po błędzie wiadomości nie są wysyłane ponownie, dlatego warto rejestrować to, co przychodzi.

Gdy coś pójdzie nie tak

Nadal nie działa? Prosimy napisać na [email protected] i podać widoczny komunikat. Prosimy nigdy nie wysyłać nam samego sekretu.

Co opuszcza UAT Studio

• Wiadomości są wysyłane wyłącznie przez HTTPS.
• Zawierają treść zgłoszenia, test i nazwisko testera, nigdy pliki ani zrzuty ekranu. Należy wysyłać je tylko do usługi, której organizacja powierza takie informacje.
• Sekret jest przechowywany w postaci zaszyfrowanej (AES-256), a klucz oddzielnie od bazy danych. Nikt nie może go odczytać.
• Po przełączeniu połączenia na Off lub jego usunięciu nic nie jest już wysyłane.