Ricky logorickyDocs

Pon un chat en tu sitio web

Agrega el chat web de Ricky a tu sitio público o a un sitio interno de tu equipo.

El chat web pone una burbuja de chat en tu sitio. Lo que escriben los visitantes llega a Conversaciones como cualquier otro canal, y lo atienden tus agentes de IA y tu equipo. No necesitas una cuenta de Meta ni plantillas: puedes responder en cualquier momento.

Crea tu chat

  1. Abre Chat web.
  2. Escribe el nombre del chat, el saludo y elige el color y el idioma.
  3. En Sitios web permitidos, escribe las direcciones donde lo vas a usar, una por línea. Por ejemplo https://www.tuempresa.com. El chat solo carga en esos sitios.
  4. Elige quién puede usarlo:
    • Cualquier visitante, para tu sitio público.
    • Solo personas verificadas, para un sitio interno de tu equipo.
  5. Selecciona Crear chat. La vista previa muestra cómo se verá.

Instálalo en tu sitio

  1. En la pestaña Instalación, copia el código del paso 1.
  2. Pégalo en tu sitio antes de </body>, en todas las páginas donde quieras el chat.
  3. Abre tu sitio y confirma que aparece la burbuja.

Elige qué agente responde

Crea un workflow que se active cuando se abre una conversación en tu chat web y añade el paso Pasar a un agente IA. Sin ese paso, las conversaciones llegan a la bandeja y las responde tu equipo.

Sitios internos: solo personas verificadas

Con Solo personas verificadas, el chat abre únicamente si tu sitio identifica a la persona. Tu servidor firma un token JWT con el secreto de identidad que muestra la pestaña Instalación. El token lleva:

  • sub: el id de la persona en tu sitio.
  • name y email: opcionales; Ricky los usa para el contacto.
  • exp: cuándo vence. Usa unas horas, como máximo 30 días.

Tu página entrega el token al chat antes del código del chat:

<script>
  window.RickyWebchat = { identityToken: '<token firmado por tu servidor>' };
</script>

Guarda el secreto solo en tu servidor. Si se expone, genera uno nuevo desde Instalación: los tokens firmados con el anterior dejan de funcionar.

Límites

En el modo Cualquier visitante, cada visitante puede enviar hasta 8 mensajes por minuto y 150 por día, para que nadie gaste tus créditos de IA con mensajes automáticos. El modo Solo personas verificadas no tiene ese límite. Cada mensaje puede tener hasta 2,000 caracteres.

Apaga el chat

En Chat web, selecciona Apagar chat. El chat deja de cargar en tu sitio y las conversaciones siguen en la bandeja.

En esta página