Captura de leads

Widget de WhatsApp

Un botón flotante de WhatsApp que conserva el origen de la visita. Entre tu página y WhatsApp no viaja ninguna cookie: el widget deja una marca en el mensaje para que, cuando la persona escriba, YAVE sepa de qué campaña, anuncio y página venía.

Instalación#

  1. El administrador crea el widget en el CRM, en Configuración → Widget WhatsApp: línea de WhatsApp, mensaje inicial, colores y, si quiere, un mini formulario que pide nombre y teléfono antes de abrir el chat.
  2. En Código de instalación copia el script de una línea y pégalo antes de </body> en todas las páginas del sitio (en WordPress, con un plugin de código en el pie de página o en el tema).
HTML
<script
  src="https://api.yavehome.com/api/v1/public/whatsapp-widget/mi-constructora/sitio-web/widget.js"
  async
></script>

El script siempre trae la configuración vigente: si el administrador cambia el color, el mensaje o la línea, tu sitio se actualiza solo en unos minutos, sin volver a pegar nada. Si el widget se desactiva, el botón desaparece.

Un solo widget por página

Si antes se instaló la versión inline (el bloque largo de código), bórrala al pegar la de una línea. Dos instalaciones dibujan dos botones.

Cómo se atribuye cada chat#

  1. Al cargar la página, el script guarda los utm_*, gclid, fbclid, la página de entrada y el sitio de referencia.
  2. Al tocar el botón, registra el clic y abre WhatsApp con el mensaje inicial más un código corto, por ejemplo Ref: A3F9.
  3. Cuando la persona envía el mensaje, YAVE reconoce el código, crea o actualiza el lead con la campaña de esa visita y borra el código del texto: ni el asesor ni la IA lo ven.

Si la persona borra el código antes de enviar, YAVE todavía puede atribuir el chat cuando es un lead nuevo y escribe por esa misma línea dentro de los 30 minutos siguientes al clic; en ese caso la atribución es probable, no exacta. Con el mini formulario activo, el lead se crea con su teléfono antes de abrir WhatsApp, y la atribución no depende del código.

Tus propios botones de WhatsApp#

El script intercepta automáticamente cualquier enlace de la página que lleve a WhatsApp con el número de la línea del widget (wa.me, api.whatsapp.com, web.whatsapp.com, whatsapp://): el botón "Cotizar" del encabezado o el CTA del banner quedan atribuidos sin tocarlos, y conservan su propio texto. Los enlaces a otros números no se modifican.

data-yave-whatsappatributo
Ponlo en cualquier elemento (un botón, una imagen, un div) para que abra el widget al hacer clic. Útil cuando el botón no es un enlace <a href>, por ejemplo un popup de Elementor.
data-yave-ignoreatributo
Ponlo en un enlace de WhatsApp que NO quieres que el widget rastree.
window.YaveWhatsApp.open()función
Abre el widget desde tu propio JavaScript (después de que el script cargó).
HTML
<!-- Un enlace normal: el widget lo intercepta solo -->
<a href="https://wa.me/573001234567?text=Quiero%20cotizar">Cotizar</a>

<!-- Un botón que no es enlace -->
<button data-yave-whatsapp>Hablar con un asesor</button>

<!-- Desde código -->
<script>
  document.querySelector("#cta").addEventListener("click", () => {
    window.YaveWhatsApp?.open();
  });
</script>

Prueba de humo#

  1. Abre tu sitio con ?utm_source=prueba&utm_medium=cpc&utm_campaign=PRUEBA.
  2. Toca el botón flotante y también uno de tus botones propios: WhatsApp debe abrir con el texto y la línea Ref: XXXX.
  3. Envía el mensaje desde un número de prueba. En el CRM, el lead debe aparecer con la campaña PRUEBA.

Límites#

SituaciónResultado
Borra el código y escribe más de 30 minutos despuésSin atribución de campaña.
Nunca envía el mensaje (y no hay mini formulario)No se crea lead: no hay a quién atribuir.
Escribe a un número distinto al de la línea del widgetNo pasa por el widget.
Tiene el número guardado y escribe directoEs un contacto orgánico: no vino por el sitio.
  • Si la organización prefiere que el prospecto no vea la línea Ref:, puede apagarla en el widget. La atribución queda solo por el mini formulario o por la ventana de 30 minutos.
  • Los chats que llegan desde anuncios de Meta "Clic a WhatsApp" no dependen del widget: traen su propia atribución de anuncio.

Sitios sin scripts externos

Si tu plataforma no permite cargar scripts de otro dominio, el CRM ofrece una versión inline (avanzada) que pegas completa. Ten en cuenta que esa versión no se actualiza sola: cuando cambie la configuración hay que volver a pegarla.