Evolution API

Interact with Evolution API

Actions64

Overview

The "Criar Grupo" (Create Group) operation for the "Grupo" (Group) resource in this custom n8n node allows users to programmatically create a new group via the Evolution API. This is particularly useful for automating group creation workflows, such as onboarding new teams, organizing participants for events, or managing communication groups dynamically based on business logic.

Practical examples:

Automatically creating WhatsApp groups for new project teams.
Setting up event-specific chat groups with predefined participants.
Integrating with CRM systems to generate customer support groups.

Properties

Display Name	Type	Description
Nome Da Instância	String	Digite o nome da instância que vai criar o grupo. (Enter the instance name that will create the group) Required
Nome Do Grupo	String	Digite o nome do grupo que será criado. (Enter the name of the group to be created) Required
Descrição	String	Digite a descrição do grupo (opcional). (Enter the group description, optional)
Participantes	String	Digite os números dos participantes separados por vírgula (ex: 5511999999999,5511888888888). (Enter participant phone numbers separated by commas) Required

Output

The node outputs a JSON object containing the result of the group creation operation. The exact structure depends on the Evolution API's response, but typically includes:

Group ID: Unique identifier for the newly created group.
Status/Success flag: Indicates if the group was created successfully.
Additional metadata: Such as group name, description, and list of participants.

Example output:

[
  {
    "groupId": "1234567890@group.evolution-api.com",
    "subject": "Nome Do Grupo",
    "description": "Descrição",
    "participants": [
      "5511999999999",
      "5511888888888"
    ],
    "status": "success"
  }
]

Note: The actual fields may vary depending 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 credentials.

Troubleshooting

Common issues:

Missing or invalid credentials: If the Evolution API credentials are not set or incorrect, the node will fail to authenticate.
Invalid participant format: Ensure participant numbers are comma-separated and in the correct international format (e.g., 5511999999999).
Unsupported operation/resource: If an unsupported resource or operation is selected, you may see an error like:
```
Operação não suportada.
A função "create-group" para o recurso "groups-api" não é suportada!
```
Resolution: Double-check that you have selected the correct resource and operation.

Other possible errors:

API rate limits or downtime: If the Evolution API is unavailable or rate-limited, the node may return an error from the API.
Missing required fields: All required properties (instance name, group name, participants) must be provided.