Actions50
- Account Actions
- Call Actions
- Chat Actions
- Contact Actions
- Group Actions
- Instance Actions
- Media Actions
- Message Actions
- Session Actions
- User Actions
Overview
This node integrates with the WSAPI WhatsApp API to manage WhatsApp chats programmatically. Specifically, the "Pin Chat" operation allows users to pin or unpin a chat to the top of their WhatsApp chat list. This is useful for prioritizing important conversations, ensuring they remain easily accessible.
Practical examples include:
- Pinning a frequently contacted group chat to quickly access it.
- Unpinning chats that are no longer a priority to declutter the chat list.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the WhatsApp chat. For individual contacts, this is the phone number followed by @s.whatsapp.net. For groups, it is the group ID followed by @g.us. Example: 1234567890@s.whatsapp.net (individual) or 120363123456789@g.us (group). |
| Pinned | Boolean flag indicating whether to pin (true) or unpin (false) the specified chat at the top of the chat list. |
Output
The node outputs JSON data representing the result of the pin/unpin operation on the specified chat. The exact structure depends on the WSAPI response but typically includes confirmation of the action performed and possibly updated chat metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the WSAPI WhatsApp API.
- Needs an API key credential configured in n8n to authenticate requests.
- The base URL for the WSAPI must be set in the credentials configuration.
Troubleshooting
- Invalid Chat ID: If the chat ID format is incorrect or the chat does not exist, the API may return an error. Ensure the chat ID matches the required format for individual or group chats.
- Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key is correctly configured.
- Operation Not Implemented: If the node throws an error about the operation not being implemented, ensure you have the latest version of the node and that the "Pin Chat" operation is supported.
- Network Issues: Connectivity problems with the WSAPI endpoint can cause timeouts or request failures. Check network settings and WSAPI service status.
Links and References
- WSAPI WhatsApp API Documentation (Replace with actual URL if available)
- WhatsApp Chat Identifiers Explanation (General reference)