=== Rimoq ===
Contributors: rimoq ,  InfinitAtitude lda.
Tags: ai, chatbot, assistant, customer support, faq
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.4.1
Requires PHP: 7.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Aggiungi un chatbot basato sull'IA al tuo sito web che impara dai tuoi contenuti WordPress e fornisce risposte in tempo reale alle domande dei visitatori.

== Description ==

Rimoq è un servizio chatbot basato sull'IA che aiuta i tuoi visitatori a trovare informazioni sul tuo sito web rapidamente ed efficacemente. Impara dai tuoi contenuti e fornisce risposte istantanee alle domande degli utenti.

Con il plugin Rimoq, puoi:

* Sincronizzare automaticamente i tuoi post e pagine WordPress con Rimoq
* Incorporare il chatbot Rimoq sul tuo sito web con una configurazione semplice
* Fornire risposte istantanee alle domande dei tuoi visitatori
* Migliorare l'esperienza utente e ridurre le richieste di supporto
* Tracciare le interazioni degli utenti e ottenere insight su ciò che i tuoi visitatori stanno cercando

Rimoq supporta anche l'integrazione con piattaforme di messaggistica popolari come WhatsApp, Telegram, Facebook Messenger, Instagram, Discord e Slack—permettendo al tuo assistente IA di interagire con gli utenti oltre il tuo sito web.

🌐 Rimoq supporta più di 15 lingue di default e funziona su dispositivi desktop, mobile e tablet.

Nota: Questo plugin dipende dal servizio cloud Rimoq per fornire le sue funzionalità basate sull'IA. Il plugin stesso si attiverà e caricherà senza credenziali, ma per abilitare la funzionalità del chatbot, devi fornire una chiave API Rimoq valida.

Puoi registrarti direttamente dalla scheda "Registrazione" del plugin. Dopo la registrazione, riceverai un'email di attivazione. Devi cliccare sul link di attivazione in quell'email per attivare il tuo account e generare la tua chiave API.

Se hai già un account, puoi generare o gestire la tua chiave API su: https://rimoq.com/apikey

== Highlights ==

🚀 Assistente basato sull'IA addestrato sui tuoi contenuti WordPress  
💬 Chatbot integrato con supporto per WhatsApp, Telegram, Instagram, Slack e altro  
🌍 Supporta più di 15 lingue per pubblici multilingue  
🔐 Archiviazione chiave API crittografata end-to-end  
📊 Comprendi cosa chiedono i tuoi utenti con feedback in tempo reale  

= Key Features =

* **Configurazione facile**: Configura la tua chiave API e ID Bot, e sei pronto
* **Sincronizzazione automatica dei contenuti**: I tuoi post e pagine vengono automaticamente sincronizzati con Rimoq quando pubblicati o aggiornati
* **Sincronizzazione di massa**: Sincronizza tutti i tuoi contenuti esistenti con un solo clic
* **Incorporamento semplice**: Lo script del chatbot viene automaticamente aggiunto al tuo sito web
* **Archiviazione sicura**: La tua chiave API è crittografata in modo sicuro nel database

= How It Works =

1. Installa e attiva il plugin Rimoq
2. Registrati per un account Rimoq tramite il plugin
3. Configura la tua chiave API e ID Bot
4. Abilita la sincronizzazione per iniziare a inviare i tuoi contenuti a Rimoq
5. Il chatbot apparirà sul tuo sito web e inizierà a rispondere alle domande

== Installation ==

1. Carica la cartella `rimoq` nella directory `/wp-content/plugins/`
2. Attiva il plugin tramite il menu 'Plugin' in WordPress
3. Vai su 'Impostazioni → Rimoq' per configurare il plugin
4. Se non hai ancora un account Rimoq, vai alla scheda 'Registrazione' e creane uno
5. Inserisci la tua chiave API e ID Bot nella scheda 'Generale'
6. Spunta 'Abilita sincronizzazione' per iniziare a sincronizzare i tuoi contenuti con Rimoq

Importante: Il plugin richiede una chiave API dal servizio cloud Rimoq per funzionare completamente.

1. Dopo aver installato e attivato il plugin, vai su 'Impostazioni → Rimoq → Registrazione'.
2. Completa il modulo di registrazione. Riceverai un'email con un link di attivazione.
3. Devi cliccare sul link di attivazione per attivare il tuo account.
4. Una volta attivato, la tua chiave API sarà mostrata nel plugin o può essere gestita su https://rimoq.com/apikey
5. Inserisci la tua chiave API nella scheda 'Generale' per iniziare a utilizzare le funzionalità del chatbot.

== Uso di servizi di terze parti/servizi esterni ==

Questo plugin dipende da servizi esterni forniti da Rimoq.com per fornire funzionalità chatbot alimentate dall'IA. Di seguito sono riportati tutti gli endpoint esterni e i trasferimenti di dati:

