WaliChat icon

WaliChat

Interact with WaliChat WhatsApp API

Actions148

Outbound Messages → Update Message

AI-generated

Overview

The "Update Message" operation under the "Outbound Messages" resource allows users to modify existing outbound WhatsApp messages managed via the WaliChat API. This node is useful when you need to change message content, update delivery details, or adjust metadata after a message has been created but before it is sent or processed.

Common scenarios include:

  • Correcting or updating the text of a scheduled message.
  • Changing the target recipient phone number, group, channel, or chat.
  • Rescheduling the delivery time of a message.
  • Adjusting message priority or assigning it to a different agent or device.
  • Removing specific fields such as media or location data from the message.
  • Adding custom labels for categorization or tracking purposes.

Practical example: Suppose you scheduled a promotional message to a customer group but realized the message text contains a typo. Using this operation, you can update the message text and reschedule the delivery without creating a new message.

Properties

Name Meaning
Message ID The unique identifier of the message to update.
Update Fields A collection of fields to modify in the message. These include:
- Message Text New text content for the message.
- Phone Number New target phone number in E.164 format (e.g., +447362053576).
- Group ID New target WhatsApp group ID to send the message to.
- Channel ID New target WhatsApp channel ID for message delivery.
- Chat ID New target WhatsApp chat ID for message delivery.
- Device ID New WhatsApp device ID to use for sending the message.
- Agent ID New agent ID to send the message on behalf of.
- Scheduled Delivery New scheduled date/time for message delivery.
- Priority New message priority level. Options: Low, Normal, High, Urgent.
- Reference New reference string for tracking the message.
- Remove Fields List of fields to remove from the message. Options include: Reference, Media, Media File, Media Message, Media Reference, Location, Location Address, Location Coordinates.
- Label Custom label to categorize the message.

Output

The node outputs an array of JSON objects representing the updated message(s). Each output item contains the updated message data as returned by the WaliChat API after applying the changes.

If the message includes any binary data (such as media files), the node handles these appropriately, but the primary output focus is on the JSON representation of the updated message.

Dependencies

  • Requires an active connection to the WaliChat WhatsApp API via an API key credential configured in n8n.
  • The node depends on various internal methods to load options dynamically for fields like devices, groups, agents, and labels.
  • Proper permissions and valid identifiers (message ID, device ID, etc.) are necessary to successfully update messages.

Troubleshooting

  • Invalid Message ID: If the provided message ID does not exist or is malformed, the API will return an error. Verify the message ID before attempting an update.
  • Invalid Field Values: Providing incorrect formats (e.g., phone number not in E.164) or invalid IDs for groups, channels, or devices may cause failures.
  • Permission Issues: Ensure the API key used has sufficient rights to update outbound messages.
  • Removing Non-existent Fields: Attempting to remove fields that do not exist on the message might be ignored or cause warnings.
  • Scheduling Conflicts: Setting a scheduled delivery time in the past or conflicting with other system constraints may result in errors.

To resolve errors, check the error message returned by the node, validate all input parameters, and ensure the API credentials are correct and have appropriate access.

Links and References

Discussion