Automated Zalo OA Token Management with OAuth and Webhook Integration

This n8n workflow provides a robust solution for managing Zalo Official Account (OA) access tokens. It integrates OAuth for secure token retrieval and renewal, coupled with a webhook for on-demand token updates. This ensures your Zalo OA integrations always have valid access, preventing service interruptions.

What it does

This workflow automates the following key processes:

1. Scheduled Token Refresh: Periodically triggers to ensure the Zalo OA access token is always up-to-date.
2. On-Demand Token Refresh via Webhook: Allows external systems to request an immediate token refresh by calling a dedicated webhook.
3. Initiates Zalo OA OAuth Flow: Constructs and redirects to the Zalo OAuth authorization URL, prompting user consent.
4. Handles OAuth Callback: Captures the authorization code from the Zalo OAuth callback.
5. Exchanges Code for Access Token: Uses the authorization code to request a new access token and refresh token from Zalo.
6. Stores and Provides Token: Processes and makes the newly acquired access token available for subsequent steps or external systems.

Prerequisites/Requirements

• n8n Instance: A running instance of n8n.
• Zalo Official Account (OA): An active Zalo OA with API access enabled.
• Zalo Developer Account: Access to the Zalo Developer Portal to obtain app_id and app_secret for your OA.
• Redirect URI: A configured redirect URI in your Zalo Developer settings that points to your n8n webhook URL.

Setup/Usage

1. Import the Workflow:
   • Copy the provided JSON code.
   • In your n8n instance, click "New Workflow" or open an existing one.
   • Go to "File" > "Import from JSON" and paste the workflow JSON.
2. Configure Zalo OAuth Credentials:
   • Locate the "Edit Fields (Set)" node. This node is likely used to store or prepare the app_id, app_secret, and redirect_uri. Update these values with your actual Zalo OA application details.
   • The "HTTP Request" nodes will use these credentials to interact with the Zalo API.
3. Set up the Webhook:
   • Activate the "Webhook" node. n8n will provide a unique URL.
   • Configure this URL as the "Redirect URI" in your Zalo Developer Portal settings for your Zalo OA application.
4. Configure Scheduled Trigger:
   • Adjust the "Schedule Trigger" node to your desired refresh interval (e.g., daily, hourly) to automatically renew the token before it expires.
5. Activate the Workflow:
   • Once configured, activate the workflow to enable both scheduled and webhook-triggered token management.

This workflow is designed to be a foundational component for any application or service that needs to interact with Zalo Official Accounts, ensuring continuous and secure access.