Iframe Widget

Widget de chat embebido

get

El widget de Prometheo permite agregar un chat en vivo con IA directamente en tu sitio web. Los visitantes pueden interactuar con tu asistente sin salir de tu página.

Instalación:

Agrega el siguiente código HTML justo antes de cerrar la etiqueta </body> en tu sitio web:

<script
  src="https://app.prometheo.ai/widget.min.js"
  data-api-key="TU_API_KEY_AQUI"
  data-position="bottom-right"
></script>

Configuración:

El widget se puede configurar mediante atributos data-* en el tag script:

• data-api-key (requerido): Tu API key de iframe generada en el panel de Prometheo

• data-position (opcional): Posición del widget. Valores: "bottom-right" (default), "bottom-left"

• data-user-id (opcional): ID único del usuario si quieres identificarlo. Si no se proporciona, se genera automáticamente y se guarda en cookies

Características:

• Sincronización en tiempo real con Firebase

• Conversaciones persistentes por usuario

• Respuestas automáticas del asistente con IA

• Diseño responsive y moderno

• No requiere dependencias adicionales

Dominios permitidos:

Puedes configurar una lista de dominios permitidos en el panel de Prometheo para restringir desde qué sitios web se puede usar tu widget. Esto previene el uso no autorizado de tu API key.

Ejemplo con ID de usuario personalizado:

<script
  src="https://app.prometheo.ai/widget.min.js"
  data-api-key="iframe_abc123..."
  data-position="bottom-left"
  data-user-id="usuario_12345"
></script>

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

srcstringRequired

URL del script del widget

Example: https://app.prometheo.ai/widget.min.js

data-api-keystringRequired

API Key de tipo iframe generada en Prometheo

Example: iframe_41d94540acf37724405601c15f841bbb8b86d3f4a0469f5189599a96b4658727

data-positionstring · enumOptional

Posición del botón flotante del widget

Default: bottom-rightPossible values:

data-user-idstringOptional

ID personalizado del usuario (opcional). Si no se proporciona, se genera automáticamente

Example: usuario_12345

Responses

200

Script del widget cargado exitosamente

application/javascript

Responsestring

Código JavaScript del widget

get

/iframe/widget

HTTPcURLJavaScriptPython

GET /public/v1/iframe/widget?src=https%3A%2F%2Fapp.prometheo.ai%2Fwidget.min.js&data-api-key=iframe_41d94540acf37724405601c15f841bbb8b86d3f4a0469f5189599a96b4658727 HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Script del widget cargado exitosamente

text