Chat web
Poné el asistente de Wagend en tu sitio con una línea de código, con datos de contacto obligatorios y reglas por canal.
Actualizado:
El chat web es un widget que tu negocio pega en su propio sitio. Conversa con el mismo bot que WhatsApp (mismos horarios, precios y reservas), sin número ni aprobaciones de terceros. Las conversaciones llegan al mismo Inbox.
Si alojás Wagend vos mismo, el chat web viene apagado: se activa con PUBLIC_WEBCHAT_ENABLED=true en la API.
Instalar paso a paso
- Entrá como propietario a Configuración → Canales → Chat web.
- En Sitios permitidos agregá cada sitio donde lo vas a usar, uno por línea, con
https://y sin comodines ni rutas (por ejemplohttps://www.mitienda.com). Para probar en tu computadora se aceptahttp://localhost. - Elegí color principal, posición del botón, idioma por defecto y un título opcional (hasta 40 caracteres).
- Tocá Activar chat web. Recibís una clave publicable
wg_web_…y el código para pegar. - Pegá el snippet antes de
</body>en cada página donde quieras el chat:
<script src="https://wagend.app/widget.js" data-key="wg_web_…" defer></script>
Atributos opcionales: data-locale (pt, es o en; por defecto usa el idioma del navegador), data-offset-bottom (píxeles, para subir el botón si tu sitio tiene una barra fija abajo) y data-api (origen de la API, solo para entornos de prueba).
Si tocás Desactivar, el chat deja de funcionar y se cierran las conversaciones abiertas; al volver a activarlo recibís una clave nueva y tenés que actualizar el código.
En /demo/webchat hay una página de demostración donde pegás la clave y ves el widget funcionando.
Qué ve el visitante
- Un botón flotante que abre el chat (en el celular se abre a pantalla completa, respetando las zonas seguras), en portugués, español o inglés.
- Un chat breve a propósito: respuestas cortas que proponen reservar o seguir por WhatsApp. Desde la web el visitante es anónimo y cada respuesta cuesta.
- Si el bot le pide su ubicación (por ejemplo para una entrega), ofrece Usar mi ubicación, con consentimiento explícito.
- La conversación vive en la memoria de la página: al recargar empieza una nueva.
Datos de contacto obligatorios
Por defecto el bot no conversa hasta tener teléfono y email: ante cualquier mensaje responde un texto fijo (sin IA) y el chat muestra un mini formulario (teléfono con selector de país, en formato internacional, y email). Apenas se completa, el primer mensaje del visitante se procesa solo, sin que lo repita.
Los datos son declarados, no verificados: no identifican al visitante ni se unen a clientes existentes. Se guardan cifrados y se borran junto con la conversación vencida.
Reglas del bot por canal
En Canales → Reglas del bot por canal (propietario y gerente) elegís el canal (Chat web o WhatsApp) y definís:
| Regla | Qué hace | Chat web (por defecto) | WhatsApp (por defecto) |
|---|---|---|---|
| Datos que exige | Nombre, teléfono y/o email antes de conversar | teléfono y email | ninguno (el teléfono ya llega del canal) |
| Cuándo los pide | Desde el primer mensaje, después de unas respuestas, o nunca | desde el primer mensaje | nunca |
| Texto con el que los pide | Un texto fijo personalizable | el predeterminado | no aplica |
| Límite de respuestas | Tope de respuestas del bot por conversación | 6 | sin tope |
| Qué ofrece al llegar al límite | Continuar por WhatsApp y/o recibir la información por email | ambos | ninguno |
| Estilo del bot en el canal | Una preferencia de tono (hasta 500 caracteres) | respuestas cortas | ninguna |
Son reglas del proyecto: las aplica el servidor antes de invocar a la IA, aunque alguien use la API pública sin el widget. Al llegar al límite el bot deja de responder y de gastar IA, manda un mensaje fijo con las opciones y la conversación queda en el Inbox como "necesita seguimiento", con los datos que dejó el visitante. Si no hay WhatsApp conectado, esa opción no se ofrece.
Seguridad
- La clave publicable solo abre conversaciones anónimas: no da acceso al panel, a la API privada ni a datos de clientes. Se puede revocar cuando quieras.
- El negocio sale siempre de la clave; el widget nunca envía un identificador de negocio.
- Solo los sitios permitidos pueden usar el chat. Sin cookies.
- El chequeo del origen no es autenticación: solo protege contra otros sitios en un navegador. La protección real son los límites de uso.
- Hay topes de mensajes por conversación, por hora y por día. Al agotarse, el chat responde que esperes y la IA no se invoca.
- El texto del visitante se trata como dato no confiable, y el widget lo muestra siempre como texto plano.
- El chat solo responde: no envía mensajes proactivos.
- Podés pausar el bot o todo el canal si hace falta; con el canal pausado el widget se oculta.
API
Gestión (propietario): GET|PUT|DELETE /v1/webchat-site. Reglas por canal (propietario y gerente): GET /v1/bot/channel-policies y PUT /v1/bot/channel-policies/{channel}. Los endpoints públicos del widget están en el contrato OpenAPI bajo /v1/public/webchat.