IZapp - URL icon

IZapp - URL

Interage com a API de Encurtador de URLs
Join our community

Actions6

Overview

This node integrates with a URL shortening service API, allowing users to create and manage shortened URLs programmatically within n8n workflows. It is particularly useful for marketing campaigns, link tracking, and simplifying long URLs for sharing.

The "Encurtar URL" (Shorten URL) operation enables users to generate a short URL from a long one, optionally customizing the alias, setting expiration dates, adding password protection, and defining meta information for better presentation on social platforms. This can be used in scenarios such as:

  • Creating branded short links for social media posts.
  • Protecting sensitive links with passwords.
  • Setting up campaign-specific URLs that expire after a certain date.
  • Adding deep linking for mobile app integration.

Properties

Name Meaning
URL Longa The original long URL you want to shorten.
Alias Personalizado A custom alias for the shortened URL, allowing personalized or branded short links.
Tipo De Redirecionamento The type of redirection when accessing the short URL. 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 for the shortened URL, used for SEO or social sharing previews.
Descrição Meta Meta description for the shortened URL, enhancing link previews.
Imagem Meta URL to an image (jpg or png) used as meta image for rich previews.
Geo Targeting Geo-targeting data to customize redirection based on user location.
Device Targeting Device-targeting data to customize redirection based on device type (e.g., mobile, desktop).
Language Targeting Language-targeting data to customize redirection based on user language preferences.
Pixels Array of pixel IDs for tracking purposes, useful for analytics and retargeting.
Channel ID Channel identifier associated with the shortened URL, possibly for campaign segmentation.
Deep Link JSON object containing app store links for deep linking, enabling mobile app integration when users open the short URL.

Output

The node outputs JSON data representing the result of the URL shortening operation. This typically includes details about the newly created short URL, such as:

  • The shortened URL itself.
  • Any metadata or settings applied (alias, expiration, password protection).
  • Tracking and targeting configurations.
  • Possibly status or error messages if the operation failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires connection to the external URL shortening API service.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • No other external dependencies are indicated.

Troubleshooting

  • Invalid URL Format: If the input long URL is malformed, the API may reject the request. Ensure the URL is properly formatted including protocol (http/https).
  • Alias Already Taken: Using a custom alias that already exists will likely cause an error. Choose unique aliases or leave blank for auto-generated ones.
  • Expired Date Format: The expiration date must follow the expected format (YYYY-MM-DD HH:mm:ss). Incorrect formats may cause failures.
  • Authentication Errors: Missing or invalid API credentials will prevent successful calls. Verify the API key/token is correctly set up in n8n.
  • Unsupported Domain: Selecting a domain not allowed by the service or misconfigured may cause errors.
  • Password Restrictions: Some services may have rules on password complexity or length; violating these may cause rejection.

Links and References

Discussion