Widget de WhatsApp
Instalación#
- 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.
- 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).
<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#
- Al cargar la página, el script guarda los
utm_*,gclid,fbclid, la página de entrada y el sitio de referencia. - 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. - 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-whatsappatributodata-yave-ignoreatributowindow.YaveWhatsApp.open()función<!-- 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#
- Abre tu sitio con
?utm_source=prueba&utm_medium=cpc&utm_campaign=PRUEBA. - 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. - 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ón | Resultado |
|---|---|
| Borra el código y escribe más de 30 minutos después | Sin 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 widget | No pasa por el widget. |
| Tiene el número guardado y escribe directo | Es 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.