IdiomaENES
ReactDisponible en Starter

Widget de chat React para tu aplicación

Un provider, un componente, un hook

@welcomeai/react envuelve el widget en los componentes que espera una aplicación React. Carga el script desde el CDN en vez de empaquetarlo, así que tu bundle no cambia y las correcciones te llegan sin que publiques una versión.

Qué hace

Fuera de tu bundle

Empaquetarlo metería Preact dentro de tu aplicación React y congelaría el widget en la versión que instalaste. Un script evita las dos cosas.

Las llamadas tempranas no se pierden

El provider encola lo que llames antes de que llegue el script y lo reproduce, así que un widget abierto al montar se comporta igual que uno abierto después.

Embebido o flotante

WelcomeAIWidget para la burbuja, WelcomeAIInline para un panel dentro de tu propio layout, WelcomeAITrigger para tu propio botón.

Cómo conectarlo

Leer la guía completa
  1. 1

    Instala el paquete

    pnpm add @welcomeai/react, o el equivalente en tu gestor de paquetes.

  2. 2

    Envuelve tu aplicación

    Pon WelcomeAIProvider cerca de la raíz con el id de tu widget.

  3. 3

    Coloca un componente

    WelcomeAIWidget para la burbuja flotante, o WelcomeAIInline donde lo quieras embebido.

  4. 4

    Autoriza tu dominio

    Añádelo a los dominios permitidos del widget para que se emita el token ligado a ese origen.

Preguntas que nos hacen

¿Funciona con Next.js?

Sí, en App Router y en Pages Router. Los componentes son de cliente, así que marca el archivo como tal.

¿Y si el script no carga?

Un fallo de carga no se cachea, así que un montaje posterior lo vuelve a intentar en vez de quedarse roto toda la sesión.

¿Puedo usarlo sin React?

Sí. El mismo widget es un script en cualquier página, y la API de JavaScript es la misma.

Para qué lo usan los equipos