Valeia - Simulate Incoming icon

Valeia - Simulate Incoming

Simulate an incoming WhatsApp message

Overview

This node simulates an incoming WhatsApp message by sending a test webhook request to a specified external API endpoint. It is useful for developers and automation builders who want to test or debug workflows that react to WhatsApp messages without needing actual incoming messages from WhatsApp. For example, you can simulate receiving a message from a specific phone number with custom content to verify how your workflow processes such events.

Properties

Name Meaning
From The phone number that sent the simulated WhatsApp message (e.g., "573228854498").
Phone Number ID The identifier of the WhatsApp Business phone number associated with the message.
Message The content of the simulated WhatsApp message to send in the webhook.

Output

The node outputs an array of JSON objects, each representing the response from the external API after sending the simulated webhook. The structure of each output item is:

{
  "json": {
    // Response data returned by the external API
  }
}

If an error occurs during the request and the node is configured to continue on failure, the output will contain an object with an error field describing the issue:

{
  "json": {
    "error": "Error message here"
  }
}

No binary data is produced by this node.

Dependencies

  • Requires an active connection to an external API service at https://valeian8n.whitelabel.lat/api/webhook/test.
  • Requires an API authentication token or credential configured in n8n under a generic API key credential.
  • The node uses HTTP POST requests to send the simulation data.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect or empty input properties (From, Phone Number ID, or Message) may result in errors or unexpected behavior.
    • Network connectivity problems can prevent the node from reaching the external API endpoint.
  • Error messages:

    • Errors thrown by the external API are captured and can be output if "Continue On Fail" is enabled.
    • Typical errors include authentication failures, invalid parameters, or server errors from the external API.
  • Resolution tips:

    • Verify that all required input fields are correctly filled.
    • Ensure the API credential is valid and has necessary permissions.
    • Check network access and firewall settings to allow outbound requests to the API URL.

Links and References

Discussion