Zalo OA icon

Zalo OA

Tương tác với Zalo Official Account API
Join our community

Actions36

Overview

The "Zalo OA" node integrates with the Zalo Official Account API, enabling users to send various types of messages and manage content on their Zalo Official Account. Specifically, the "Gửi Tin Nhắn Danh Sách" (Send List Message) operation allows sending a structured list message to a specific user. This type of message is useful for presenting multiple items or options in a single message, such as product catalogs, service lists, or promotional offers.

Practical examples include:

  • Sending a list of products with images and links to a customer.
  • Sharing a menu of services with descriptions and clickable URLs.
  • Delivering promotional content with multiple selectable items.

This operation enhances user engagement by providing rich, interactive message formats beyond simple text.

Properties

Name Meaning
Message Type The category of the message to send. Options:
- Tin Tư Vấn (Customer Service)
- Tin Giao Dịch (Transaction)
- Tin Truyền Thông Cá Nhân (Promotion)
User ID The unique identifier of the recipient user who will receive the list message.
Tiêu Đề The title of the list message, displayed prominently at the top of the message.
Danh Sách Mục The collection of list items ("Mục") included in the message. Each item includes:
- Tiêu Đề Mục (Item Title)
- Mô Tả (Description)
- URL Hình Ảnh (Image URL)
- Default Action URL (URL opened when the item is clicked)

Output

The output is a JSON object representing the response from the Zalo Official Account API after attempting to send the list message. It typically contains status information about the request, such as success confirmation or error details.

Example structure of the output JSON:

{
  "message_id": "string",
  "error": 0,
  "message": "Success"
}

If the message fails to send, the output will contain error codes and descriptive messages explaining the failure.

The node does not output binary data for this operation.

Dependencies

  • Requires an active Zalo Official Account API access token credential configured in n8n.
  • Uses the Zalo OpenAPI endpoint https://openapi.zalo.me/v3.0/oa/message/{messageType} for sending messages.
  • Relies on HTTP POST requests with JSON payloads.
  • No additional external dependencies beyond standard HTTP client libraries.

Troubleshooting

  • Common Issues:

    • Invalid or expired access token: Ensure the API key credential is valid and has not expired.
    • Incorrect user ID: Verify that the recipient's user ID is correct and corresponds to a follower of the Zalo OA.
    • Malformed list elements: Each list item must have valid URLs and non-empty titles; otherwise, the API may reject the message.
    • Insufficient permissions: The Zalo OA must have the necessary permissions to send messages of the selected type.

  • Error Messages:

    • "error": 1 with a message indicating invalid parameters usually means some required fields are missing or incorrectly formatted.
    • Network or timeout errors suggest connectivity issues; retry or check network settings.
    • Permission-related errors indicate missing rights on the Zalo OA side; review the OA's granted scopes.

  • Resolution Tips:

    • Double-check all input properties for correctness.
    • Confirm the access token is current and has appropriate scopes.
    • Validate URLs used in list items to ensure they are accessible and properly formatted.
    • Review Zalo OA API documentation for any recent changes affecting message sending.

Links and References

Discussion