Połącz Microsoft Teams: przewodnik krok po kroku
Publikuje podsumowanie uruchomienia na kanale Teams, a przy NEXUS_TEAMS_NOTIFY=true także osobną wiadomość dla każdego nieudanego testu. Ten przewodnik prowadzi od zera do zweryfikowanego połączenia i opisuje możliwe błędy wraz z ich przyczynami i sposobami naprawy.
Ostatnia aktualizacja:
Chroń swoje dane uwierzytelniające. Nigdy nie wklejaj tokenu, klucza, hasła ani adresu URL webhooka na czacie. Wprowadzaj je wyłącznie w Studio → Ustawienia → Integracje, gdzie są zapisywane w pliku .env obszaru roboczego i wyświetlane jako kropki. Dotyczy to również asystenta AI: może przeprowadzić Cię przez ten przewodnik, ale nigdy nie potrzebuje Twojego tokenu.
Czego potrzebujesz
- Kanał Teams, do którego możesz dodać przepływ pracy.
- Jeden adres URL webhooka Workflows dla tego kanału.
Uzyskaj dane uwierzytelniające
- W Teams otwórz menu ··· kanału → Przepływy pracy i dodaj "Opublikuj w kanale po otrzymaniu żądania elementu webhook".
- Skopiuj podany adres URL elementu webhook. Kończy się on na logic.azure.com (starsze łączniki: webhook.office.com). Sam adres URL jest poufnym kluczem.
- Zachowaj go w schowku. Nie wklejaj go nigdzie poza Studio (następny krok).
Połącz w Studio
- W Studio otwórz Ustawienia → Integracje → Microsoft Teams.
- Wklej adres URL webhooka i naciśnij Zapisz & wyślij test. Wiadomość testowa trafi na kanał.
- Włącz
TEAMS_ENABLED. Aby otrzymywać jedną wiadomość dla każdego nieudanego testu, włącz teżNEXUS_TEAMS_NOTIFY.
Sprawdź, czy działa
- Po wybraniu Wyślij wiadomość testową pojawi się odpowiedź "Wysłano.", a wiadomość pojawi się na kanale.
- Uruchom dowolny test. Podsumowanie uruchomienia trafi na kanał.
Typowe błędy
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| "Brak webhooka" | Pole TEAMS_WEBHOOK_URL jest puste. | Wklej adres URL webhooka w Ustawienia → Integracje i zapisz. |
"TEAMS_WEBHOOK_URL nie jest adresem elementu webhook Teams" | Wartość nie jest adresem URL https w domenie logic.azure.com ani webhook.office.com. | Skopiuj ponownie adres URL z wyzwalacza przepływu pracy "Opublikuj w kanale po otrzymaniu żądania elementu webhook". |
| Odpowiedź HTTP 4xx lub 5xx z Teams | Przepływ pracy został wyłączony lub usunięty albo jego właściciel odszedł lub utracił licencję, więc przepływ już nie działa. | Otwórz przepływ pracy w Teams (Przepływy pracy → zarządzaj), włącz go lub utwórz nowy i zapisz nowy adres URL. |
| "nie można połączyć się z Teams (ENOTFOUND)" lub "brak odpowiedzi w ciągu 20 s" | Ten komputer nie może połączyć się z Microsoft: przyczyną jest VPN, serwer proxy lub brak sieci. | Sprawdź połączenie sieciowe na tym samym komputerze i spróbuj ponownie. |
| Test działa, ale powiadomienia o niepowodzeniach nie są publikowane | TEAMS_ENABLED ma wartość false lub włączone jest tylko podsumowanie uruchomienia: wiadomości dla poszczególnych testów wymagają NEXUS_TEAMS_NOTIFY=true. | Włącz oba przełączniki. |
Klucze ustawień
| Klucz | Co robi | Prawidłowa wartość | Jak sprawdzić |
|---|---|---|---|
TEAMS_ENABLED | Wysyłaj alerty do Microsoft Teams | true lub false | Włącz po otrzymaniu wiadomości testowej. |
TEAMS_WEBHOOK_URL | Kanał Teams do powiadomień (poufne, zapisane tylko na tym komputerze) | Adres URL https://…logic.azure.com lub …webhook.office.com | Wyślij wiadomość testową publikuje wiadomość na kanale. |
NEXUS_TEAMS_NOTIFY | Alert w Teams dla każdego nieudanego testu | true lub false | Otrzymasz osobną wiadomość dla każdego nieudanego testu, a nie tylko podsumowanie uruchomienia. |
Więcej: wszystkie integracje, przewodnik po ustawieniach, rozwiązywanie problemów. Inne przewodniki: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
Nadal masz problem? Napisz na [email protected] i podaj dokładny komunikat błędu wyświetlany w Studio. Nie dołączaj tokena.