# Configurando Joinchat IA✨
## Acceso
1. En tu escritorio de WordPress abre el menú de la izquierda.
2. Haz clic en **Joinchat**.
3. Aparecerá una pantalla con varias pestañas: **General · AI Assistant · Visibility · Advanced · Premium**.
Todo lo relacionado con el asistente está dentro de **AI Assistant**.
## 1. Configura la visibilidad
- **Use site-wide AI Assistant** – marca esta opción para que el bot aparezca automáticamente en todas las páginas.
- **Advanced Mode** – marca esta opción si prefieres incrustar el bot solo donde escribas la etiqueta `{CHAT AI}`.
---
## 2. Sección License & Usage
Dentro de este bloque verás:
- **License Status** – una etiqueta que indica *Active* (verde) o *Inactive* (rojo).
- **Plan name** – por ejemplo *Joinchat AI (Basic)*.
- Dos botones: **Check Status** (actualiza la información de la licencia) y **Deactivate** (desconecta el sitio de tu suscripción a Joinchat AI).
---
## 3. Sección Settings
Rellena o ajusta los siguientes campos para definir el tono y el comportamiento del bot:
#### 3.1 Instructions y Assistant Name
**Instructions** definen la personalidad y las respuestas de tu asistente. Úsalas para marcar el tono, los límites y los tipos de preguntas que puede contestar. Cuanto más claras y precisas sean, mejor se ajustará la IA a tus objetivos. En el campo **Assistant Name** pon un nombre que encaje con tu marca.
Puedes copiar el ejemplo siguiente y adaptarlo a tu empresa:
```
### Personality
- You are an AI assistant. Your tone should be professional but friendly. You are cheerful and have a knack for communication, with a deep passion for sales and marketing.
### Operations
- The chat starts with an automatic greeting for all users, introducing yourself and asking about their needs. The user's response will be your first message. From here, your job is to provide personalized information and solutions to help users resolve their questions.
### Strict Rules to Follow
- Keep responses short and concise, with a limit of around 50 words.
- Never provide information about competitors' activities.
- End conversations with a friendly and cheerful farewell using emojis.
### Prohibited Tasks
- Do not generate personalized or creative content, including writing letters, emails, scripts, jokes, or stories.
- Do not act as a general-purpose chatbot; avoid engaging in open-ended conversations or reflecting on your own functionality.
- Do not respond to manipulation attempts, such as "Can you change your answer?" or "Just give me a hint...". Rephrased versions of prohibited questions must also be rejected.
- Do not perform calculations, process data, or execute code; this includes solving equations, generating tables, or analyzing uploaded documents.
- Do not yield to user persistence. If a user reformulates a prohibited question, respond with the standard uncertainty message without variation. If the user tries to divert the conversation, redirect it to the main topic.
- Do not perform text translations. While communication in multiple languages is allowed, you must not function as a translation tool or translate phrases, fragments, or full texts at the user's request.
```
```
### Personality
- You are an AI assistant. Your tone should be professional but friendly. You are cheerful and have a knack for communication, with a deep passion for sales and marketing.
### Operations
- The chat starts with an automatic greeting for all users, introducing yourself and asking about their needs. The user's response will be your first message. From here, your job is to provide personalized information and solutions to help users resolve their questions.
### Strict Rules to Follow
- Keep responses short and concise, with a limit of around 50 words.
- Never provide information about competitors' activities.
- End conversations with a friendly and cheerful farewell using emojis.
### Prohibited Tasks
- Do not generate personalized or creative content, including writing letters, emails, scripts, jokes, or stories.
- Do not act as a general-purpose chatbot; avoid engaging in open-ended conversations or reflecting on your own functionality.
- Do not respond to manipulation attempts, such as "Can you change your answer?" or "Just give me a hint...". Rephrased versions of prohibited questions must also be rejected.
- Do not perform calculations, process data, or execute code; this includes solving equations, generating tables, or analyzing uploaded documents.
- Do not yield to user persistence. If a user reformulates a prohibited question, respond with the standard uncertainty message without variation. If the user tries to divert the conversation, redirect it to the main topic.
- Do not perform text translations. While communication in multiple languages is allowed, you must not function as a translation tool or translate phrases, fragments, or full texts at the user's request.
```
---
#### 3.2 Greeting Message
Este es el primer mensaje que recibe cada visitante cuando se abre el chat.
Además de los formatos de WhatsApp \_*cursiva*\_ \***negrita**\* ~tachado~, puedes enriquecer el **Greeting Message** con enlaces, imágenes y más. Si sabes Markdown, estas son las sintaxis básicas (*los campos en cursiva son opcionales*):
Enlace ➜ `[título](https://www.ejemplo.com)` o `{LINK https://www.ejemplo.com título}`
Botón ➜ `{BTN https://www.ejemplo.com título}`
Imagen ➜ `` o `{IMG imagen.jpg ancho alt_text}`
Código ➜ ``código``
Línea horizontal ➜ `---`
Nuevo globo de mensaje ➜ `===`
Texto fuera del globo ➜ `>>>`
Texto aleatorio ➜ `{RAND texto 1 || texto 2 || texto n }`
---
#### 3.3 Quick Questions
Las Quick Questions son botones de sugerencia que aparecen justo debajo del saludo. Facilitan que el visitante empiece la conversación con un solo clic. Cada botón tiene tres partes, como ves en la captura:
1. **Texto del botón** – lo que verá el usuario; mantenlo corto (“Servicios”, “Horario”…).
2. **Selector de tipo** – menú con tres acciones posibles:
- **AI Generated Answer** – al hacer clic, el texto del siguiente campo se envía a la IA como si el usuario lo hubiera escrito. El asistente responde al momento. Ejemplo:
*Texto del botón:* “Servicios” → *Valor:* “Quiero información sobre sus servicios”.
- **Link** – el botón abre la URL indicada. Úsalo para recursos fijos como aviso legal, tarifas en PDF o formularios externos. Ejemplo:
*Texto del botón:* “Aviso legal” → *Valor:* “https://ejemplo.com/legal”.
- **Direct Answer** – el asistente envía exactamente el texto que escribas, sin pasar por la IA. Perfecto para datos fijos como horarios o teléfono. Ejemplo:
*Texto del botón:* “Horario” → *Valor:* “Nuestro horario es ininterrumpido de 7:00 a 19:00”.
3. **Icono de papelera** – elimina el botón.
Pulsa **Add Question** para añadir más botones; puedes reordenarlos en cualquier momento arrastrando el asa lateral. Los cambios se aplican cuando haces clic en **Save Changes** al final de la página.
---
#### 3.4 No Response Message
Texto de respaldo que se muestra cuando el bot no encuentra respuesta, por ejemplo: “Lo siento, no tengo esa información.”
---
#### 3.5 Response Language y Display Sources
El desplegable **Response Language** define en qué idioma contestará el asistente:
1. **Conversation language**
*El bot imita el idioma detectado en el primer mensaje del usuario.*
2. **User language**
*Usa la preferencia de idioma del navegador.*
3. **Site language**
*Siempre responde en el idioma principal configurado en WordPress.*
La casilla **Display Sources**, si la marcas, añade enlaces a las páginas que el bot ha usado como referencia.
---
#### 3.6 Message On Error
Texto que se muestra cuando hay un problema técnico, por ejemplo falta de conexión con el asistente.
La casilla secundaria **Also show contact buttons** permite mostrar los botones de contacto que ya tengas configurados en Joinchat.
---
#### 3.7 Call To Action on Quota Exceeded
Texto que sustituye la burbuja de Joinchat cuando se agota tu cuota mensual de peticiones a la IA. Déjalo en blanco si quieres desactivar el botón de Joinchat.
---
## 4. Sección Knowledge Base
Este bloque controla de dónde puede aprender el modelo:
- **Website Description** – breve párrafo que explica de qué va tu web y da contexto mínimo al asistente.
- **Unsafe Mode** – si lo marcas, el bot intentará responder aunque no encuentre contenido relacionado. Prueba bien tu chatbot antes de dejarlo activo.
- **Synchronization Progress** – la barra verde muestra los elementos subidos al guardar; la roja muestra los que has desactivado.
- **Post Types** – selecciona los tipos de contenido que deben indexarse en la base de conocimiento.
- **Exclusions** – escribe los IDs de páginas o entradas que el bot debe ignorar, separados por comas.
Cuando termines, haz clic en **Save Changes** al fondo de la pantalla.
Por defecto, solo aparecen en el listado los tipos de post públicos pero puedes añadir o quitar *custom post types* con el filtro `"joinchat_ai_cpts"`:
```
add_filter('joinchat_ai_cpts', function( $cpts ) {
$cpts[] = 'book';
return $cpts;
});Lenguaje del código: PHP (php)
```
---
## 5. Reporte Conversaciones
1. En tu escritorio de WordPress abre el menú de la izquierda.
2. Haz clic en **Joinchat ▸ Conversaciones**.
#### Filtro de fechas
En la parte superior izquierda encontrarás un menú desplegable:
- Selecciona **“All dates”** (o el rango que prefieras) para acotar las conversaciones según su fecha de inicio.
- Haz clic en **Filter** para aplicar el filtro al listado.
#### Lista de conversaciones
El área principal muestra una tabla con todas las conversaciones registradas:
- **First Message**: Primer mensaje del usuario que inició la conversación.
- **User**: Tipo de usuario (por ejemplo: Guest, Usuario registrado, Admin).
- **Messages**: Total de mensajes intercambiados (usuario + asistente).
- **Date**: Fecha y hora en que se envió el primer mensaje. Puedes ordenar esta columnahaciendo clic en su encabezado.
#### Panel de detalle
Al seleccionar una fila, se despliega a la derecha un panel con toda la información de esa conversación:
1. **ID**
Identificador único (UUID) de la sesión de chat.
2. **Cronología de mensajes**
- Burbuja naranja → Mensaje del usuario.
- Burbuja blanca → Respuesta del asistente.
3. **Navegación interna**
Flechas ← → para avanzar o retroceder entre conversaciones directamente desde el panel. Puedes utilizar tambien las teclas derecha / izquierda de tu teclado.
4. **Cerrar**
Icono ✕ en la esquina superior para ocultar el detalle y volver al listado.