Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
User Status → Update User Status
AI-generatedOverview
The "Update User Status" operation in the User Status resource allows users to update their WhatsApp status programmatically via the WaliChat API. This node supports posting either text or media content as a status update on a specified WhatsApp number.
Common scenarios where this node is beneficial include:
- Automating status updates for business WhatsApp accounts to share announcements, promotions, or greetings.
- Scheduling status updates to appear at specific times or after delays.
- Posting rich media such as images or videos with optional captions to engage contacts visually.
Practical examples:
- A marketing team schedules daily promotional messages as WhatsApp statuses.
- A customer support bot posts status updates with images about service availability.
- An event organizer shares countdowns or reminders through scheduled status updates.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) on which to update the status. |
| Content Type | Type of content for the status update: Text or Media. |
| Message | Text content of the status update (max 650 characters). Applicable only if Content Type is Text. |
| Font Style | Font style for the text status. Options: Helvetica, Serif, Norican. Applicable only if Content Type is Text. |
| Background Color | Background color for the text status. Multiple color options available (e.g., Red Purple, Moss Green, Sky Blue, etc.). Applicable only if Content Type is Text. |
| Reference | Optional user-defined reference string for traceability (max 150 characters). |
| Media Source | Source of the media file when Content Type is Media: URL or 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. Applicable only if Content Type is Media. |
| File Name | Optional filename for the media file. Applicable only if Content Type is Media. |
| Format | Format for displaying the media file. Options: Native, GIF, Voice Recording. Applicable only if Content Type is Media. |
| Schedule Status | Boolean flag indicating whether to schedule the status update for later publication. |
| Schedule Type | How to schedule the status update if scheduling is enabled. Options: Delay (seconds), Delay (time notation like 1h, 2d), Specific Date/Time. |
| Delay (Seconds) | Delay in seconds before publishing the status. Required if Schedule Type is Delay. |
| Delay (Time Notation) | Delay using 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 WaliChat API about the posted or scheduled status update.
If media content is used, the output confirms the media upload or usage along with any metadata such as captions or filenames.
No binary data output is indicated by the source code or properties.
Dependencies
- Requires an active connection to the WaliChat WhatsApp API via an API key credential.
- The node depends on the WaliChat API's ability to handle WhatsApp status updates.
- For media uploads, either a valid accessible URL or a previously uploaded file ID must be provided.
- Scheduling features depend on the API supporting delayed or timed status publications.
Troubleshooting
- Invalid WhatsApp Number: If the device ID is incorrect or not linked to the account, the API will fail to post the status. Verify the WhatsApp number/device ID is correct.
- 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: Providing an invalid URL or file ID for media will cause failures. Confirm URLs are reachable and file IDs exist.
- Scheduling Conflicts: Incorrect scheduling parameters (e.g., missing delay value or invalid date/time format) can cause errors. Double-check scheduling inputs.
- API Authentication Failures: Missing or invalid API keys will prevent any operation. Ensure credentials are correctly configured.
- Network or API Downtime: Temporary connectivity issues or API outages will cause execution failures. Retry or check service status.
Links and References
- WhatsApp Status Feature Overview
- WaliChat API Documentation (Assumed link based on context)
- n8n Documentation - Creating Custom Nodes
- Scheduling Concepts in n8n