WAHA

Connect with Whatsapp HTTP API

Actions116

Overview

This node performs a search operation on channels based on a text query. It is useful for scenarios where you want to find channels matching specific keywords or phrases, filtered by categories, with control over pagination and result limits. For example, it can be used to search for news channels mentioning a particular topic or to find channels related to certain categories within a session context.

Use Case Examples

  1. Search for channels mentioning 'Donald Trump' within specified categories, limiting results to 50 per request.
  2. Paginate through search results using the start cursor to fetch subsequent batches of channels.

Properties

Name Meaning
Session The session name to use for the search context.
Text The text query to search for in channels.
Categories The categories to filter the search results by, provided as a JSON array.
Limit The maximum number of search results to return.
Start Cursor The cursor to start the search from, used for pagination.
Request Options Additional request options such as batching, SSL handling, proxy, and timeout settings.

Output

JSON

  • channels - Array of channels matching the search criteria.
  • nextCursor - Cursor for fetching the next set of results in pagination.

Dependencies

  • Requires an API key credential or session authentication to access the channel search API.

Troubleshooting

  • Ensure the session name is valid and active; invalid sessions may cause authentication errors.
  • Check that the text query and categories are correctly formatted; malformed inputs may result in empty or error responses.
  • If using batching, verify batch size and interval settings to avoid rate limiting or timeouts.
  • Proxy and SSL settings must be correctly configured to avoid connection issues.
  • Timeout errors may occur if the server is slow or unresponsive; consider increasing the timeout value.

Discussion