WhatsApp API icon

WhatsApp API

Integração com WhatsApp API para envio de mensagens e gerenciamento
Join our community

Actions20

Overview

This node integrates with a WhatsApp API to send messages and manage related entities such as contacts, tickets, sessions, and opportunities. Specifically, the Send Group Text operation under the Message resource allows sending a text message to a WhatsApp group identified by its group ID.

Common scenarios for this node include:

  • Broadcasting announcements or updates to a WhatsApp group.
  • Automating group communication workflows in customer support or sales teams.
  • Sending alerts or notifications to multiple recipients grouped in WhatsApp.

For example, a company can use this node to automatically send daily status updates to a project team’s WhatsApp group by specifying the group ID and the message content.

Properties

Name Meaning
External Key Unique system key for identification of the message transaction.
Close Ticket Boolean flag indicating whether to close the associated ticket after sending the message.
Group ID The WhatsApp group identifier where the message will be sent.
Group Message Text The text content of the message to be sent to the group.

Output

The node outputs a JSON object containing the response from the WhatsApp API after attempting to send the group message. This typically includes confirmation details or error information returned by the API.

The output is structured as:

{
  "json": {
    // API response data confirming message delivery or error details
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the WhatsApp API service.
  • The node configuration must include the base URL of the WhatsApp API and an instance identifier.
  • Network access to the WhatsApp API endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing group ID may cause the API to reject the request.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • Authentication failures: Check that the API key credential is correctly configured and valid.
    • Validation errors (e.g., missing required fields): Ensure all required properties like Group ID and Group Message Text are provided.
    • API response errors: Review the API response in the node output for specific error codes and messages.

Resolving these usually involves verifying input parameters, refreshing credentials, and ensuring network connectivity.

Links and References

Discussion