Wappfy icon

Wappfy

Interact with WhatsApp through Wappfy API

Overview

This node enables interaction with WhatsApp through the Wappfy API, specifically allowing users to manage WhatsApp groups among many other resources. For the Group - Create operation, it creates a new WhatsApp group by specifying the group name and participants.

Common scenarios where this node is beneficial include automating group creation for customer support teams, marketing campaigns, or community management where multiple phone numbers need to be added to a WhatsApp group programmatically.

Practical example: Automatically create a WhatsApp group for a new project team by providing the team members' phone numbers and a descriptive group name, enabling instant communication within the team.

Properties

Name Meaning
Group Name The name/title of the WhatsApp group to be created.
Participants Comma-separated list of participant phone numbers to add to the group (e.g., "123456789,987654321").
Description Description text for the group (not used in the create operation but available for update).

Output

The output JSON contains the response from the Wappfy API after attempting to create the group. This typically includes details about the newly created group such as its ID, name, participants, and other metadata returned by the API.

If multiple items are processed, the output is an array of such JSON objects, one per input item.

No binary data output is involved in this operation.

Dependencies

  • Requires access to the Wappfy API.
  • Requires configuration of credentials including:
    • Base URL of the Wappfy API instance.
    • Instance name identifier.
    • An API key credential for authentication.
  • The node uses HTTP requests to communicate with the Wappfy API endpoints.

Troubleshooting

  • Invalid or missing API key: The node will fail if the API key credential is not set or invalid. Ensure the API key is correctly configured.
  • Incorrect participant phone number format: Phone numbers must be comma-separated and valid WhatsApp IDs (usually with country code). Invalid formats may cause API errors.
  • API endpoint unreachable: Network issues or incorrect base URL can cause request failures. Verify connectivity and correct API URL.
  • Permission issues: The API user must have permissions to create groups; otherwise, the API may return authorization errors.
  • Error messages: Errors from the API are passed through in the output JSON under an error field if "Continue On Fail" is enabled. Otherwise, the node throws an error with the message from the API.

Links and References

Discussion