WAHA

Connect with Whatsapp HTTP API

Actions116

Overview

This node sends an image as a status update in a messaging or social platform session. It is useful for sharing visual content with contacts as a status, similar to posting a story or status update in social media apps. For example, a user can send a photo with a caption to selected contacts or broadcast it to all contacts in a session.

Use Case Examples

  1. Sending a photo status update with a caption to specific contacts.
  2. Broadcasting an image status to all contacts in a session without a caption.

Properties

Name Meaning
Session The name of the session where the image status will be sent.
File The image file to be sent as status, including its mimetype, filename, and URL.
Contacts A list of contacts to whom the status image will be sent. If null, the status may be sent to all contacts.
Caption An optional text caption to accompany the image status.
Request Options Additional settings for the request such as batching, SSL certificate validation, proxy configuration, and timeout settings.

Output

JSON

  • statusId - Identifier of the sent status update.
  • session - The session name where the status was sent.
  • file
    • mimetype - MIME type of the sent image file.
    • filename - Filename of the sent image file.
    • url - URL of the sent image file.
  • caption - Caption text sent with the image status.
  • contacts - List of contacts to whom the status was sent.

Dependencies

  • Requires an API key credential or authentication token to access the messaging platform's API for sending status updates.

Troubleshooting

  • Ensure the session name is valid and active; invalid sessions will cause errors.
  • The file property must be a valid JSON object with correct mimetype, filename, and accessible URL; otherwise, the image will not be sent.
  • If contacts are specified, they must be valid and reachable; invalid contacts may cause partial or complete failure.
  • Network issues or proxy misconfiguration can cause request failures; verify proxy settings if used.
  • SSL certificate validation errors can be bypassed by enabling 'Ignore SSL Issues', but this is insecure and should be used cautiously.
  • Timeouts can occur if the server is slow or unresponsive; increase the timeout setting if needed.

Discussion