Zalo Bot icon

Zalo Bot

Interact with Zalo Bot Platform (bot.zapps.me)

Actions6

Overview

This node integrates with the Zalo Bot Platform, enabling users to interact programmatically with Zalo messaging services. Specifically, the Send Photo operation allows sending a photo message to a specified chat or user by providing a photo URL and an optional caption.

Common scenarios for this node include:

  • Sending promotional images or product photos directly to customers via Zalo.
  • Sharing event photos or announcements in group chats.
  • Automating photo delivery as part of customer support or notification workflows.

Example: Automatically send a welcome image with a caption to new users joining a Zalo chat.

Properties

Name Meaning
Chat ID The identifier of the recipient user or chat where the photo will be sent (chat_id).
Photo URL The URL of the photo to send. This must be accessible by the Zalo platform.
Caption Optional text caption to accompany the photo.

Output

The node outputs a JSON object representing the response from the Zalo Bot API after attempting to send the photo. The structure includes at least an ok boolean indicating success, and may contain additional fields such as description for error messages or other metadata returned by the API.

No binary data output is produced by this operation.

Example output JSON structure:

{
  "ok": true,
  "result": {
    // details about the sent photo message
  }
}

If the API call fails, the output will contain an error description.

Dependencies

  • Requires an API authentication token (bot token) configured in the node credentials to authorize requests to the Zalo Bot Platform.
  • The node makes HTTP POST requests to the Zalo Bot API endpoint (default base URL: https://bot-api.zapps.me).
  • No additional external dependencies are required.

Troubleshooting

  • Missing Bot Token: If the bot token credential is not set, the node will throw an error indicating the missing token. Ensure the API key is properly configured.
  • Invalid Chat ID or Photo URL: Errors from the Zalo API may occur if the chat ID does not exist or the photo URL is inaccessible. Verify these inputs before running the node.
  • API Errors: The node surfaces errors returned by the Zalo API, including descriptive messages. Review these messages to adjust parameters or check API status.
  • Secret Token Requirement: For webhook-related operations (not relevant here), a secret token is mandatory; ensure it is provided either in the node or credentials.

Links and References

Discussion