Actions37
- Instance Actions
- Message Actions
- Group Actions
- Contact Actions
- Chat Actions
- Campaign Actions
- Chatbot Actions
Overview
This node integrates with the UazAPI service to manage WhatsApp chats and perform various chat-related operations. Specifically, for the Chat - Pin operation, it allows users to pin or unpin a chat by specifying the chat number and whether to pin or unpin it.
Common scenarios where this node is beneficial include:
- Prioritizing important conversations by pinning them at the top of the chat list.
- Unpinning chats that are no longer a priority.
- Automating chat management workflows in customer support or sales automation systems.
For example, a user can automate pinning a VIP customer's chat when a new message arrives, ensuring quick access for agents.
Properties
| Name | Meaning |
|---|---|
| Chat Number | The phone number of the chat to be pinned or unpinned (including country code, no "+"). |
| Pin | Whether to pin (true) or unpin (false) the specified chat. |
Output
The node outputs a JSON object containing the response from the UazAPI after attempting to pin or unpin the chat. This typically includes status information about the operation's success or failure.
Example output structure:
{
"success": true,
"message": "Chat pinned successfully",
"data": {
"number": "5511999999999",
"pinned": true
}
}
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the UazAPI service.
- Requires valid API credentials configured in n8n for authenticating requests to UazAPI.
- The base URL for the API is taken from the credential configuration.
- The node uses HTTP POST requests to the
/chat/pinendpoint of the UazAPI.
Troubleshooting
Common issues:
- Invalid or missing chat number format may cause the API to reject the request.
- Incorrect or expired API credentials will result in authentication errors.
- Network connectivity issues can prevent successful communication with the UazAPI.
Error messages:
- Authentication errors usually indicate invalid API keys; verify and update credentials.
- Validation errors from the API may indicate missing required parameters or incorrect data formats.
- If the chat number does not exist or is not recognized by WhatsApp, the API might return an error indicating the chat was not found.
Resolution tips:
- Ensure the chat number includes the country code without any "+" sign.
- Confirm that the API credentials are correctly set up and have necessary permissions.
- Check network connectivity and firewall settings if requests fail to reach the API.
Links and References
- UazAPI Documentation (for detailed API endpoints and usage)
- WhatsApp official guidelines on chat pinning (for understanding chat behavior)