Documentation Index
Fetch the complete documentation index at: https://revolai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Descripción General
La Sustitución de Teléfono es una función de atribución de llamadas que reemplaza dinámicamente los números de teléfono en su sitio web según la fuente de tráfico del visitante. Cuando un visitante llega desde una campaña específica — Google Ads, Facebook, un referido de socio o cualquier enlace etiquetado con UTM — el tracker automáticamente sustituye su número de teléfono predeterminado con un número de seguimiento dedicado. Cuando el visitante llama a ese número, usted sabe exactamente qué campaña generó la llamada.
Cómo Funciona
Configure la sustitución de teléfono en una campaña
El visitante llega a su sitio
Coincidencia UTM
El número se reemplaza
tel:, en texto con el atributo data-revol-phone — y los reemplaza con el número de seguimiento. El reemplazo preserva el formato del número original.El evento se registra
phone_swap con los números original y de reemplazo. Este evento aparece en el Registro de Actividad y la tabla de Rendimiento de Campañas.Pestaña de Sustitución de Teléfono
La pestaña de Sustitución de Teléfono muestra todas las reglas activas de sustitución de teléfono de sus campañas en una sola tabla:| Columna | Descripción |
|---|---|
| Campaña | Nombre de la campaña con condiciones UTM (fuente, medio, etc.) mostradas debajo |
| Sustitución de Teléfono | Número original → Número de reemplazo |
| Estado | Activo o inactivo |
Agregar Números de Teléfono a Su Sitio Web
El tracker reemplaza números de teléfono de dos maneras:1. Enlaces Tel (Automático)
Cualquier enlace<a href="tel:..."> en su página se detecta automáticamente. Si el href coincide con el número original de una regla, se sustituye — tanto el atributo href como el texto visible.
tel: automáticamente.
2. Atributo de Datos (Explícito)
Para números de teléfono que no están en enlacestel: (texto plano, spans, divs), agregue el atributo data-revol-phone:
data-revol-phone se ocultan (visibility: hidden) hasta que se completa la sustitución, previniendo un destello del número original.
Preservación de Formato
El tracker preserva el formato del número original al reemplazar. Si el original y el reemplazo tienen la misma cantidad de dígitos, el reemplazo se formatea usando el patrón del original:| Original | Reemplazo (sin formato) | Resultado |
|---|---|---|
+380 (44) 123-45-67 | +380949876543 | +380 (94) 987-65-43 |
044 123 45 67 | 0949876543 | 094 987 65 43 |
+380441234567 | +380949876543 | +380949876543 |
Soporte para SPA
El módulo de sustitución de teléfono usa un MutationObserver para vigilar elementos añadidos dinámicamente. Si su sitio web está construido con React, Vue, Angular o cualquier framework que renderiza contenido después de la carga de la página — el tracker detecta nuevos elementos de teléfono a medida que aparecen en el DOM y los sustituye automáticamente. El observador vigila todo el cuerpo del documento en busca de:- Nuevos enlaces
<a href="tel:..."> - Nuevos elementos con atributo
data-revol-phone
Reglas de Coincidencia
Las reglas de sustitución de teléfono se derivan de las campañas. Cada campaña con tanto Teléfono Original como Teléfono de Reemplazo establecidos crea una regla.Cómo Funciona la Coincidencia
El tracker compara los parámetros UTM del visitante contra los campos de coincidencia de la regla. Todos los campos no nulos deben coincidir exactamente (lógica AND):utm_source establecido pero utm_medium está vacío — solo la fuente necesita coincidir. Los campos vacíos se ignoran en la coincidencia.
Prioridad
Si múltiples campañas coinciden con los parámetros UTM de un visitante, se usa la primera regla coincidente. Las reglas se devuelven en orden de creación.Eventos de Sustitución de Teléfono
Cada sustitución de teléfono genera un eventophone_swap, rastreado una vez por sesión de visitante. El evento contiene:
- Registro de Actividad — como tipo de evento
phone_swapcon datos de origen/destino - Tabla de Rendimiento de Campañas — en la columna Sustituciones de Teléfono
- Detalles de sesión — en la línea de tiempo de eventos de la sesión del visitante
Casos de Uso
Seguimiento de llamadas de Google Ads
Seguimiento de llamadas de Google Ads
utm_source=google, utm_medium=cpc. Establezca el teléfono original como su número principal de negocio y el reemplazo como un número de seguimiento dedicado. Cada llamada de visitantes de Google Ads se atribuye a esta campaña.Resultado: Usted ve exactamente cuántas llamadas genera su inversión en Google Ads — en el mismo panel de control que conversaciones de chat, envíos de formularios y páginas vistas.Atribución multicanal
Atribución multicanal
| Campaña | Fuente | Número de Seguimiento |
|---|---|---|
| Google Brand | google / cpc | +380 44 111 1111 |
| Facebook Ads | facebook / paid | +380 44 222 2222 |
| Newsletter | newsletter / email | +380 44 333 3333 |
| Orgánico | — (sin sustitución) | Número original |
Marketing offline (impreso, vallas publicitarias)
Marketing offline (impreso, vallas publicitarias)
rvl_ref único. Agregue un número de teléfono dedicado. Cuando alguien llama al número del volante — usted sabe que vino del impreso, no digital. Combine con un código QR para seguimiento digital del mismo material.Seguimiento de socios y referidos
Seguimiento de socios y referidos
rvl_ref=partner_name y un número de seguimiento dedicado. Rastree exactamente cuántas llamadas genera cada socio — junto con sesiones, páginas vistas y conversaciones de IA.Pruebas A/B de páginas de destino
Pruebas A/B de páginas de destino
utm_content (por ejemplo, landing-v1 vs landing-v2), cada una con un número de seguimiento diferente. Compare los volúmenes de llamadas entre variantes de páginas de destino.Integración SIP
La Sustitución de Teléfono se vuelve significativamente más poderosa cuando se combina con integración de números SIP (VoIP). Cuando usa números de seguimiento SIP como reemplazos, todo el ciclo de vida de la llamada se captura dentro de Revol:El visitante ve el número de seguimiento SIP
El visitante llama al número SIP
La llamada se graba y analiza
Lo Que Obtiene
Con la Sustitución de Teléfono + integración SIP combinadas, tiene un pipeline completo de atribución de llamadas:| Dato | Fuente |
|---|---|
| Qué campaña trajo al visitante | Parámetros UTM → Coincidencia de campaña |
| Qué páginas vio el visitante antes de llamar | Flujo de páginas de la sesión |
| Cuánto tiempo pasó en el sitio | Duración de la sesión |
| Qué dijeron en la llamada | Grabación de llamada VoIP + transcripción |
| Calidad del lead e intención | Análisis de IA de la llamada |
| Qué número de seguimiento llamaron | Datos del evento de sustitución de teléfono |
| Costo por llamada (si se conoce la inversión publicitaria) | Atribución de campaña + datos de plataforma publicitaria |
Mejores Prácticas
Use números dedicados por campaña
Use números dedicados por campaña
Agregue data-revol-phone a todos los elementos de teléfono
Agregue data-revol-phone a todos los elementos de teléfono
tel: (que se detectan automáticamente), agregar data-revol-phone previene cualquier parpadeo del número original antes de que se complete la sustitución.Mantenga el número original consistente
Mantenga el número original consistente
Pruebe con parámetros UTM
Pruebe con parámetros UTM
?utm_source=google&utm_medium=cpc) y verifique que el número cambia. Revise el Registro de Actividad para el evento phone_swap.Detalles Técnicos
| Detalle | Valor |
|---|---|
| Módulo | tracker/modules/phone-swap.js — cargado de forma diferida solo cuando existen reglas |
| Coincidencia | Coincidencia exacta en todos los campos UTM no nulos (lógica AND) |
| Detección | Enlaces <a href="tel:..."> + elementos [data-revol-phone] |
| Soporte SPA | MutationObserver en document.body (childList + subtree) |
| Prevención de parpadeo | CSS visibility: hidden en [data-revol-phone] hasta la sustitución |
| Seguimiento de eventos | Un evento phone_swap por sesión (solo primera sustitución) |
| Actualización de configuración | Cada 5 minutos vía sondeo de configuración en segundo plano |
| Normalización de números | Elimina espacios, guiones, paréntesis, puntos antes de la comparación |


