Wassenger icon

Wassenger

Interact with Wassenger WhatsApp API
Join our community

Actions148

Overview

This node allows updating a WhatsApp user's status via the Wassenger WhatsApp API. It supports posting either text or media content as a status update on a specified WhatsApp number. Users can customize the appearance of text statuses with font styles and background colors, or upload media files (images/videos) with optional captions. Additionally, it supports scheduling status updates to be published immediately or at a later time using delays or specific date/time.

Common scenarios:

  • Automatically updating a business WhatsApp status with promotional messages or announcements.
  • Scheduling status updates for marketing campaigns or event reminders.
  • Posting multimedia status updates such as images or videos with captions.
  • Customizing text status appearance to match branding or style preferences.

Properties

Name Meaning
WhatsApp Number The ID of the WhatsApp number (device) where the status will be updated.
Content Type Type of content for the status update. Options: Text, Media.
Message Text content of the status update (max 650 characters). Used only if Content Type is Text.
Font Style Font style for the text status. Options: Helvetica, Serif, Norican. Optional, applies only to text statuses.
Background Color Background color for the text status. Multiple predefined color options like Red Purple, Moss Green, Sky Blue, etc. Optional, applies only to text statuses.
Reference Optional user-defined reference string for traceability (max 150 characters). Can be used to tag or identify the status update.
Media Source Source of the media file when Content Type is Media. Options: URL (external link), File ID (previously uploaded file).
File URL URL of the media file (image or video). Required if Media Source is URL.
File ID ID of a previously uploaded media file. Required if Media Source is File ID.
Caption Optional caption text for the media file. Applies only to media statuses.
File Name Optional filename for the media file. Applies only to media statuses.
Format Format for displaying the media file. Options: Native, GIF, Voice Recording. Optional, applies only to media statuses.
Schedule Status Boolean flag indicating whether to schedule the status update for later publication (true) or publish immediately (false).
Schedule Type Method of scheduling when Schedule Status is true. Options: Delay (Seconds), Delay (Time Notation), Specific Date/Time.
Delay (Seconds) Delay in seconds before publishing the status. Required if Schedule Type is Delay (Seconds).
Delay (Time Notation) Delay using human-readable time notation (e.g., 15m, 1h, 1d). Required if Schedule Type is Delay (Time Notation).
Date/Time Specific date and time to publish the status. Required if Schedule Type is Specific Date/Time.

Output

The node outputs JSON data representing the result of the status update operation. This typically includes confirmation details from the Wassenger API about the posted or scheduled status update.

If the status update involves media, the output confirms the successful handling of the media content.

No binary data output is indicated by the source code or properties.

Dependencies

  • Requires an API key credential for authenticating with the Wassenger WhatsApp API.
  • The node depends on the Wassenger API service being accessible.
  • Proper configuration of the API key credential within n8n is necessary.
  • The node uses internal methods to load options dynamically for WhatsApp numbers (getDevices) and previously uploaded files (getFiles).

Troubleshooting

  • Invalid WhatsApp Number: If the provided WhatsApp number ID is incorrect or not linked to the account, the API call will fail. Verify the device ID is valid and accessible.
  • Content Validation Errors: Text messages exceeding 650 characters or references longer than 150 characters may cause errors. Ensure inputs respect these limits.
  • Media Upload Issues: When using media from URLs, ensure the URL is publicly accessible and points to a supported media type. For file IDs, confirm the file was successfully uploaded beforehand.
  • Scheduling Errors: Incorrect scheduling parameters (e.g., missing delay value or invalid date/time format) can cause failures. Double-check scheduling fields based on the selected schedule type.
  • Authentication Failures: Missing or invalid API key credentials will prevent any operation. Confirm that the API key is correctly configured in n8n.
  • Network or API Downtime: Temporary network issues or Wassenger API downtime can cause request failures. Retry after some time or check API status.

Links and References

Discussion