Actions6
Overview
This node integrates with the "Clientes Online" URL shortening API, allowing users to create and manage shortened URLs programmatically within n8n workflows. The specific operation "URL - Encurtar" (shorten URL) enables converting long URLs into shorter, more manageable links with additional customization options such as custom aliases, password protection, expiration dates, and meta information.
Common scenarios for this node include:
- Marketing campaigns where short, branded URLs are needed.
- Sharing links on social media or messaging platforms where character count is limited.
- Tracking user engagement via pixels and channel IDs embedded in shortened URLs.
- Protecting sensitive links with passwords or limiting their validity by expiration date.
- Enhancing SEO and social sharing by setting meta titles, descriptions, and images.
Practical example:
A marketing team wants to share a promotional link on Twitter but needs it shortened and branded with a custom domain and alias. They also want to track clicks using pixel IDs and protect the link with a password. This node can automate that process inside an n8n workflow.
Properties
| Name | Meaning |
|---|---|
| URL Longa | The original long URL you want to shorten. |
| Alias Personalizado | A custom alias for the shortened URL, allowing a personalized path instead of a random string. |
| Tipo De Redirecionamento | Type of redirection when the shortened URL is accessed. Options: "Direto" (direct), "Frame", or "Splash". |
| Senha | Password to protect access to the shortened URL. |
| Domínio Personalizado | Custom domain to use for the shortened URL. Options include several predefined domains like https://demanda.sistema.chat, https://link.clientes.online, etc. |
| Data Para Expirar | Expiration date/time for the shortened URL in format like YYYY-MM-DD HH:mm:ss. After this date, the URL may no longer be valid. |
| Título Meta | Meta title tag content for the shortened URL page, useful for SEO and social sharing. |
| Descrição Meta | Meta description tag content for the shortened URL page. |
| Imagem Meta | URL to a JPG or PNG image used as meta image for social sharing previews. |
| Geo Targeting | Geo-targeting data to restrict or customize the URL behavior based on geographic location. |
| Device Targeting | Device-targeting data to customize URL behavior depending on the user's device type. |
| Language Targeting | Language-targeting data to customize URL behavior based on the user's language settings. |
| Pixels | Array of pixel IDs for tracking user interactions with the shortened URL. |
| Channel ID | Channel identifier associated with the shortened URL for analytics or segmentation purposes. |
| Deep Link | JSON object containing app store links for deep linking, enabling mobile apps to open directly from the shortened URL. |
Output
The node outputs JSON data representing the result of the URL shortening operation. This typically includes details about the newly created shortened URL such as:
- The shortened URL itself.
- Metadata including alias, domain, expiration, and protection settings.
- Tracking and targeting configurations.
- Any response status or error messages from the API.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Clientes Online URL Shortener API.
- The node depends on network connectivity to the external URL shortening service.
- No additional environment variables are explicitly required beyond the API authentication setup.
Troubleshooting
- Invalid URL: If the input URL is malformed or unreachable, the API may return an error. Ensure the URL is correctly formatted and accessible.
- Alias already taken: Using a custom alias that is already in use will cause a conflict error. Choose a unique alias or leave blank for automatic generation.
- Authentication errors: Missing or invalid API credentials will prevent the node from working. Verify that the API key is correctly configured in n8n credentials.
- Expiration date format: Incorrectly formatted expiration dates may be rejected. Use the specified format
YYYY-MM-DD HH:mm:ss. - Domain selection: Selecting a domain not authorized for your account may cause errors. Use only the provided domain options.
- Password protection issues: If password is set but not handled properly downstream, users may be unable to access the shortened URL.
Links and References
- Clientes Online URL Shortener API Documentation (example placeholder, replace with actual if available)
- n8n Documentation on Creating Custom Nodes
- URL Shortening Best Practices