Zalo User Interact icon

Zalo User Interact

Gửi tin nhắn và tương tác với Zalo User

Actions17

Overview

This n8n custom node implements the "Send Friend Request With Phone Number" operation for the "Friend" resource, likely targeting the Zalo platform (a popular messaging app in Vietnam). The node allows users to send a friend request to another user by specifying their phone number and an optional message. This is useful for automating social connection workflows, such as onboarding new contacts, CRM integrations, or customer engagement processes where connecting with users on Zalo is required.

Example use cases:

  • Automatically sending a Zalo friend request to new leads captured from a web form.
  • Integrating with a CRM to connect sales representatives with clients via Zalo.
  • Onboarding automation that connects your business account with new customers on Zalo.

Properties

The following input properties are supported for this operation:

Display Name Type Required Description
Phone Number String Yes Số điện thoại của người dùng Zalo. (Zalo user's phone number)
Message String No Nội dung tin nhắn. (Message content to include with the friend request)

Output

The output of this node is a JSON object for each processed item. The structure typically includes:

{
  "success": true,
  "data": {
    // Details about the sent friend request, such as status, recipient info, etc.
  }
}
  • If the operation is successful, success will be true, and data will contain information returned by the Zalo API regarding the friend request.
  • In case of failure, the output may look like:
{
  "success": false,
  "error": "Error message",
  "stack": "Stack trace if available"
}

Dependencies

  • External Service: Requires access to the Zalo API.
  • API Key/Token: You must configure authentication credentials (such as an API key or OAuth token) for the Zalo API within n8n.
  • n8n Configuration: Ensure the Zalo API credentials are set up in n8n's credential management system.

Troubleshooting

Common Issues

  • Invalid or missing phone number: Ensure the phone number is correctly formatted and belongs to a valid Zalo user.
  • Authentication errors: Make sure your Zalo API credentials are correct and have sufficient permissions.
  • Rate limits: The Zalo API may enforce rate limits; excessive requests could result in temporary blocks.
  • Network issues: Connectivity problems between n8n and the Zalo API endpoint can cause failures.

Error Messages

  • "Missing required property: Phone Number": Ensure you provide a valid phone number.
  • "Authentication failed": Check your Zalo API credentials in n8n.
  • "API error: ...": Review the error message returned by the Zalo API for more details.
  • "User not found": The provided phone number does not correspond to a Zalo user.

Resolution steps:

  • Double-check all input fields.
  • Verify your API credentials.
  • Consult Zalo API documentation for specific error codes.

Links and References

Discussion