Actions76
- Chat Actions
- Contact Actions
- Profile Actions
- LID Actions
- File Actions
- Message Actions
- Group Actions
- Create
- List
- Get
- Delete
- Join
- Get Join Info
- Leave
- Get Picture
- Set Picture
- Delete Picture
- Update Subject
- Update Description
- Get Security Info Admin Only
- Set Security Info Admin Only
- Get Security Messages Admin Only
- Set Security Messages Admin Only
- Get Participants
- Add Participant
- Remove Participant
- Promote Admin
- Demote Admin
- Status Actions
- Channel Actions
- Poll Actions
Overview
This node enables interaction with the Wappfy API to manage WhatsApp-related resources, including channels. Specifically, the Channel - Search by Text operation allows users to search public channels by a text query. This is useful for discovering channels relevant to specific topics or interests based on textual content.
Common scenarios include:
- Finding WhatsApp channels related to particular keywords or themes.
- Filtering channels by categories or countries to narrow down search results.
- Paginating through large sets of channel search results using cursors.
For example, a user might search for channels containing the word "technology" and filter results to channels in the US and UK, retrieving paginated results to process them in batches.
Properties
| Name | Meaning |
|---|---|
| Search Text | The text string to search for within public channels. |
| Countries | Optional comma-separated list of country codes to filter the search results by location. |
| Categories | Optional comma-separated list of categories to filter the search results by topic. |
| Start Cursor | Optional cursor string used for pagination to continue fetching subsequent pages of results. |
Output
The node outputs an array of JSON objects representing the search results from the Wappfy API. Each item corresponds to a channel matching the search criteria. The exact structure depends on the API response but typically includes channel details such as ID, name, description, and other metadata.
No binary data output is produced by this operation.
Dependencies
Requires an active Wappfy API credential with:
- Base URL of the Wappfy API instance.
- Instance name identifier.
- API key for authentication.
The node makes HTTP requests to the Wappfy API endpoints.
Proper configuration of the Wappfy API credentials in n8n is necessary.
Troubleshooting
Empty or no results returned:
Ensure the search text is correctly specified and not empty. Check if the optional filters (countries, categories) are valid and correspond to existing values.Invalid API credentials or authentication errors:
Verify that the API key and instance name are correctly configured in the credentials. Confirm that the API key has sufficient permissions.Pagination issues:
If using the start cursor for pagination, ensure the cursor value is obtained from a previous search result and is valid.Network or connectivity errors:
Confirm that the base URL is reachable from the n8n environment and there are no firewall restrictions.API rate limits or quota exceeded:
Check the Wappfy API usage limits and adjust request frequency accordingly.
Links and References
- Wappfy API Documentation (Assumed official docs URL; replace with actual if known)
- n8n Documentation: Creating Custom Nodes
- General info on WhatsApp Channels and API usage can be found on WhatsApp Business API resources.