What problem does it solve?
It eliminates polling scripts by giving agents real-time, long-connection subscriptions to personal DingTalk events such as messages, approvals, calls, and todo changes.
Core Features & Use Cases
- IM Event Listening: Monitor @mentions, messages from specific users or groups, reactions, read receipts, recalls, and group lifecycle changes via
dws event +listen-im or dws event consume.
- OA, VoIP, and Todo Events: Subscribe to seven OA approval events, VoIP call invitations, and todo create/update/delete events with role-based scoping.
- Safe Subscription Lifecycle: Ready markers, bounded consumption, dry-run stop confirmation, retry budgets, and local subscription protection prevent runaway or duplicate subscriptions.
- Use Case: An agent listens for messages mentioning the user in a specific group, then replies using the event's real
conversation_id handed off to dws chat +messages-send.
Quick Start
Ask the agent to listen for messages that @mention you by running the dingtalk-event skill's default entry dws event +listen-im --kind at-me.