Wechat Work Node icon

Wechat Work Node

Wechat Work Node
Join our community

Actions25

Overview

This node integrates with a WeChat Work (企业微信) environment to manage organizational users. Specifically, the "用户管理" resource with the "邀请成员" operation allows inviting members to join the organization by specifying user IDs, department IDs, or tag IDs.

Common scenarios include:

  • Bulk inviting multiple users by their user IDs.
  • Inviting all users within certain departments.
  • Inviting users associated with specific tags.

Practical example:

  • A company wants to onboard new employees by sending invitations to their corporate WeChat accounts using their user IDs.
  • An HR manager invites all members of a newly created department at once by specifying the department ID list.

Properties

Name Meaning
用户ID列表 Comma-separated list of user IDs (up to 1000). Specifies individual users to invite.
部门ID列表 Comma-separated list of department IDs (up to 100). Invites all users in these departments.
标签ID列表 Comma-separated list of tag IDs (up to 100). Invites users associated with these tags.

Output

The node outputs an array of JSON objects representing the result of the invitation operation for each input item. Each output item corresponds to one input and contains either the successful response data or an error message if the invitation failed.

If errors occur and "Continue On Fail" is enabled, the output will include error details per item under an error field.

No binary data output is indicated.

Dependencies

  • Requires valid API credentials for WeChat Work, including a corporate ID and secret to obtain access tokens.
  • The node uses the WeChat Work API endpoint /cgi-bin/gettoken to authenticate.
  • Proper configuration of these credentials in n8n is necessary before use.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials causing authentication failures.
    • Exceeding limits on the number of user/department/tag IDs specified.
    • Network connectivity problems when calling WeChat Work APIs.

  • Error messages:

    • "未实现方法: 用户管理.邀请成员" — indicates the requested resource-operation combination is not implemented; check that the node supports this operation.
    • API errors returned from WeChat Work (e.g., invalid token, permission denied) will be surfaced as error messages in the output.

  • Resolutions:

    • Verify and update API credentials.
    • Ensure input lists do not exceed maximum allowed counts.
    • Enable "Continue On Fail" to process other items even if some fail.

Links and References

Discussion