WSAPI icon

WSAPI

Interact with WSAPI WhatsApp API

Overview

This node integrates with the WSAPI WhatsApp API, enabling users to perform various operations on WhatsApp resources. Specifically, for the Account resource and the Set Status operation, it allows updating the status message that appears on a WhatsApp profile. This is useful for businesses or individuals who want to communicate their current availability, promotions, or any relevant information directly through their WhatsApp status.

Practical examples:

  • A business sets its WhatsApp status to "Available for business inquiries" during working hours.
  • A user updates their status to "On vacation until next Monday" to inform contacts of their absence.
  • A support team changes the status to "Currently assisting other customers, response may be delayed."

Properties

Name Meaning
Status Message The text string that will appear as the WhatsApp profile status message. It should be concise and professional. Example: "Available for business inquiries".

Output

The node outputs JSON data representing the result of the status update operation. Typically, this includes confirmation details such as success status or updated account information. If the operation fails, the output contains an error message describing the issue.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the WSAPI WhatsApp API service.
  • Needs an API authentication credential configured in n8n (an API key or token).
  • The base URL for the WSAPI must be set in the credentials configuration.
  • Internet access from the n8n instance to reach the WSAPI endpoint.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials can cause authentication failures.
    • Network connectivity problems may prevent reaching the WSAPI server.
    • Providing an empty or overly long status message might lead to validation errors.
  • Error messages and resolutions:

    • "The resource "account" is not known!" — This indicates an internal misconfiguration; ensure the resource parameter is correctly set to "account".
    • "The operation "setStatus" is not implemented yet!" — Suggests the operation name might be misspelled or unsupported; verify the operation parameter.
    • API errors returned from WSAPI (e.g., unauthorized, bad request) usually include descriptive messages; check credentials and input values accordingly.
  • To handle errors gracefully, enable the "Continue On Fail" option in the node settings to process subsequent items even if one fails.

Links and References

Discussion