Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node interacts with the Evolution API to perform various operations related to groups management. Specifically, for the "Grupo" resource and the "Criar Grupo" operation, it allows users to create a new group within a specified instance by providing the group's name, description, and participants. This is useful in scenarios where automated group creation is needed, such as setting up communication channels or managing user groups dynamically based on external triggers.

Practical examples include:

  • Automatically creating a group for a new project team when a project is initiated.
  • Setting up customer support groups with predefined participants.
  • Managing event-based groups where participants are added dynamically.

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 to the group.

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 ID, name, description, participants, and status. If the API supports binary data output, it would be summarized accordingly, but this node primarily deals with JSON responses representing group information.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API.
  • The node configuration must include valid credentials to access the Evolution API endpoint at https://doc.evolution-api.com/api-reference.
  • Network connectivity to the Evolution API service is necessary.

Troubleshooting

  • Common Issues:
    • Missing or invalid API credentials can cause authentication failures.
    • Incorrect formatting of participant phone numbers (should be comma-separated without spaces).
    • Providing empty required fields like instance name or group name will result in errors.
  • Error Messages:
    • "Operação não suportada." indicates that the selected operation is not implemented or recognized; ensure the correct resource and operation are chosen.
    • API errors returned from the Evolution API will be passed through; check the message for details such as invalid parameters or quota limits.
  • Resolutions:
    • Verify all required properties are filled correctly.
    • Confirm API credentials are valid and have sufficient permissions.
    • Format participant numbers exactly as specified.

Links and References

Discussion