Wasapbot icon

Wasapbot

Custom operations
Join our community

Actions5

Overview

This node integrates with a WhatsApp API service to perform various messaging and group management actions. Specifically, the Add Contact operation allows users to add a WhatsApp number to a specified WhatsApp group. This is useful for automating group membership management, such as adding new participants to a group chat based on external triggers or workflows.

Practical examples include:

  • Automatically adding new customers or team members to a WhatsApp support or project group.
  • Managing event attendee groups by adding contacts dynamically.
  • Integrating CRM systems to sync contacts into WhatsApp groups for communication.

Properties

Name Meaning
API Key Your API key for authenticating requests to the WhatsApp API service.
Instance ID The identifier of your WhatsApp instance where the group exists.
Access Token An access token used for API authentication alongside the API key.
Number The WhatsApp phone number to add to the group, including country code but without "+" sign.
Group ID The unique identifier of the WhatsApp group to which the contact will be added.

Output

The node outputs a JSON object containing the response from the WhatsApp API after attempting to add the contact to the group. The exact structure depends on the API's response but typically includes success status, any error messages, and details about the added contact or group.

No binary data output is produced by this operation.

Example output JSON (simplified):

{
  "success": true,
  "message": "Contact added successfully",
  "group_id": "123456",
  "number": "60123456789"
}

Dependencies

  • Requires an active WhatsApp API service accessible via HTTP POST requests.
  • Needs valid credentials: an API key, an instance ID, and an access token.
  • The node calls specific endpoints hosted at https://api.customje.com for each action.
  • No additional environment variables are required beyond the provided credentials.

Troubleshooting

  • Common issues:

    • Invalid or expired API key or access token leading to authentication failures.
    • Incorrect instance ID or group ID causing the API to reject the request.
    • Phone number format errors (must include country code without "+").
    • Network connectivity problems preventing API calls.

  • Error messages:

    • "The operation "add-contact" is not implemented yet!": Indicates a misconfiguration or unsupported operation; ensure the correct operation is selected.
    • "The resource "actions" is not known!": Means the resource parameter is incorrect; verify it is set to "actions".
    • API response errors usually contain descriptive messages; check the returned JSON for details.

  • Resolution tips:

    • Double-check all credential values and input parameters.
    • Confirm the WhatsApp instance and group IDs are correct and active.
    • Ensure the target phone number is registered on WhatsApp.
    • Use the node’s "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion