Actions21
Overview
The "Send Buttons" operation of the DinastiAPI AI node allows sending interactive WhatsApp messages containing clickable buttons. This feature is useful for engaging users with quick response options or menu selections directly within a chat. For example, businesses can use it to present customers with choices like "Confirm Order," "Request Support," or "View Catalog" as buttons, simplifying user interaction and improving response rates.
This operation fits scenarios where you want to prompt users to take specific actions without typing responses, such as customer support workflows, surveys, or guided navigation through services.
Properties
| Name | Meaning |
|---|---|
| Recipient | The target recipient's identifier. Can be a phone number in international format, a group ID (ending with @g.us), a newsletter ID (@newsletter), or a LID (@lid). |
| Message | The main text message body that accompanies the buttons. |
| Additional Options | A collection of optional settings: |
| - Message ID | Custom identifier for the message; if not provided, one is auto-generated. |
| - Presence Simulation | Simulates typing or recording indicator for a specified duration (0-30000 ms). Shows typing for text/documents and recording for audio/video. |
| - Message Duration | Sets WhatsApp disappearing message duration in seconds. Options include no expiration, 24 hours, 7 days, or 90 days. |
| - Context Information | Provides context metadata such as marking the message as forwarded, replying to a specific message, mentioning all group members, or mentioning specific users by their JIDs. |
Output
The node outputs a JSON object representing the API response from the DinastiAPI service after attempting to send the button message. This typically includes status information about the sent message, any generated message IDs, and error details if applicable.
No binary data output is associated with this operation.
Dependencies
- Requires an active connection to the DinastiAPI WhatsApp messaging service.
- Requires configuration of an API key credential for authentication with DinastiAPI.
- The node uses HTTP requests to DinastiAPI endpoints to perform operations.
Troubleshooting
- Binary Property Not Found: Although not applicable for "Send Buttons," other operations may throw errors if expected binary data is missing. Ensure the binary property name matches the input data.
- Invalid Recipient Format: The recipient must be correctly formatted as a phone number or valid group/newsletter/LID ID. Incorrect formats will cause API errors.
- Context Information Errors: When using reply or mention features, ensure required fields like participant JID are provided; otherwise, the message may fail.
- API Request Failures: Network issues or invalid API credentials will result in errors. Verify API key validity and network connectivity.
- Message ID Conflicts: Providing a custom message ID that duplicates an existing one might cause errors; omit this field to let the system auto-generate unique IDs.
Links and References
- DinastiAPI GitHub Repository – Official documentation and source code for the DinastiAPI service.