Actions85
- Instances Actions
- Client Actions
- Message Actions
- Chat Actions
- Contact Actions
- Number Actions
- Group Actions
- Channel Actions
- Label Actions
- Story Actions
Overview
The node provides an operation to pin a specific message in a messaging system. Pinning a message typically highlights or bookmarks it within a chat or conversation, making it easier for users to find important messages later. This operation is useful in scenarios such as team collaboration, customer support chats, or any context where certain messages need to be emphasized or retained at the top of a conversation.
For example, a user might want to pin a message containing meeting notes or critical instructions so that all participants can quickly access it without scrolling through the entire chat history.
Properties
| Name | Meaning |
|---|---|
| Id | The instance ID representing the specific environment or account context for the operation. |
| Message Id | The unique identifier of the message to be pinned. |
| Duration | Optional duration (in seconds) specifying how long the message should remain pinned. |
Output
The output contains a JSON object reflecting the result of the pin message operation. It typically includes confirmation details such as success status and possibly metadata about the pinned message. There is no indication that binary data is returned by this node.
Dependencies
- Requires an API key credential for authenticating with the external WaAPI service.
- The node interacts with the WaAPI API endpoint at
https://waapi.app/api/v1. - Proper configuration of the API authentication credentials in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or missing message ID may cause the operation to fail.
- Expired or incorrect API credentials will prevent successful communication with the API.
- Providing a non-numeric or negative duration could lead to unexpected behavior or errors.
Error messages:
- Authentication errors indicating invalid API keys require checking and updating the stored credentials.
- "Message not found" or similar errors suggest verifying the correctness of the provided message ID.
- Validation errors related to the duration parameter should be resolved by ensuring it is a positive number.
Links and References
- WaAPI Official Documentation (for detailed API usage and message operations)
- n8n Documentation on Creating Custom Nodes