WbizTool Message Status

Check WhatsApp message delivery status via WbizTool

Overview

This node checks the delivery status of a WhatsApp message using the WbizTool API. It is useful for scenarios where you need to verify if a specific WhatsApp message has been successfully delivered or if it encountered an error. For example, after sending messages through WhatsApp, you can use this node to track their delivery status by providing the message ID.

Properties

Name Meaning
Message ID The unique identifier of the WhatsApp message whose delivery status you want to check.

Output

The node outputs JSON data containing detailed information about the message status:

  • success: Boolean indicating if the status check was successful.
  • messageId: The ID of the message checked.
  • status: Numeric status code returned by the API (1 indicates success).
  • message: A message from the API response.
  • statusText: Textual description of the message status (e.g., "delivered").
  • error: Any error message returned by the API, or null if none.
  • response: The full raw response from the API.
  • input: The input parameters used for the request (here, just the messageId).
  • deliveryStatus: An object summarizing the delivery status with:
    • messageId: The message ID.
    • statusText: Status text or message.
    • deliveryStatus: Either "delivered" if status is 1, or "failed" otherwise.
    • errorMessage: Error message if any.
    • checkedAt: ISO timestamp when the status was checked.

If the node encounters an error and is set to continue on failure, it outputs a JSON object with success: false and an error message.

Dependencies

  • Requires an API key credential for the WbizTool API.
  • Uses the WbizTool API endpoint /message/status/{messageId}/ via a POST request.
  • Needs proper configuration of the API credentials in n8n before use.

Troubleshooting

  • Empty Message ID: If the "Message ID" property is empty or only whitespace, the node will throw an error stating "Message ID cannot be empty".
  • API Errors: If the WbizTool API returns a status other than 1, the node throws an error with the message from the API.
  • Credential Issues: Ensure that the API key and client ID are correctly configured; otherwise, authentication errors may occur.
  • Continue On Fail: If enabled, the node will not stop execution on errors but instead output error details per item.

Links and References

Discussion