Skip to main content
Un enlace de UTMKit es una dirección corta que envía a quien lo abre hacia un destino con los parámetros UTM ya aplicados. Antes de que exista, las reglas del espacio de trabajo revisan cada valor UTM y una verificación de seguridad revisa el destino. Un enlace que falla cualquiera de las dos nunca se crea.

Desde la consola

Los enlaces nuevos se crean desde el asistente. Di lo que quieres con tus propias palabras — “acorta https://example.com/spring con utm_source newsletter y utm_medium email, bajo la campaña Spring”. Cuando lo rechaza, dice por qué. Los propietarios, administradores y miembros pueden crear enlaces; los observadores solo los ven. Cada enlace aparece después en https://app.utmkit.co/links, mostrando Todavía no activo hasta que la red global lo confirma, y luego Activo.

De qué está hecho un enlace

  • Un destino, que empieza con http:// o https://. Para WhatsApp, da el número de teléfono y el mensaje y la dirección se compone por ti. Un enlace también puede llevar destinos para iOS y Android — ver enlaces profundos.
  • Parámetros UTM: utm_source, utm_medium, utm_campaign, utm_term y utm_content. El asistente pone solo los que pediste y nunca inventa un valor.
  • Un código corto. Un código generado tiene exactamente 7 caracteres. Un código que eliges tú debe tener entre 8 y 64 caracteres — letras, números, guiones y guiones bajos, empezando con una letra o un número. Las dos longitudes nunca se superponen, así que tu código nunca puede chocar con uno generado. Si ya está tomado en ese dominio, el rechazo sugiere alternativas libres.
  • Un dominio corto: el dominio compartido de UTMKit, a menos que tu organización haya conectado el suyo propio. Con más de una opción, el asistente pregunta cuál usar en vez de elegir por ti; di “compartido” para el compartido. Ver dominios propios.
  • Una campaña. Nombra una existente y el enlace queda agrupado bajo ella. Sin un utm_campaign propio, se deriva uno del nombre de la campaña, escrito como lo pide tu convención; un utm_campaign que des tú siempre gana. Ver campañas.

Qué revisan las reglas

Antes de guardar, se consulta la convención del espacio de trabajo: mayúsculas y separador, parámetros obligatorios, valores aprobados, reglas de dependencia y cualquier parámetro bloqueado para tu puesto. También avisa cuando Google Analytics 4 clasificaría un medio bajo un canal inesperado. Un rechazo es una sola frase llana que nombra el parámetro, el valor y qué usar en su lugar: utm_source ‘Newsletter’ no está aprobado en este espacio de trabajo. Los valores aprobados son: ‘newsletter’, ‘partner’. En modo bloquear nada se crea hasta que lo corrijas; en modo avisar el enlace se crea y lleva la advertencia.

El destino se revisa primero

Un destino que no es una dirección pública — una red privada, el nombre de una máquina — se rechaza. También uno catalogado como malware o phishing por una autoridad de reputación, y el rechazo dice en qué lista está. Un destino malo nunca se convierte en un enlace.
Si la verificación de seguridad no puede responder en ese momento, el enlace tampoco se crea. Intenta de nuevo en unos minutos — no se está llamando peligrosa a tu dirección.

Una URL etiquetada, un enlace

Si el espacio de trabajo ya tiene un enlace con el mismo destino y los mismos cinco valores UTM, el nuevo se rechaza y el rechazo nombra el enlace existente: dos códigos para una sola URL etiquetada dividirían sus clics. El dominio no importa, y un enlace sin ningún parámetro UTM no está sujeto a esta regla. La creación de enlaces tiene un límite por espacio de trabajo para proteger la verificación de seguridad: 300 enlaces nuevos al día, igual en todos los planes. Pasado ese límite, el rechazo dice cuándo intentarlo de nuevo.

Desde la API y el MCP

POST /api/v1/links crea un enlace con exactamente las mismas verificaciones; create_link es la herramienta MCP que hace lo mismo. Ambas requieren un token que lleve links:write; listar y leer enlaces necesita links:read. Un duplicado se responde con un conflicto, y un rechazo de regla o de seguridad con la misma frase que mostraría la consola. La referencia es la dueña de los parámetros.