Widget web de IA

La integración AI web widget (widget web de IA) te permite insertar una burbuja de chat de IA de Requiply en tu propia web. Los visitantes pueden hacer preguntas y el asistente responde con los datos públicos de tu organización en Requiply.

Esta página está en Settings → Integrations → AI web widget.

Quién responde a los visitantes

El interruptor AI assistant answers first (el asistente de IA responde primero) de esta página decide quién contesta en el widget:

• Activado (plan Advanced): el asistente responde con tu catálogo, tus precios y tu disponibilidad, crea reservas y, con la bandeja de entrada activada, pasa la conversación a tu equipo cuando el visitante pide hablar con una persona. Cómo hace ese traspaso se configura en la configuración de la bandeja de entrada omnicanal.
• Desactivado: todos los mensajes van directamente a tu equipo en Conversations, y las respuestas de tu equipo aparecen en el widget del visitante.

El interruptor se comparte con el chat del portal de clientes de la configuración del portal y se guarda al momento. En la bandeja de entrada, las conversaciones del widget llevan una insignia de burbuja de chat con la etiqueta Website widget (widget de la web).

Lo que ve el visitante en el widget:

• Formato en las respuestas del asistente. Texto en negrita, listas con viñetas (se muestran con •) y enlaces. Los enlaces se abren en una pestaña nueva.
• Un aviso cuando tu equipo toma el relevo. Cuando un mensaje del visitante va a tu equipo sin respuesta del asistente, por ejemplo después de un traspaso o mientras un miembro de tu equipo atiende el chat, el widget muestra Your message went to our team. A manager will reply here. (tu mensaje ha llegado a nuestro equipo y un responsable te contestará aquí). Aparece una vez por espera y solo vuelve a mostrarse después de la siguiente respuesta.
• Las respuestas de tu equipo aparecen en el mismo chat a medida que llegan.

Por qué importa el widget web

El widget da a los visitantes de tu web una forma de preguntar por tu negocio de alquiler por su cuenta, sin salir de tu web. Usa una clave pública del widget, una lista controlada de orígenes permitidos y el script del widget de chat de Requiply.

Usos habituales:

• Responder preguntas sobre sedes, opciones de envío, métodos de pago, detalles del catálogo y disponibilidad.
• Dar a los visitantes una forma rápida de preguntar por las opciones de alquiler antes de enviar una solicitud de reserva.
• Mantener el chat de la web alineado visualmente con el color de tu marca y el tema que prefieras.
• Permitir que los administradores renueven o revoquen la clave del widget si hay que sustituir la inserción.

Qué verás

Mientras no exista ninguna clave, la página muestra un estado vacío con Create widget key (crear la clave del widget). En los planes que no son Advanced, en esa misma zona aparece Upgrade to create widget key (cambia de plan para crear la clave del widget).

Cuando ya existe una clave, la página muestra:

• Widget key (clave del widget): la clave pública del sitio activa y la insignia de estado Active.
• Embed snippet (fragmento de inserción): el bloque de script que hay que pegar en tu web.
• Allowed origins (orígenes permitidos): los dominios de tu web en los que el widget puede cargarse.
• Styling (estilo): los controles de color principal, modo de color y estilo de las esquinas.
• Actions (acciones): regenerar la clave, revocarla y guardar los cambios.
• Preview (vista previa): una vista previa en directo, en un iframe, de la burbuja y el panel del chat.

Crear una clave del widget

Insertar el widget

Copia el Embed snippet y pégalo justo antes de la etiqueta de cierre </body> en cada página de tu web en la que deba aparecer la burbuja de chat.

<script>
  window.RequiplyWidget = {
    siteKey: "rq_widget_example",
    primaryColor: "#016E88",
    colorMode: "light",
    borderRadius: "round"
  };
</script>
<script async src="https://app.requiply.com/requiply-widget.js"></script>

El fragmento que genera Requiply incluye tu clave del sitio real y las opciones de estilo actuales.

Orígenes permitidos

Los orígenes permitidos controlan dónde se puede usar la clave pública del widget. Añade el origen exacto de cada web en la que deba aparecer la burbuja de chat.

No incluyas rutas como /pricing o /booking. El origen es solo el protocolo, el host y, si lo hay, el puerto.

Estilo

Los controles de estilo cambian tanto la configuración guardada del widget como la vista previa en directo.

Usa Reset to brand color (volver al color de marca) si quieres que el color principal vuelva a coincidir con el color de marca de la organización.

Regenerar o revocar una clave

Usa estas acciones cuando haya que renovar o desactivar la inserción.

Casos habituales

Poner en marcha el widget en una web

1. Ve a Settings → Integrations → AI web widget.
2. Pulsa Create widget key.
3. Añade los orígenes de tu web.
4. Elige el color principal, el modo de color y las esquinas.
5. Pulsa Save changes.
6. Copia el fragmento de inserción.
7. Pega el fragmento antes de </body> en cada página de tu web en la que deba aparecer el widget.
8. Abre la web y comprueba que aparece la burbuja de chat.

Añadir el widget a otro dominio

1. Añade el nuevo dominio en Allowed origins.
2. Pulsa Save changes.
3. Añade el mismo fragmento de inserción a la nueva web.

Renovar una clave filtrada o antigua

1. Pulsa Regenerate key.
2. Confirma el diálogo.
3. Copia el nuevo fragmento.
4. Sustituye el fragmento antiguo en tu web.

Solución de problemas

El widget no aparece Comprueba que la página incluye el fragmento generado, que la URL del script se carga y que el origen de la web actual está en Allowed origins.

El widget aparece en un dominio pero no en otro Añade cada origen exacto por separado. https://example.com y https://www.example.com son orígenes distintos.

La vista previa cambia pero la web no Pulsa Save changes y vuelve a cargar la web. Comprueba también que el fragmento de la web contiene los valores actuales de primaryColor, colorMode y borderRadius.

Los visitantes ven un error del asistente Vuelve a intentarlo pasados unos momentos. Si el problema continúa, comprueba que tu organización tiene créditos de IA disponibles en Uso de IA.