Prüfmeldungen in Teams und Slack

RateLoop sendet Prüfungsanfragen und Freigabemeldungen an einen Teams- oder Slack-Kanal. Erstellen Sie dort den Kanal-Endpunkt und fügen Sie seine URL unter Agenten → Freigaben → Meldungen in RateLoop hinzu.

Was die Karte enthält

Jede Karte zeigt Workspace, Gegenstandskennung, Status und einen Link zu RateLoop. Alle im Kanal können sie sehen. Namen und Notizen der Prüfenden sowie Nachweise bleiben durch RateLoop-Zugriffsrechte geschützt.

Microsoft Teams

Verwenden Sie für eine neue Kanalintegration Workflows als Power-Automate-App in Teams.

1. Öffnen Sie in Teams den gewünschten Kanal und wählen Sie … → Workflows.
2. Wählen Sie die Vorlage „Beim Empfang einer Webhookanforderung in einem Kanal posten“.
3. Setzen Sie Wer kann den Flow auslösen? auf Jeder. RateLoop bezieht oder sendet kein Microsoft-Entra-Bearer-Token; mandantenbeschränkte Auslösemodi werden daher nicht unterstützt.
4. Bestätigen Sie Team und Kanal und erstellen Sie den Ablauf.
5. Kopieren Sie die vollständige HTTP-POST-URL. Aktuelle gehostete Flows verwenden *.environment.api.powerplatform.com und einen /direct/cu/-Pfad. Unveränderte ältere Flows können weiterhin *.logic.azure.com verwenden. RateLoop akzeptiert keinen anderen Teams-Host.
6. Fügen Sie die vollständige URL in RateLoop ein, einschließlich alles nach dem Fragezeichen. Dort steht die Signatur; ohne sie weist der Ablauf jede Anforderung ab.

RateLoop sendet eine Adaptive Card 1.5 in dem Anlagenumschlag, den die Aktion „In Kanal posten“ erwartet.

Grenzen in Teams

Die Karte erscheint als „Flow bot“, nicht als RateLoop.

Der Flow bestimmt Absendername und Symbol. Für RateLoop-Branding ist eine Teams-App mit registriertem Bot nötig.

Der Ablauf gehört der Person, die ihn erstellt hat.

Wenn diese Person ausscheidet oder ihre Lizenz verliert, enden die Meldungen. Verwenden Sie ein Dienstkonto oder fügen Sie Mitbesitzende hinzu.

Die Limits hängen vom Flow ab.

Power Automate legt Limits nach Leistungsprofil und Connector-Aktion fest. RateLoop wiederholt fehlgeschlagene Zustellungen; prüfen Sie den Flow-Verlauf, wenn Meldungen ausbleiben.

28 KB pro Karte.

RateLoop entfernt optionale Angaben, damit der Prüfungslink zugestellt werden kann.

Slack

1. Legen Sie unter api.slack.com/apps eine App im gewünschten Workspace an oder öffnen Sie eine vorhandene.
2. Aktivieren Sie Incoming Webhooks und wählen Sie Add New Webhook to Workspace.
3. Bestätigen Sie den Zielkanal.
4. Kopieren Sie die URL https://hooks.slack.com/services/… und fügen Sie sie in RateLoop ein.

Slack erhält dieselben Prüfungsangaben und denselben Link. RateLoop lehnt eine Ziel-URL für den falschen Anbieter ab.

In RateLoop antworten

Die Karte führt zur zugewiesenen Prüfung. Go, Revise und Stop werden in RateLoop beantwortet. Dort bleiben andere Antworten für Prüfende verborgen und ihre Begründungen werden mit dem Ergebnis erfasst.

Die URL ist das Zugangsmittel

Die vollständige URL ist das Zugangsmittel. Teams prüft die SAS-Signatur in der Abfragezeichenfolge, Slack die geheime Incoming-Webhook-URL. Keiner der Anbieter prüft zusätzlich einen RateLoop-HMAC über die Nutzlast. Wer die URL kennt, kann in diesen Kanal posten.

• RateLoop speichert die URL verschlüsselt und gibt sie nie wieder aus. Oberfläche und API zeigen ausschließlich den Host — https://hooks.slack.comzum Beispiel.
• Teilen Sie die URL nicht in Tickets, Wikis oder E-Mails.
• Wenn die URL bekannt wird, löschen Sie den Teams-Flow oder Slack-Webhook und erstellen Sie einen neuen. Das Entfernen des Kanals in RateLoop widerruft die URL nicht.
• Das Ziel wird genauso geprüft wie ein Webhook-Endpunkt: HTTPS ist Pflicht, es darf nicht auf eine private oder lokale Adresse auflösen, und RateLoop verbindet sich mit der bereits aufgelösten Adresse, statt beim Verbindungsaufbau erneut aufzulösen — ein Wechsel der Namensauflösung kann eine Nachricht daher nicht umleiten.
• RateLoop signiert Kanalzustellungen nicht mit einem HMAC. Verwenden Sie einen Webhook für nachprüfbare Zustellung.

Zustellung und Wiederholung

Prüfereignisse werden zuerst gespeichert und anschließend von einem Wartungsprozess in Kanalzustellungen überführt. Deshalb kann es einige Minuten dauern, bis ein neues Ereignis erscheint. Ist der Kanal nicht erreichbar, versucht RateLoop die Zustellung bis zu achtmal mit wachsenden Abständen — zuerst nach 30 Sekunden, dann jeweils doppelt so lange bis zu einer Stunde — und beendet danach die Versuche. Die Nachweise in RateLoop bleiben in jedem Fall unberührt: Eine fehlgeschlagene Chat-Zustellung ändert weder die Prüfung noch die Freigabe.

Jede Anforderung trägt den Kopfzeilenwert rateloop-delivery-id . Ein Ablauf, der doppelte Nachrichten ausschließen möchte, kann darauf entduplizieren.

Lesen Sie die Webhook-Referenz für den signierten, maschinenlesbaren Weg, oder Menschliche Aufsicht dazu, wie eine Prüfung beantwortet wird.

Anbieterreferenzen: Microsoft-Teams-Connector und Workflows-Format · Slack-Incoming-Webhooks