Overview
This node provides administrative operations for managing users and global settings in the DinastiAPI WhatsApp API system. It allows you to create users, delete users (partially or fully), list all users, retrieve global configuration and statistics, reload global configurations, send test events, and test global systems.
A common use case is automating user management tasks such as adding new users with specific configurations or removing users from the system. It can also be used to monitor and manage the overall system state by fetching stats or reloading configurations dynamically.
For example, you might use this node to:
- Create a new WhatsApp API user with custom webhook URLs and event subscriptions.
- Delete a user when they no longer need access.
- Send a test event globally to verify system integrations.
- Retrieve current global system statistics for monitoring purposes.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform. Options include: Create User, Delete User, Delete User Full, Get Global Configuration, Get Global Stats, List Users, Reload Global Config, Send Global Test Event, Test Global Systems. |
| User ID | ID of the user to delete (required for Delete User and Delete User Full operations). |
Additional properties relevant only for "Create User" operation (not requested but shown for context):
- User Name: Name of the user to create.
- User Token: Authentication token for the user.
- Additional Options: Collection of optional settings including webhook URL, subscribed events, expiration timestamp, skip flags for various message types, call rejection settings, proxy configuration, S3 storage settings, and RabbitMQ messaging configuration.
Output
The node outputs JSON data representing the result of the performed operation:
- For user listing, it returns an array of user objects.
- For user creation, it returns the created user's details.
- For deletion operations, it returns confirmation or status of the deletion.
- For global stats and configuration retrieval, it returns the respective data structures.
- For sending test events or testing systems, it returns the response from those actions.
- In case of errors, the output contains an error message object.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the DinastiAPI Admin API.
- The node makes HTTP requests to the DinastiAPI server using the provided admin token and base URL.
- No additional external dependencies are required beyond the configured API credentials.
Troubleshooting
- Invalid User ID: If the user ID provided for deletion does not exist or is malformed, the API may return an error. Verify the user ID format and existence.
- Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
- Invalid JSON in Test Data: When sending a global test event, the "Test Data" property must be valid JSON. Invalid JSON will cause an error.
- Network Issues: Connectivity problems to the DinastiAPI server will cause request failures.
- Missing Required Parameters: Operations like deleting a user require the User ID parameter; missing these will cause errors.
To resolve errors, check the error messages returned in the output and verify input parameters and credentials.
Links and References
- DinastiAPI WhatsApp API Documentation (example placeholder link)
- n8n HTTP Request Node documentation for understanding underlying HTTP calls: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/