Skip to main content
Además de ejecutarse desde la consola de conversación interna, los asistentes de Devic pueden ponerse a disposición de los usuarios finales a través de distintos métodos.
Estas opciones permiten integrar el asistente en aplicaciones web, portales de clientes o sistemas corporativos, manteniendo el control total sobre su comportamiento y estilo.

​
Opciones de despliegue

Las principales alternativas para exponer un asistente son:
OpciónDescripciónIdeal para…
Widget embebido (Chat Widget)Permite integrar el asistente directamente en una página web mediante un fragmento de código JavaScript.Sitios web, portales de clientes, áreas privadas.
API ExecutionInvoca al asistente mediante peticiones HTTP a la API de Devic, ideal para integraciones programáticas.Aplicaciones internas o backend.
Consola de conversaciónEntorno interno para probar y depurar el comportamiento del asistente.Equipos técnicos y desarrolladores.

​
Configuración del Chat Widget

El Chat Widget es la forma más rápida de ofrecer tu asistente a los usuarios finales.
Se configura desde el menú de opciones del asistente, en el apartado Advanced Settings → Chat Widget. Acceso a la configuración del widget

​

Acceso a la configuración del widget Allí podrás habilitarlo y definir los dominios autorizados desde los que podrá usarse.

​
Campos principales

CampoDescripción
EnabledActiva el uso del asistente a través del widget.
Allowed SourcesLista de dominios (con http o https) desde los que puede cargarse el widget.
Welcome MessageMensaje inicial que verá el usuario al abrir el chat.
Style ConfigurationPersonaliza el tamaño, color y estilo visual del widget.

​
Inserción del widget en tu web

Una vez habilitado, Devic genera automáticamente el fragmento de código JavaScript que puedes copiar y pegar en tu sitio web.
Este fragmento inicializa el asistente y define su comportamiento dentro de la página. Por motivos de compatibilidad con el formato Markdown, no se muestran las etiquetas <script> reales, ya que podrían romper el renderizado.
A continuación se muestra una versión simplificada y segura del código: 
// Fragmento de ejemplo para inicializar el widget de Devic
const config = {
  containerId: "suntropyai-chat-widget",
  assistantId: "68d8e28195e45739d8ca41",
  context: {}, // Opcional: información que quieras pasar al asistente
  options: { defaultSize: "small" } // Tamaño inicial del widget
};

const container = document.createElement("div");
container.id = config.containerId;
document.body.appendChild(container);
window.initChatWidget(config);

// (El código real finaliza con </script>, omitido aquí por motivos de compatibilidad con Markdown)

​
Personalización y control de acceso

Devic permite restringir el uso del widget a dominios específicos mediante el campo Allowed Sources.
Esto garantiza que el asistente solo pueda cargarse desde las direcciones autorizadas (por ejemplo, https://tuempresa.com o *.intranet.local). También puedes ajustar el formato de respuesta del asistente mediante el apartado Response Format, usando definiciones JSON para estructurar la salida cuando sea necesario. Configuración avanzada del asistente con formato de respuesta

​
Supervisión del uso y costes

Todas las ejecuciones realizadas a través del widget, la API o la consola se registran en el panel de Cost Management, disponible desde el mismo menú de opciones del asistente. En él podrás ver:
  • Coste total y promedio diario.
  • Número de conversaciones ejecutadas.
  • Tokens de entrada y salida por día.
Panel de Cost Management del asistente

​
Buenas prácticas

  • Restringe los dominios permitidos para evitar uso no autorizado del widget.
  • Define un mensaje de bienvenida claro para guiar la interacción inicial.
  • Valida el comportamiento del asistente en la consola de conversación antes de publicarlo.
  • Supervisa el coste y optimiza prompts o modelos según el volumen de uso.
  • Usa API Execution cuando necesites control total del flujo o integración con tu backend

​
En resumen

ElementoPropósito
Chat WidgetIntegración visual y directa en webs o portales.
Allowed SourcesLimita los dominios desde los que puede cargarse el widget.
Response FormatDefine estructuras personalizadas de salida JSON.
Cost ManagementSupervisa costes, tokens y volumen de conversación.

​
Próximos pasos

Ejecución vía API

Descubre cómo lanzar y gestionar interacciones con tus asistentes directamente mediante la API pública de Devic.