Actions21
Overview
The DinastiAPI AI node enables sending and managing WhatsApp messages and related data through the DinastiAPI service. It supports a wide range of WhatsApp operations such as sending text, images, documents, audio, video, locations, contacts, stickers, interactive buttons, lists, polls, links, and status updates. Additionally, it can retrieve information like session status, group lists, user info, avatars, business profiles, and verify user existence.
This node is particularly useful for automating WhatsApp communication workflows in business or AI-driven environments, where programmatic control over messaging and user data retrieval is needed. For example, it can be used to send personalized notifications, broadcast multimedia content, gather feedback via polls, or monitor WhatsApp session health.
Properties
| Name | Meaning |
|---|---|
| Optimize Response | Whether to optimize the API response to reduce token usage and improve AI processing. |
| Max Response Length | Maximum number of characters in the response; longer responses will be truncated. |
| Include Only Essential Fields | Whether to include only essential fields in the response to reduce noise. |
| Response Format | How to format the response for optimal AI agent understanding. Options: - Optimized: Clean, structured response optimized for AI processing - Raw: Complete raw response from the API - Summary: Brief summary with key information only |
Note: The above properties are shown when the node is used as a tool (@tool is true).
Output
- The node outputs JSON data representing the result of the selected WhatsApp operation.
- For message sending operations, the output contains confirmation and metadata about the sent message.
- For retrieval operations (e.g., getStatus, listGroups, getUserInfo), the output includes the requested data structured according to the API response.
- When "Optimize Response" is enabled, the output may be truncated or filtered to include only essential data for easier AI consumption, with metadata indicating optimization and truncation details.
- For the "getAvatar" operation, if configured to save as binary, the avatar image is downloaded and included as binary data with MIME type and filename in the output.
- Binary data outputs (images, audio, video, documents, stickers) are handled internally and can be provided as base64-encoded buffers or URLs depending on input configuration.
Dependencies
- Requires an API key credential for authenticating with the DinastiAPI WhatsApp service.
- Uses HTTP requests to communicate with DinastiAPI endpoints.
- Relies on n8n's binary data handling capabilities for media files.
- No additional external dependencies beyond the DinastiAPI service and standard n8n environment.
Troubleshooting
- Binary Property Not Found: If a binary property specified for media input (image, audio, video, document, sticker) is missing, the node throws an error indicating the missing property name. Ensure the previous node provides the correct binary data under the expected property name.
- Unknown Operation Error: If an unsupported operation is selected, the node throws an "Unknown operation" error. Verify that the operation name is valid and supported by the node.
- API Request Failures: Network issues or invalid credentials can cause request failures. Check API key validity and network connectivity.
- Response Optimization Issues: When enabling response optimization, large datasets are truncated to the first 10 items. This may omit some data; disable optimization if full data is required.
- Avatar Download Errors: For the "getAvatar" operation, if no avatar URL is found or the user has no avatar, the output will contain an error message. Confirm the target identifier is correct and the user has an avatar set.
Links and References
- DinastiAPI GitHub Repository - Official documentation and source code for the DinastiAPI WhatsApp service.