Zalo Bot icon

Zalo Bot

Interact with Zalo Bot Platform

Overview

This node integrates with the Zalo Bot Platform to send messages and perform bot-related actions. Specifically, for the Message resource and sendMessage operation, it sends a text message to a specified chat or user ID on Zalo.

Common scenarios where this node is useful include:

  • Automating customer support by sending automated replies.
  • Broadcasting notifications or alerts to users.
  • Integrating Zalo messaging into workflows for marketing or communication purposes.

For example, you can use this node to send a welcome message to a user who just signed up on your platform or notify a user about an event update.

Properties

Name Meaning
Debug Mode If enabled, returns the API request URL for debugging purposes instead of the usual response.
Chat/User ID The unique identifier of the chat or user to whom the message will be sent.
Text The text content of the message to be sent.

Output

The output is a JSON array containing the response from the Zalo Bot API for each input item processed. The structure typically includes:

  • response: The parsed JSON response from the API call indicating success or failure.
  • debug (optional): When debug mode is enabled, contains the called URL with sensitive tokens redacted and HTTP status code.

No binary data is output by this operation.

Example output JSON snippet:

[
  {
    "response": {
      "message_id": "123456789",
      "ok": true
    }
  }
]

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 needed beyond the API authentication token.

Troubleshooting

  • Missing Chat/User ID or Text: The node requires both chatId and text properties. Omitting these will cause errors.
  • Invalid Sticker ID (for other operations): For sending stickers, a valid sticker ID must be provided; otherwise, an error is thrown.
  • API Errors: If the API returns an error (e.g., invalid token, rate limits), the node outputs the error details in the response field.
  • Debug Mode Confusion: Enabling debug mode changes the output to show the request URL and status rather than the normal API response. Disable debug mode to get actual API responses.
  • Webhook Deletion Confirmation: For webhook deletion operations (not relevant here), confirmation is required to prevent accidental removal.

Links and References

Discussion