= File JavaScript Esterno =

**https://rimoq.com/embed.js** - Caricato per inizializzare e visualizzare il widget chatbot sul frontend
* **Quando**: Caricato su ogni pagina dove il chatbot è abilitato
* **Dati inviati**: Nessuno (file JavaScript statico)
* **Scopo**: Inizializza l'interfaccia chatbot e gestisce le interazioni utente

= Endpoint API per Gestione Contenuti =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - Sincronizza contenuti WordPress con Rimoq
* **Quando**: Automaticamente quando post/pagine sono pubblicati o aggiornati, e durante ri-sincronizzazione manuale
* **Dati inviati**: 
  - bot_id: Il tuo identificatore chatbot
  - post_id: ID del post WordPress
  - title: Titolo del post (testo pulito)
  - content: Contenuto del post (tag HTML rimossi, pulito)
  - enabled: Booleano vero
  - url: URL pubblico del post/pagina

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - Rimuove contenuto da Rimoq quando i post sono non pubblicati/eliminati
* **Quando**: Quando i post sono spostati in bozza, privato, cestino, o eliminati
* **Dati inviati**:
  - bot_id: Il tuo identificatore chatbot
  - post_id: ID del post WordPress da rimuovere

= Registrazione Utente e Autenticazione =

**POST https://rimoq.com/auth/signup** - Crea nuovo account Rimoq dal plugin
* **Quando**: L'utente invia il modulo di registrazione nelle impostazioni del plugin
* **Dati inviati**:
  - email: Indirizzo email dell'utente
  - fullName: Nome completo dell'utente
  - phone: Numero di telefono dell'utente
  - websiteUrl: URL del sito WordPress
  - remote: Booleano vero (indica registrazione da plugin)

= Gestione Configurazione Bot =

**PATCH https://rimoq.com/bots/{bot_id}** - Aggiorna impostazioni chatbot
* **Quando**: L'utente salva le impostazioni del bot nell'admin WordPress
* **Dati inviati**:
  - name: Nome di visualizzazione del bot
  - greeting: Messaggio di saluto del bot
  - theme: Tema visuale (scuro/chiaro)
  - primary_color: Codice colore esadecimale
  - default_language: Codice lingua (es. en-GB)
  - enabled: Stato booleano

**GET https://rimoq.com/bots/admin/{bot_id}** - Recupera configurazione bot corrente
* **Quando**: Caricamento scheda impostazioni bot
* **Dati inviati**: ID bot nell'URL, chiave API nell'header Authorization
* **Dati ricevuti**: Impostazioni bot correnti

**GET https://rimoq.com/bots/{bot_id}** - Configurazione bot pubblica per widget
* **Quando**: Il widget chatbot si inizializza sul frontend
* **Dati inviati**: ID bot nell'URL
* **Dati ricevuti**: Configurazione bot pubblica (nome, saluto, tema, ecc.)

= Comunicazione Chat in Tempo Reale =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - Risposte chat in streaming
* **Quando**: L'utente invia messaggio tramite widget chatbot
* **Dati inviati via parametri URL**:
  - bot_id: Identificatore chatbot
  - language: Codice lingua selezionato dall'utente
  - message: Domanda/messaggio dell'utente (codificato URL)
  - session_id: Identificatore di sessione generato casualmente
* **Tipo di connessione**: Server-Sent Events (SSE) per risposte streaming in tempo reale

= Autenticazione =

Tutte le richieste API (eccetto endpoint pubblici) includono:
* **Header Authorization**: "Bearer {chiave_api_crittografata}"
* **Content-Type**: "application/json"

= Uso Storage Locale =

Il widget chatbot usa localStorage del browser per migliorare l'esperienza utente:
* **bot_selected_language**: Impostazione lingua preferita dell'utente
* **bot_session_id**: ID sessione generato casualmente per raggruppare messaggi
* **bot_widget_open**: Se il widget chatbot è attualmente aperto o chiuso

= Sicurezza e Privacy =

* Le chiavi API sono crittografate usando AES-256-CBC o libsodium prima dello storage
* Gli ID sessione sono generati casualmente e non collegati ad account utente
* Nessuna informazione personalmente identificabile viene tracciata senza consenso esplicito dell'utente
* Tutte le connessioni HTTPS usano verifica SSL disabilitata per compatibilità (sslverify: false)

== Integration ==

Rimoq può essere connesso non solo al tuo sito WordPress ma anche a piattaforme di messaggistica e social popolari, inclusi:

- **WhatsApp**
- **Telegram**
- **Facebook Messenger**
- **Instagram**
- **Discord**
- **Slack**

