Actions64
- Mensagem Actions
- Grupo Actions
- Chat Actions
- Perfil Actions
- Evento Actions
- Integração Actions
- Instancia Actions
Overview
The "Buscar Grupos" operation of the "Grupo" (Group) resource in this custom n8n node allows users to search for WhatsApp groups using different methods. It is designed to interact with the Evolution API, enabling workflows that need to retrieve group information by invite code, group ID, or fetch all available groups. This node is particularly useful for automating group management tasks, such as listing group details, verifying group existence, or obtaining participant lists for further processing.
Practical examples:
- Retrieve detailed information about a specific WhatsApp group using its invite code.
- Fetch all groups associated with an instance and optionally get their participants.
- Look up a group by its unique group ID for validation or reporting purposes.
Properties
| Display Name | Type | Description |
|---|---|---|
| Nome Da Instância | String | Digite o nome da instância. The name of the WhatsApp instance to use for the API call. |
| Método De Busca | Options | Escolha o método para buscar os grupos. Select how you want to search for groups: - Por Código De Convite (By Invite Code) - Por ID Do Grupo (By Group ID) - Buscar Todos Os Grupos (Fetch All Groups) |
| Código Do Convite | String | Código do convite do grupo (ex: JZNHJLvnNd04UvGefiEZAA). Required if searching by invite code. |
| ID Do Grupo | String | ID do grupo para buscar informações. Required if searching by group ID. |
| Obter Participantes | Boolean | Se deve obter a lista de participantes dos grupos. If enabled when fetching all groups, includes participant lists. |
Output
The output is a JSON array where each item represents a group or group information retrieved according to the selected search method. The structure may include:
- Group Details: Such as group ID, name, and other metadata.
- Participants List: If "Obter Participantes" is enabled and "Buscar Todos Os Grupos" is selected, each group object may include a list of participants.
Note: The exact fields depend on the Evolution API's response, but typically include identifiers, names, and possibly arrays of participant objects.
Dependencies
- External Service: Requires access to the Evolution API.
- API Key/Credentials: Needs valid "evolutionApi" credentials configured in n8n.
- n8n Configuration: No special environment variables are required beyond standard credential setup.
Troubleshooting
Common Issues:
- Missing or Invalid Credentials: Ensure the "evolutionApi" credentials are correctly set up in n8n.
- Unsupported Operation Error: If you see an error like
Operação não suportada., it means the chosen combination of resource and operation is not implemented. Double-check your selections. - Required Field Missing: If you select a search method but do not provide the required field (e.g., "Código Do Convite" or "ID Do Grupo"), the node will fail. Make sure all necessary properties are filled based on your search method.
Error Messages:
"Operação não suportada."
Resolution: Check that you have selected a supported resource-operation combination.- API errors from Evolution API (e.g., invalid instance name, group not found) will be passed through; check the message for guidance.