Actions85
- Instances Actions
- Client Actions
- Message Actions
- Chat Actions
- Contact Actions
- Number Actions
- Group Actions
- Channel Actions
- Label Actions
- Story Actions
Overview
This node interacts with the WaAPI service to unpin a specific chat in a WhatsApp instance. It is useful when you want to programmatically manage pinned chats, for example, to keep your chat list organized by removing pins from chats that are no longer a priority.
A practical use case would be automating chat management in a customer support workflow where only active or important conversations remain pinned, and older or resolved chats get unpinned automatically.
Properties
| Name | Meaning |
|---|---|
| Id | The ID of the WhatsApp instance where the chat exists. This identifies which WhatsApp session to target. |
| Chat Id | The unique identifier of the chat to unpin. Format: <countrycode_short><usernumber>@c.us for individual chats or @g.us for group chats. |
Output
The node outputs JSON data representing the result of the unpin operation. Typically, this will include confirmation of success or details about the updated chat state after unpinning.
No binary data output is expected from this operation.
Dependencies
- Requires an API key credential for authenticating with the WaAPI service.
- The node sends requests to the WaAPI endpoint at
https://waapi.app/api/v1. - Proper configuration of the API key credential within n8n is necessary for successful execution.
Troubleshooting
- Invalid Chat Id format: Ensure the chat ID follows the correct pattern (
<countrycode><number>@c.usfor individuals or@g.usfor groups). Incorrect formats will cause errors. - Unauthorized / Authentication errors: Verify that the API key credential is correctly set up and has the required permissions.
- Chat not found or already unpinned: If the chat ID does not exist or is not currently pinned, the API might return an error or a no-op response.
- Network issues: Check connectivity to the WaAPI service endpoint.
Links and References
- WaAPI Official Documentation (for detailed API usage and chat management)
- WhatsApp Chat ID Formats (explains chat ID conventions)