Evolution API icon

Evolution API

Interact with Evolution API

Overview

The "Encontrar Participantes" operation for the "Grupo" (Group) resource in this custom n8n node allows users to retrieve the list of participants from a specified group using the Evolution API. This is particularly useful for automating workflows that require information about group members, such as sending notifications, managing access, or synchronizing group data with other systems.

Practical examples:

  • Fetching all members of a WhatsApp group to send personalized messages.
  • Auditing group membership for compliance or reporting purposes.
  • Integrating group participant lists into CRM or marketing tools.

Properties

Display Name Type Description
Nome Da Instância String Digite o nome da instância (Enter the instance name). Required.
ID Do Grupo String ID do grupo para buscar os participantes (Group ID to fetch participants from). Required.

Output

The output will be a JSON array where each item represents a participant of the specified group. The exact structure of each participant object depends on the Evolution API's response, but typically includes fields such as participant ID, name, and possibly status or role within the group.

[
  {
    "participantId": "string",
    "name": "string",
    // ...other participant details
  }
]

Note: The actual field names may vary based on the Evolution API.

Dependencies

  • External Service: Requires access to the Evolution API.
  • API Key/Credentials: You must configure valid Evolution API credentials in n8n under the credential type evolutionApi.
  • n8n Configuration: No additional configuration required beyond setting up the credentials.

Troubleshooting

  • Common Issues:

    • Missing or Invalid Credentials: Ensure that the Evolution API credentials are correctly configured in n8n.
    • Incorrect Group ID: If the provided group ID does not exist or is incorrect, the API may return an error or an empty list.
    • Unsupported Operation Error: If you see an error like "Operação não suportada," it means the selected operation is not implemented for the chosen resource.
  • Error Messages:

    • "Operação não suportada."
      Resolution: Double-check that you have selected a valid operation for the resource.
    • API errors returned from Evolution API (such as authentication failures or invalid parameters) will be passed through and should be checked against the Evolution API documentation.

Links and References

Discussion