Actions9
- Bot Actions
- Message Actions
Overview
This node integrates with the Zalo Bot Platform to send various types of messages, including photos, to a specified chat or user. The sendPhoto operation allows users to send an image either by URL or by referencing an existing file ID on the platform, optionally adding a caption. This is useful for automating multimedia messaging in customer support, marketing campaigns, or interactive bots on Zalo.
Practical examples:
- Sending product images with descriptions to customers.
- Sharing event photos or promotional banners automatically.
- Delivering visual content as part of a chatbot conversation.
Properties
| Name | Meaning |
|---|---|
| Debug Mode | When enabled, returns the API request URL and status for debugging purposes. |
| Chat/User ID | The unique identifier of the chat or user to whom the photo will be sent. |
| Photo | The photo to send, specified as a URL or an existing file ID on the Zalo platform. |
| Caption | Optional text caption to accompany the photo. |
Output
The node outputs a JSON array where each element corresponds to the response from the Zalo Bot API for each input item processed. The structure typically includes:
response: The parsed JSON response from the API indicating success or failure details.debug(optional): If debug mode is enabled, contains the called URL with sensitive tokens redacted and HTTP status code.
If debug mode is active, the output helps trace the exact API call made.
Dependencies
- Requires an API key credential for authenticating with the Zalo Bot Platform.
- Uses the external service endpoint at
https://bot-api.zapps.me. - Requires network access to the Zalo Bot API.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
- Missing Sticker ID error: When sending stickers, if no sticker ID is provided, the node throws an error prompting to provide a valid sticker ID.
- Webhook deletion confirmation: Deleting a webhook requires explicit confirmation; otherwise, an error is thrown to prevent accidental removal.
- API errors: If the API returns an error or non-OK status, the node includes this information in the output. Enabling debug mode can help identify issues by showing the exact request URL and status.
- Invalid chat/user ID or photo URL/file_id: Ensure that the chat ID and photo references are correct and accessible by the bot.
Links and References
- Zalo Official Bot API Documentation
- Zalo Stickers Repository (for obtaining sticker IDs)