Green API icon

Green API

Send WhatsApp messages via Green API or trigger workflows on webhooks

Actions21

Overview

The node enables interaction with WhatsApp via the Green API service, specifically allowing users to create and manage WhatsApp groups programmatically. The "Create Group" operation under the "Group" resource lets you create a new WhatsApp group by specifying its name and participants.

This node is beneficial in scenarios where automated group creation is needed, such as onboarding new teams, organizing event participants, or managing customer support groups dynamically. For example, after collecting a list of contacts from a CRM, you can automatically create a WhatsApp group including those contacts for targeted communication.

Properties

Name Meaning
Mode Selects the node mode: "Action" to execute WhatsApp actions or "Listen for Incoming Webhook".
Group Name The name to assign to the new WhatsApp group.
Group Participants Comma-separated list of chat IDs (phone numbers with suffix) to add as participants in the group.

Output

The node outputs a JSON array containing the response from the Green API after attempting to create the group. This typically includes details about the newly created group such as its ID and status. The exact structure depends on the Green API's response but generally confirms successful creation or provides error information.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Green API account with valid credentials (instance ID and API token).
  • The node uses HTTP POST requests to the Green API endpoints.
  • Proper configuration of the Green API credentials within n8n is necessary.
  • Internet connectivity to reach the Green API service.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrectly formatted participant chat IDs may result in errors or failure to add participants.
    • Network issues can prevent communication with the Green API.

  • Error Messages:

    • Errors like Failed to create group: <message> indicate problems returned by the API or network issues.
    • If the node throws an error mentioning "Data sent", review the provided group name and participant IDs for correctness.

  • Resolutions:

    • Verify that the API credentials are correctly set up and have sufficient permissions.
    • Ensure participant chat IDs follow the required format (e.g., phone@c.us for private chats).
    • Check network connectivity and retry if transient errors occur.

Links and References

Discussion