Zalo Web icon

Zalo Web

Zalo Web.

Actions10

Overview

This node integrates with the Zalo Web API to send messages and media content through the Zalo messaging platform. Specifically, the Message Action - Send Photo operation allows users to send photos to a target chat or user by specifying their unique identifier.

Common scenarios where this node is beneficial include:

  • Automating photo sharing in customer support chats.
  • Sending promotional images or updates to users automatically.
  • Integrating Zalo messaging into workflows that require multimedia communication.

For example, a marketing automation workflow could use this node to send product images directly to customers who have opted in via Zalo.

Properties

Name Meaning
User ID Unique identifier for the target chat or username. To find your chat ID, ask @get_id_bot on Zalo.
Binary File Whether the photo data to upload should be taken from a binary field (true) or provided as a URL/file ID string (false).
Input Binary Field The name of the input binary property containing the photo file to be sent. Used only if "Binary File" is true.
Photo Photo to send when not using binary data. Can be a file ID of an existing photo on Zalo servers or an HTTP URL for Zalo to fetch the photo from.

Output

The node outputs a JSON object under the json field containing the response data from the Zalo API after sending the photo. This typically includes information about the message sent, such as message ID or status confirmation.

If the photo is sent from binary data, the node handles temporary file creation and cleanup internally but does not output binary data itself.

Example output structure:

{
  "data": {
    // Response details from Zalo API about the sent photo message
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Zalo Web API.
  • Uses internal helper functions to handle binary data conversion and temporary file management.
  • Relies on network access to Zalo's servers to send messages and upload media.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Common issues:

    • Incorrect or missing User ID will cause the message sending to fail.
    • If "Binary File" is true but the specified binary property does not exist or is empty, the upload will fail.
    • Providing an invalid URL or file ID for the photo may result in errors from the Zalo API.

  • Error messages:

    • Errors related to file download or upload failures may occur if the URL is unreachable or the file format is unsupported.
    • Authentication errors if the API key credential is invalid or expired.

  • Resolutions:

    • Verify the User ID is correct by using the recommended bot (@get_id_bot).
    • Ensure the binary data field contains valid image data when using binary upload.
    • Check network connectivity and URL validity for remote photo URLs.
    • Confirm API credentials are correctly configured and active.

Links and References

Discussion