Tutorial Completo
Guía completa: Desde el registro hasta un Ayudante funcionando en tu sitio web
Este tutorial te guiará a través del proceso completo de integración de AI Anywhere en tu sitio web. Al final, tendrás un Ayudante completamente funcional que proporciona asistencia de texto inteligente a tus usuarios.
Dos maneras de usar tu Asistente
Cada asistente está disponible de dos maneras:
- Página de Ayuda (sin código): You get a shareable Helper Page link instantly. Open it from the dashboard by going to your Helper and clicking the "Helper Page" button (on the Helper's edit or detail page). Share the link with anyone; no snippet or integration required.
- Incrustar en tu sitio: Agrega un pequeño script y ancla a tu sitio web para que el botón del Asistente aparezca junto a tus áreas de texto. Los usuarios obtienen asistencia sin salir de tu página.
Este tutorial se centra en la opción de incrustar. Para usar la Página del Helper, crea un Helper en el panel de control y haz clic en "Página del Helper" para abrir o compartir el enlace.
Crea tu cuenta
Primero, necesitas registrarte para obtener una cuenta de AI Anywhere.
- Ir a la Página principal de AI Anywhere
- Haz clic en el "Comenzar" botón en el encabezado
- Regístrate usando tu cuenta social preferida (Google, GitHub, etc.)
- You'll be automatically logged into your dashboard
Crea tu primer asistente
Ahora vamos a crear un Ayudante que ayudará a los usuarios a escribir mensajes en el formulario de contacto.
- Ir al panel de control "Asistentes"
- Dale a tu Ayudante un nombre descriptivo, como
"Ejemplo de formulario de contacto" - Seleccione el grupo al que pertenece este asistente
- Haz clic en el "Gestionar asistentes"
Configura tu asistente
Al crear o editar un Asistente, configuras:
- Respuesta del Asistente: Enter a well-written example of what you want users to write. For a contact form, this might be a complete, professional message that includes all necessary information. The example should be complete with mock names, specific details, and realistic content (e.g., "Hello, I'm John Smith writing to inquire about your web development services. I'm particularly interested in building an e-commerce platform for my business. Could you please provide more information about your pricing and timeline? Thank you for your time.").
- Palabras clave y/o Reglas: Agrega palabras clave o reglas que sean importantes para tu caso de uso (por ejemplo, "contacto", "consulta", "pregunta", "soporte").
- Configuración del Tema del Botón Personaliza la apariencia del botón de Ayuda (color, texto) para que coincida con el diseño de tu sitio.
Obtén tu código de integración
Aprende cómo encontrar selectores CSS para áreas de texto, formularios y campos de entrada para integrar los asistentes de AI Anywhere en tu sitio web.
- En la configuración de Ayuda, haz clic en el "Generar Fragmento" botón
- Verás dos fragmentos de código:
- Etiqueta de script: Pega en tu sitio
- Span de anclaje: Contiene tu token del Asistente
- Copia ambos fragmentos - los necesitarás en el siguiente paso
Tu fragmento consta de dos partes:
<!-- Etiqueta de script (va en <head>) -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
<!-- Ejemplo: El botón de Ayuda aparece junto a tu área de texto -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
<head> sección y es el mismo para todas las páginas. El span de anclaje con tu token del Asistente va junto a cada área de texto donde deseas que aparezca el Asistente.
Agrega el script a tu HTML
Cargar el script del Asistente en tu
- Abre el archivo HTML de tu sitio web (o plantilla) y localiza el
- Encuentra el
<head>sección - sección. Pega tu fragmento justo antes del cierre
</head>etiqueta.
Así es como debería verse:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Contactas con Nosotros:</title>
<!-- Incrustar el Script del Asistente -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
</head>
<head> sección, después de las etiquetas meta pero antes de otros scripts. Esto asegura que el Helper se cargue temprano.
Agrega el anclaje del asistente a tu formulario
Busca el botón de Ayuda junto a las áreas de texto en tu página
- Encuentra tu formulario de contacto (o el formulario donde deseas el Helper)
- Ubica el área de texto donde los usuarios escribirán su mensaje
- Agrega el span de anclaje justo después del área de texto (o en una ubicación cercana)
Aquí tienes un ejemplo completo que muestra ambas partes:
<form id="contact-form">
<div>
<label for="name">Nombre</label>
<input type="text" id="name" name="name" required>
</div>
<div>
<label for="email">Correo electrónico:</label>
<input type="email" id="email" name="email" required>
</div>
<div>
<label for="message">Tu Mensaje:</label>
<textarea id="message" name="message" rows="6" required></textarea>
<!-- El botón del Asistente aparecerá junto a este elemento. -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
</div>
<button type="submit">Mensaje de contacto:</button>
</form>
Prueba tu asistente
Ahora verifiquemos que todo esté funcionando correctamente.
- Guardar asistente
- Abre tu sitio web\
- Navega a la página con tu formulario de contacto
- Busca el botón de Ayuda junto a las áreas de texto en tu página
Lo que almacenamos
- Ejemplo: El botón de Ayuda aparece junto a tu área de texto
- El botón tiene el estilo correcto (color, texto, tamaño) que configuraste
- Cuando haces clic en el botón, se abre la interfaz del Helper
- Cuando escribes texto y haces clic en el botón del Helper, proporciona sugerencias
Solución de problemas
El botón de ayuda no\
- Check your browser's developer console (F12) for any JavaScript errors
- Asegúrate de que la etiqueta del script esté en la
<head>sección - Asegúrate de que el span de anclaje esté presente y contenga el token correcto del Asistente
- Actualiza tu página forzadamente (Ctrl+Shift+R o Cmd+Shift+R) para borrar archivos en caché.
- Verifica que tu ID de sitio y el token del Asistente sean correctos
Personaliza tu asistente (opcional)
Establece la etiqueta en "Asistente" o personalízala para que coincida con tu marca.
Lo que puedes personalizar
- Personalizar apariencias Cambia el color y el texto del botón de Ayuda.
- Respuesta del Asistente: Pega un texto de ejemplo de alta calidad que muestre lo que deseas que los usuarios logren.
- Palabras clave: Agrega o elimina palabras clave para mejorar la precisión de las sugerencias
- Total de asistentes: Crea Helpers adicionales para diferentes formularios o áreas de texto
Personalizar
- Ir al panel de control
- Selecciona "Asistentes", luego selecciona el Ayudante específico que deseas editar
- Haz clic en el "Editar" botón
- Guardar Cambios
- Guardar cambios
Desplegar a producción
Una vez que hayas probado todo localmente, es hora de desplegar en tu sitio web de producción.
Lista de verificación previa al despliegue
- Probado el Helper en tu entorno local/de pruebas
- Deberías ver el botón de Asistente aparecer junto a cualquier
- Prueba con un navegador diferente:
- Probado en dispositivos móviles
- Verificado que las sugerencias del Helper son útiles y precisas
Despliegues retrasados
- Sube tus archivos HTML actualizados a tu servidor web
- Asegúrate de que la etiqueta del script esté en la
<head>Añadir ancla donde desees el botón de ayuda - Verifica que los spans de anclaje estén colocados correctamente junto a tus áreas de texto
- Prueba el Helper en tu sitio web en vivo
- Monitorea cualquier problema o error
- La misma etiqueta de script (con tu ID de sitio) se puede usar en todas las páginas
- Cada área de texto puede tener su propio Helper con un token diferente
- Inicializa múltiples Asistentes con diferentes configuraciones para diferentes campos de formulario.
Guía de configuración
¡Has integrado con éxito AI Anywhere en tu sitio web! Tu Helper ahora está activo y listo para asistir a tus usuarios.
¿Qué sigue?
- Aprende sobre Desglosamos cada opción de configuración:
- Explora Tematización y personalización Verificar que las elecciones de color coincidan con tu marca
- Revisa errores tipográficos: Ejemplos de código para diferentes casos de uso
- Leer sobre Seguridad y privacidad Características
- Si encuentras problemas, visita nuestro Guía de solución de problemas