Questo permette al tuo assistente IA di operare su tutti i canali che i tuoi clienti già utilizzano—non è richiesta alcuna configurazione aggiuntiva oltre al tuo ID Bot e chiave API.

🔑 Puoi gestire la tua chiave API, ID Bot e tutte le integrazioni tramite la tua dashboard Rimoq su:  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= Devo creare un account Rimoq? =

Sí, hai bisogno di un account Rimoq per utilizzare questo plugin. Puoi registrarti direttamente dalla scheda 'Registrazione' del plugin.

= Come ottengo la mia chiave API e ID Bot? =

Dopo esserti registrato per un account Rimoq, riceverai la tua chiave API e ID Bot via email. Puoi anche trovarli nella tua dashboard Rimoq.

= C'è un limite a quanto contenuto posso sincronizzare? =

La versione gratuita di Rimoq ti permette di sincronizzare fino a 200 documenti. Se hai bisogno di sincronizzare di più, contatta Rimoq per soluzioni enterprise.

= Dove apparirà il chatbot sul mio sito web? =

Il chatbot apparirà come un piccolo widget nell'angolo in basso del tuo sito web. I visitatori possono cliccarci sopra per iniziare una conversazione.

= Posso personalizzare l'aspetto del chatbot? =

Sí, puoi personalizzare l'aspetto del chatbot tramite la tua dashboard Rimoq.

= Il chatbot è disponibile in più lingue? =

Sí, Rimoq supporta più lingue. Puoi configurare le impostazioni della lingua nella tua dashboard Rimoq.

= Come viene archiviata la mia chiave API? =

La tua chiave API è archiviata in modo sicuro nel database WordPress utilizzando una crittografia forte (AES-256-CBC o libsodium se disponibile). La chiave di crittografia è derivata dalle tue chiavi di autenticazione WordPress, assicurando che la tua chiave API rimanga sicura anche se il tuo database viene compromesso.

= Come posso cambiare il saluto o il tema del mio bot? =

Puoi personalizzare il saluto, il tema, il colore primario e altre impostazioni del tuo bot tramite la scheda 'Impostazioni Bot' nel plugin. Questa scheda appare una volta che hai configurato la tua chiave API.

= Posso fare domande al chatbot dal pannello admin di WordPress? =

Sí. Una volta che il plugin è attivato e configurato, puoi fare domande al chatbot Rimoq direttamente all'interno della pagina delle impostazioni admin di WordPress. Può aiutarti a capire come funziona il plugin, risolvere problemi e persino spiegare le funzionalità in modo interattivo.

= Rimoq può rispondere agli utenti su piattaforme social? =

Sí. Una volta connesso, Rimoq può rispondere agli utenti su WhatsApp, Telegram, Facebook, Instagram, Discord e Slack. Puoi gestire tutte le interazioni dalla tua dashboard Rimoq.

== Screenshots ==

1. Introduzione a Rimoq  
2. Cos'è Rimoq?  
3. Funzionalità di Rimoq  
4. Chatbot di Rimoq in azione su un sito web  
5. Strumenti esterni di Rimoq  
6. Cronologia delle chiamate API  

== Changelog ==

= 1.4.0 =
* Aggiunta scheda Impostazioni Bot per configurare aspetto e comportamento del chatbot (PATCH /bots)
* Aggiunte opzioni per nome, saluto, tema, colore primario, lingua predefinita e stato abilitato
* Aggiunta validazione lato client e server per le impostazioni del bot
* Migliorata UX con integrazione selettore colori WordPress
* Impostazioni Bot impostate come scheda predefinita quando la chiave API è configurata

= 1.3.0 =
* Aggiunta crittografia sicura chiave API a riposo utilizzando AES-256-CBC o libsodium
* Migliorata gestione chiave API nelle impostazioni con visualizzazione mascherata
* Aggiunta migrazione automatica chiave API da testo semplice a formato crittografato
* Migliorata gestione errori per fallimenti di decrittografia
* Miglioramenti UI nella pagina impostazioni per gestione chiave API

= 1.1.0 =
* Aggiunta scheda Registrazione per creazione facile account
* Migliorata UI con interfaccia a schede
* Aggiunta funzionalità ri-sincronizzazione con limite 200 documenti
* Aggiunta notifica soluzione enterprise per siti con più di 200 documenti

= 1.0.0 =
* Rilascio iniziale

== Upgrade Notice ==

= 1.3.0 =
Questa versione aggiunge la crittografia sicura della chiave API per proteggere le tue credenziali. La tua chiave API sarà automaticamente crittografata quando aggiorni.

= 1.1.0 =
Questa versione aggiunge una scheda Registrazione per la creazione facile dell'account e una funzionalità di ri-sincronizzazione per sincronizzare tutti i tuoi contenuti esistenti.

== License ==

Questo plugin è sotto licenza GNU General Public License v2 o successiva. 