Evolution API Direct

Overview

The node "Evolution API Direct" allows users to interact directly with the Evolution API by specifying a resource and operation, along with necessary parameters such as server URL and API key. Specifically, for the "Grupo" resource and the "Criar Grupo" (Create Group) operation, this node facilitates creating a new group within an instance of the Evolution system. This is useful in scenarios where automated group management is needed, such as setting up communication groups or managing user clusters programmatically.

Practical examples include:

• Automatically creating a group for a project team when a new project is initiated.
• Setting up customer support groups dynamically based on incoming requests.
• Managing participant lists in bulk by creating groups with specified members.

Properties

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to create the group. The structure typically includes details about the newly created group such as its identifier, name, description, participants, and status. No binary data output is indicated.

Example output JSON structure (simplified):

[
  {
    "groupId": "string",
    "name": "string",
    "description": "string",
    "participants": ["string"],
    "status": "string"
  }
]

Dependencies

• Requires access to the Evolution API endpoint specified by the Server URL.
• Requires a valid API key credential for authentication.
• Proper network connectivity to the Evolution API service.
• No additional external dependencies are indicated beyond standard HTTP request capabilities.

Troubleshooting

• Common Issues:

  • Invalid or missing API key leading to authentication failures.
  • Incorrect Server URL causing connection errors.
  • Malformed participant list (e.g., incorrect phone number format or missing commas).
  • Missing required fields like instance name or group name.

• Error Messages:

  • "Operação não suportada." indicates that the selected operation is not supported for the chosen resource; verify resource and operation names.
  • Network or authentication errors may occur if the API key or server URL is incorrect; ensure credentials and URLs are accurate.
  • Validation errors from the API if required parameters are missing or invalid; check input property values carefully.

Links and References

• Evolution API Documentation: https://doc.evolution-api.com/api-reference
• n8n Documentation: https://docs.n8n.io/