Actions6
Overview
This node integrates with a URL shortening service API, allowing users to manage shortened URLs programmatically. Specifically, the "Atualizar URL" (Update URL) operation enables updating properties of an existing shortened URL by its ID. This is useful for scenarios where you need to modify the destination URL, customize the alias, set redirection types, add security features like passwords, or configure metadata and targeting options after the URL has been created.
Practical examples include:
- Changing the long URL behind a shortened link without changing the short alias.
- Adding password protection to restrict access.
- Setting expiration dates for temporary campaigns.
- Customizing meta tags for better social media sharing previews.
- Applying geo, device, or language targeting to control who sees the redirected content.
- Associating tracking pixels or channel IDs for analytics purposes.
Properties
| Name | Meaning |
|---|---|
| ID Da URL | The unique identifier of the URL to be updated. |
| URL Longa | The new long URL that the shortened URL should redirect to. |
| Alias Personalizado | A custom alias for the shortened URL, replacing the default generated one. |
| Tipo De Redirecionamento | Type of redirection: "Direto" (direct), "Frame", or "Splash". |
| Senha | Password to protect the shortened URL, requiring users to enter it before redirecting. |
| Domínio Personalizado | Custom domain to use for the shortened URL. Options include several predefined domains. |
| Data De Expiração | Expiration date/time for the shortened URL in format like "YYYY-MM-DD HH:mm:ss". |
| Título Meta | Meta title tag for the shortened URL, used in social sharing previews. |
| Descrição Meta | Meta description tag for the shortened URL, used in social sharing previews. |
| Imagem Meta | URL to an image (jpg or png) used as meta image for social sharing previews. |
| Geo Targeting | Geo-targeting data specifying which geographic locations the URL redirection applies to. |
| Device Targeting | Device-targeting data specifying which devices the URL redirection applies to. |
| Language Targeting | Language-targeting data specifying which languages the URL redirection applies to. |
| Pixels | Array of pixel IDs for tracking user interactions on the shortened URL. |
| Channel ID | Identifier for associating the URL with a specific marketing or distribution channel. |
| Deep Link | JSON object containing app store links for deep linking into mobile apps. |
Output
The node outputs a JSON object representing the updated URL details returned from the API. This typically includes confirmation of the update and the current state of all URL properties such as the long URL, alias, redirection type, metadata, targeting settings, and tracking information.
If the API supports binary data output (not indicated here), it would relate to any downloadable content or media associated with the URL, but this node primarily deals with JSON data.
Dependencies
- Requires connection to the URL shortening service API.
- Needs an API authentication token or key configured in n8n credentials to authorize requests.
- No other external dependencies are indicated.
Troubleshooting
- Invalid URL ID: If the provided URL ID does not exist or is incorrect, the API will likely return an error indicating the resource was not found. Verify the ID before updating.
- Authentication errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly set up in n8n.
- Invalid property values: Providing malformed URLs, unsupported redirection types, or incorrectly formatted dates may result in validation errors. Double-check input formats.
- Alias conflicts: Attempting to set a custom alias already in use might cause a conflict error. Choose unique aliases.
- Expired URLs: Trying to update a URL that has expired or been deleted may fail.
- JSON parsing errors: For the Deep Link property, ensure valid JSON syntax to avoid errors.
Links and References
- Refer to the URL shortening service's official API documentation for detailed field descriptions and constraints.
- n8n documentation on creating and using API credentials.
- General best practices for URL shortening and link management.