Loading...
Loading...
DingTalk contacts precise lookup. Use when you already have a userId and need details, department, position, or email; reverse look up a user by full mobile number; or query yourself, department members and roles. Fuzzy name search, employee ID, responsibility, and supervisor/subordinate queries go through dingtalk-aisearch; after obtaining the userId, use this skill to supplement details. Command prefix: dws contact.
npx skill4agent add dingtalk-real-ai/dingtalk-workspace-cli dingtalk-contactCRITICAL — Before executing anyoperation, MUST use the Read tool to fully readdws. This lightweight file contains the global execution contract, safety bottom line, and on-demand loading navigation for shared references; do not preload all its references.dingtalk-shared
<!-- VISIBLE_SHORTCUTS_START -->Command reference: contact.md; playbook: 08-directory.md.
dws schema --cli-path "contact +<shortcut>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f jsonresult--jq '{cli_path,outcomes:.result.outcomes,pagination}'data_schemaunknown flagunknown command--compactdws shortcut list --service contact --format json| Shortcut | Risk | Applicable scenario |
|---|---|---|
| read | Look up a person's full profile by mobile number (auto-resolves userId and fetches details) |
| read | List department members by department name (auto-resolves deptId) |
| read | View department members (current dept only, excluding sub-departments) |
| read | Get current user's special follow list |
| read | Query member list under a role |
| read | View sub-departments of specified department |
| read | Look up a person's full profile by name (auto-resolves userId and fetches details) |
| read | View my own contact profile (name/userId/mobile/dept/org, clean projection) |
| read | Look up details of the department a person belongs to by name (auto-resolves userId and deptId) |
| read | Search department by name and resolve unique deptId (read-only) |
| read | Search contacts by mobile number |
| read | Search contacts by keyword |
| read | List members of a person's department by name (auto-resolves userId and deptId) |
| User says | Command |
|---|---|
| "Look up my own info" | |
| "Look up details by userId" | |
| "Reverse look up user by full mobile number" | |
| "Pull members by department name" | |
| "Search departments" | |
| "Department member list" | |
| "List enterprise roles / what roles exist" | |
| "Get role ID by role name" | |
| "Check members under a role" | |
When the following intents are matched, you MUST follow the corresponding SOP sequence; it is forbidden to skip steps, replace commands, or fabricate userIds. Every command must include. Fuzzy name search, employee number, responsibility, and supervisor/subordinate queries use--format json; exact reverse lookup by full mobile number uses contact; after obtaining userId, contact supplements details.dingtalk-aisearch
dws aisearch person --query "<keyword>" --dimension <dimension> --format jsonnamejobNumberphonedutydepartmentsupervisorsubordinateuserIdtitledws contact user get --ids <id1,id2,...> --format jsondws contact user get --ids <userId> --format jsoncontact user searchsearch-mobiledws contact user search-mobile --mobile "<full mobile number>" --format jsonuserIddws contact user get --ids <userId> --format jsondws aisearch person --query "<name>" --dimension name --format jsonuserIddws contact user get --ids <userId> --format jsonorgEmployeeModelcontact user searchdws contact user get-self --format jsonorgEmployeeModel.userIdorgUserNamedepts[].deptNamedws contact dept search --query "<department name>" --format jsondws contact dept list-children --dept <parent deptId> --format jsondws contact dept list-members --ids <deptId>[,<deptId2>...] --format jsondws contact dept get-info --dept <deptId> --format jsondws contact label listdws contact label get --names "<role name>"dws contact label list-members --id <labelId>deptId=-1list-childrenlist-membersget-infodeptId=1contact user get --idssupervisorsubordinatedingtalk-aisearchcontact dept listdws contactdws aisearchUSER.mddws contact user get-self --format jsonme/self/currentuserIduser getdws aisearch persondws contact user search-mobile --mobile "<mobile>" --format jsonuserIddws contact user get --ids <userId> --format jsoncontact user getdws aisearch person --query "<full name or employee number>" --dimension supervisor --format jsoncontact user get --ids id1,id2,... --format jsoncontact label list/get/list-membersdept list-membersdingtalk-aisearchdws contact user search-mobiledingtalk-maildingtalk-chat