DingTalk
Der DingTalk-Kanal verwendet eine Stream-Verbindung zum Empfang von Bot-Ereignissen und Senden von Antworten. Das residente Gateway hält die Verbindung aufrecht; die normale Einrichtung benötigt daher keinen öffentlichen eingehenden Webhook.
Voraussetzungen
- eine DingTalk-Anwendung mit Bot-Fähigkeit;
- aktiviertes Stream-Bot-Nachrichtenabonnement;
- Client-ID und Client-Geheimnis; und
- optionale Bot-Benutzer-ID, Bot-Staff-ID oder Robot Code, sofern die App-Identität sie erfordert.
Verwenden Sie beim Konfigurieren die aktuelle DingTalk-Stream-SDK-Dokumentation.
Im Dashboard verbinden
- Öffnen Sie Dashboard → Kanal → Hinzufügen.
- Wählen Sie DingTalk; der Standardeintrag verwendet Stream.
- Geben Sie Client-ID und Client-Geheimnis ein.
- Ergänzen Sie optionale Bot-Identitätsfelder nur passend zur konfigurierten Anwendung.
- Speichern Sie Zugangsdaten; verwenden Sie den CLI-Assistenten für DM-/Gruppenrichtlinien.
- Bestätigen Sie das Stream-Bot-Nachrichtenabonnement in DingTalk.
Die Standard-Konto-ID ist work.
Zugriffsrichtlinien
Direktnachrichten verwenden standardmäßig pairing; unterstützt sind pairing, open, allowlist und disabled. Gruppen verwenden standardmäßig mention; möglich sind auch open, allowlist oder disabled.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Bearbeiten Sie Richtlinien mit anyy setup channel im interaktiven Terminal und wählen Sie DingTalk. Dashboard bietet diese Eingaben nicht, und die aktuelle Einrichtung hat keinen DingTalk-Listeneditor. Siehe Nachrichtenplattformen. Testen Sie Gruppen zuerst mit expliziter Bot-Erwähnung.
Die Verbindung prüfen
anyy channel doctor dingtalk
anyy channel reload
Senden Sie nach Neuladen eine Direktnachricht und eine Gruppennachricht mit Erwähnung. Prüfen Sie jeden Richtlinienweg unabhängig.
Stream-Zustellung hängt von der aktiven Gateway-Verbindung ab. Stoppen Nachrichten nach Neustart oder Netzwerkänderung, prüfen Sie vor DingTalk-App-Änderungen den Gateway-Status.
Fehlerbehebung
| Problem | Prüfung |
|---|---|
| Stream verbindet nie | Client-ID/-Geheimnis, ausgehender Netzzugriff und Stream-Abonnement |
| Direktnachricht ignoriert | DM-Richtlinie und Kopplung/Zulassungsliste |
| Gruppennachricht ignoriert | Gruppenrichtlinie und explizite Erwähnung |
| Empfang funktioniert, Antwort scheitert | Bot-Identitätsfelder und DingTalk-Anwendungsberechtigungen |
| Verbindung bricht wiederholt ab | Gateway-Zustand, Netzwerkstabilität, dann Kanal-Neuladen |