Zalo icon

Zalo

Send messages and interact with Zalo Official Account API
Join our community

Actions6

Overview

The Zalo node's "Send Sticker Message" operation allows you to send a sticker (and optionally, a text message) to a Zalo user via the Zalo Official Account API. This is useful for automating customer engagement, sending quick reactions, or enhancing chatbot interactions with stickers and short messages.

Common scenarios:

  • Sending a thumbs-up or other reaction sticker in response to user actions.
  • Automating replies with branded stickers and optional thank-you notes.
  • Integrating Zalo messaging into customer support workflows.

Example:
A business could use this node to automatically send a "Thank you!" sticker when a customer completes a purchase or submits feedback on Zalo.

Properties

Name Type Meaning
User ID String The ID of the Zalo user to send the sticker to. This uniquely identifies the recipient within Zalo. Can be dynamically set using AI agent expressions.
Sticker ID String The ID of the sticker to send (e.g., "3001" for a thumbs up). Determines which sticker will be delivered to the user. Can be dynamically set using AI agent expressions.
Message Text (Optional) String Optional text message to accompany the sticker. For example, "Thanks for your message!". Can be left empty or set dynamically using AI agent expressions.

Output

Each execution returns an array of items, each containing a json object with the following structure:

{
  "success": true,
  "response": {
    // Raw response from Zalo API, typically includes status, message_id, etc.
  }
}
  • If an error occurs and "Continue On Fail" is enabled, the output will look like:
{
  "success": false,
  "error": "Error message"
}

Note:

  • The response field contains the raw response from the Zalo API, which may include details such as message IDs, status codes, or error information.

Dependencies

  • External Service: Requires access to the Zalo Official Account API.
  • API Credentials: You must configure Zalo API credentials (zaloApi) in n8n, including at least the Secret Key and valid access/refresh tokens.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid or expired access token:
    • Error: "Your Zalo access token has expired and no refresh token is available."
    • Solution: Update your credentials and reauthorize via the PKCE flow.
  • Missing Secret Key:
    • Error: "Secret Key is required to exchange code for tokens."
    • Solution: Ensure your Zalo API credentials include the Secret Key.
  • User ID or Sticker ID errors:
    • Error: "Failed to send sticker message to Zalo: ..."
    • Solution: Double-check that the User ID and Sticker ID are correct and valid for your Zalo Official Account.
  • Network/API errors:
    • Error: "Failed to send sticker message to Zalo: <error message>"
    • Solution: Check network connectivity and Zalo API service status.

General Advice:

  • Enable "Continue On Fail" to capture errors in the output instead of stopping the workflow.
  • Review the error field in the output for detailed error messages.

Links and References

Discussion