Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node interacts with the Evolution API to create groups within a specified instance. It is designed to facilitate group management by allowing users to programmatically create new groups, specify their names, descriptions, and add participants via phone numbers. This is particularly useful in scenarios where automated or bulk group creation is needed, such as onboarding new teams, organizing contacts for campaigns, or managing communication channels dynamically.

For example, a user can create a group named "Marketing Team" in a given instance and add multiple participants by providing their phone numbers separated by commas.

Properties

Name Meaning
Nome Da Instância The name of the instance where the group will be created.
Nome Do Grupo The name of the group to be created.
Descrição Optional description of the group.
Participantes Comma-separated list of participant phone numbers (e.g., 5511999999999,5511888888888) to add.

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to create the group. This typically includes details about the newly created group such as its ID, name, description, participants, and any status messages returned by the API.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node uses the base URL https://doc.evolution-api.com/api-reference for API requests.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Operation not supported error: If the operation "Criar Grupo" is not recognized, ensure that the resource and operation parameters are correctly set to "groups-api" and "create-group" respectively.
  • Invalid participant format: Participants must be provided as comma-separated phone numbers without spaces. Incorrect formatting may cause API errors.
  • Missing required fields: Ensure that "Nome Da Instância", "Nome Do Grupo", and "Participantes" are all provided; otherwise, the node will throw validation errors.
  • API authentication issues: Verify that the API key credential is valid and has the necessary permissions to create groups.

Links and References

Discussion