Actions33
- Mini Program Actions
- WeChat Pay Actions
- Official Account Actions
- WeChat Work Actions
Overview
This node operation creates a QR code for a WeChat Official Account. It generates a temporary QR code linked to a specific scene string, which can be used in various marketing or user engagement scenarios within the WeChat ecosystem. For example, businesses can create QR codes that encode campaign identifiers or user-specific data, allowing users to scan and interact with the Official Account in a targeted way.
Practical uses include:
- Generating promotional QR codes that expire after a set time.
- Creating event-specific QR codes for tracking user engagement.
- Providing temporary access links or coupons via QR codes.
Properties
| Name | Meaning |
|---|---|
| Scene String | The unique string parameter embedded in the QR code representing the scene or context. |
| Expire Seconds | The duration in seconds before the QR code expires (default is 604800 seconds = 7 days). |
Output
The output JSON contains the response from the WeChat API for creating the QR code. This typically includes information such as the ticket for the QR code, its URL, and expiration details. The exact structure depends on the WeChat API response but generally provides all necessary data to retrieve or display the QR code image.
If binary data were involved (e.g., the actual QR code image), it would be indicated, but in this case, the node returns JSON metadata about the QR code.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy or helper for WeChat API calls.
- The node internally uses a WeChat API helper class to perform authenticated requests to WeChat's Official Account endpoints.
- Proper configuration of credentials providing access tokens or API keys for WeChat Official Account integration is necessary.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
- Unsupported Operation Error: If the operation name is incorrect or not supported, ensure the operation is set exactly to "Create QR Code" under the Official Account resource.
- Expired or Invalid Scene String: The scene string must be valid and conform to WeChat's requirements; otherwise, the API may reject the request.
- Expiration Time Issues: Setting an expiration time too short or too long might cause unexpected behavior; use sensible defaults like 7 days (604800 seconds).