Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node interacts with the Evolution API to manage groups. Specifically, the "Create Group" operation allows users to create a new group within an instance by specifying its name, description, and participants. This is useful in scenarios where automated group management is needed, such as setting up communication groups for teams, projects, or events programmatically.

Practical examples:

  • Automatically creating a project team group with specified members when a new project starts.
  • Setting up customer support groups dynamically based on incoming requests.
  • Organizing event participant groups by importing phone numbers.

Properties

Name Meaning
Name Da Instância The name of the instance where the group will be created.
Group Name 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 to the group.

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 status. No binary data output is indicated.

Dependencies

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

Troubleshooting

  • Operation not supported error: If you see an error stating the operation is not supported, verify that the resource is set to "groups-api" and the operation to "create-group".
  • Invalid participants format: Ensure participant phone numbers are correctly formatted and separated by commas without extra spaces.
  • Authentication errors: Confirm that the API key credential is valid and has the required permissions.
  • Missing required fields: The instance name, group name, and participants are mandatory; missing any will cause the request to fail.

Links and References

Discussion