Actions90
- Sessions Actions
- Messages - Sending Actions
- Chats Actions
- Messages - Actions Actions
- Groups Actions
- List Groups
- Group Info
- Get Invite Link
- Revoke Invite Link
- Join via Link
- Preview via Link
- Create Group
- Delete Group
- Update Group Description
- Toggle Announcement Mode
- List Participants
- Add Participants
- Remove Participants
- Demote Participants
- Approve Join Request
- Reject Join Request
- List Join Requests
- Get Group Picture
- Set Group Picture
- Delete Group Picture
- Leave Group
- Update Group Name
- Lock Group Edits
- Promote Participants
- Profile Actions
- Server Actions
- Miscellaneous Actions
Overview
This node operation lists chats from a specified WhatsApp session using the WARest WhatsApp REST API. It allows users to retrieve chat information with options to filter, sort, and paginate the results. This is useful for scenarios where you want to monitor or analyze chat activity, such as fetching recent chats, filtering chats with media, or sorting by unread count or last message time.
Use Case Examples
- Retrieve the last 10 chats from a specific WhatsApp session.
- List chats that contain media only, sorted by the last message in descending order.
- Search chats by a specific text filter and paginate results with offset and limit.
Properties
| Name | Meaning |
|---|---|
| Session | Identifier of the WhatsApp session to list chats from. Can be selected from a list or entered manually. |
| Additional Fields | Optional parameters to control the listing of chats, including limit, offset, filtering by media presence, sorting criteria, sort order, and text search filter. |
Output
JSON
json- Array of chat objects returned by the WARest API, each representing a chat with its details such as chat ID, name, last message, unread count, and other metadata.
Dependencies
- Requires an API key credential for the WARest WhatsApp REST API and the base URL of the API server.
Troubleshooting
- Ensure the session ID is valid and active; otherwise, the API call will fail.
- Check that the API key credential is correctly configured and has the necessary permissions.
- If no chats are returned, verify the filter and pagination parameters to ensure they match existing data.
- Common error messages include 'Operation not implemented' if the operation name is incorrect, or HTTP errors from the API if the session or parameters are invalid.
Links
- WARest WhatsApp REST API Documentation - Official documentation for the WARest API used by this node to interact with WhatsApp sessions and chats.