WhatsAble icon

WhatsAble

Automate WhatsApp messages

Overview

This node, named "WhatsAble," automates sending WhatsApp messages through different product platforms under the same API umbrella. It supports multiple operations depending on the product type associated with the provided API key credential:

  • Notifier: Send plain WhatsApp messages with optional attachments.
  • Notifyer: Send template-based WhatsApp messages or non-template messages of various media types (text, document, image, video, audio).
  • WhatsAble: Send WhatsApp messages via the WhatsAble platform.

The node dynamically detects the product type by validating the API key and adjusts available operations accordingly.

Common Use Cases

  • Sending personalized WhatsApp notifications or alerts to customers.
  • Automating template-based WhatsApp communications for marketing or transactional messages.
  • Delivering multimedia content such as images, videos, documents, or audio files over WhatsApp.
  • Integrating WhatsApp messaging into workflows for customer support or engagement.

Practical Example

  • A business uses this node to send a templated appointment reminder message to clients using the Notifyer product.
  • Another use case is sending a promotional image with caption to a list of recipients via the Notifier product.
  • Or sending a quick text message from a selected WhatsAble number to a user.

Properties

Name Meaning
Detected Product Hidden property storing the detected product type based on the API key validation.
User ID Hidden property storing the user ID retrieved during API key validation (Notifyer only).

Note: The node's UI dynamically shows additional properties depending on the chosen operation and product type. These include:

  • sendMessage (Notifier):

    • Recipient: Phone number in international format.
    • Message: Text message content.
    • Attachment URL: Optional URL of an attachment.
    • Filename: Optional filename for the attachment.

  • sendNotifyerTemplate (Notifyer):

    • Recipient: Phone number in international format.
    • Template Name or ID: Select or specify a template.
    • Template Variables: Variables to fill in the template placeholders.

  • sendNonTemplateMessage (Notifyer):

    • Recipient Phone Number.
    • Message Type: One of Audio, Document, Image, Text, Video.
    • Depending on Message Type, relevant fields like URLs, captions, filenames, and preview options.

  • sendWhatsableMessage (WhatsAble):

    • Recipient Phone Number (selectable).
    • Text message content.
    • Attachment URL (optional).
    • Filename (optional).

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains the raw response from the respective API call made to send the WhatsApp message.

Typical output JSON structure includes success status and any returned message or error details from the API.

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message for that item.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authentication with the WhatsAble/Notifier/Notifyer service.
  • The node makes HTTP requests to the Insight Systems API endpoints to validate credentials, fetch templates, WhatsApp numbers, and send messages.
  • Network access to https://api.insightssystem.com is required.
  • Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

Common Issues

  • API Key Validation Failure: If the API key is invalid or expired, the node throws an error indicating API key validation failed.
  • Missing or Incorrect Parameters: Required parameters like recipient phone number, message content, or template variables must be correctly set; otherwise, the API may reject the request.
  • Unsupported Operation for Product: Attempting to perform an operation not supported by the detected product results in an error.
  • API Response Errors: The node checks for error messages in the API response body and surfaces them as node errors.

Error Messages and Resolutions

  • "API key validation failed: <message>": Verify the API key credential is correct and active.
  • "Operation <operation> is not supported for product type <product>": Choose an operation compatible with your product type.
  • Errors containing API response messages: Review the message for missing or invalid parameters and adjust inputs accordingly.
  • Network or HTTP errors: Ensure network connectivity and that the API endpoint is reachable.

Links and References

  • n8n Expressions Documentation
  • Insight Systems API base URL: https://api.insightssystem.com
  • WhatsAble official website or documentation (not provided in source code)

Note: This summary is based solely on static analysis of the provided source code and does not execute or simulate runtime behavior.

Discussion