=== 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

Adicione um chatbot baseado em IA ao seu website que aprende com o seu conteúdo WordPress e fornece respostas em tempo real às perguntas dos visitantes.

== Description ==

Rimoq é um serviço de chatbot baseado em IA que ajuda os seus visitantes a encontrar informações no seu website de forma rápida e eficiente. Aprende com o seu conteúdo e fornece respostas instantâneas às perguntas dos utilizadores.

Com o plugin Rimoq, pode:

* Sincronizar automaticamente as suas publicações e páginas WordPress com Rimoq
* Incorporar o chatbot Rimoq no seu website com uma configuração simples
* Fornecer respostas instantâneas às perguntas dos seus visitantes
* Melhorar a experiência do utilizador e reduzir pedidos de apoio
* Rastrear interações dos utilizadores e obter insights sobre o que os seus visitantes estão a procurar

Rimoq também suporta integração com plataformas de mensagens populares como WhatsApp, Telegram, Facebook Messenger, Instagram, Discord e Slack—permitindo que o seu assistente IA interaja com utilizadores para além do seu website.

🌐 Rimoq suporta mais de 15 idiomas por padrão e funciona em dispositivos desktop, móveis e tablets.

Nota: Este plugin depende do serviço cloud Rimoq para fornecer as suas funcionalidades baseadas em IA. O plugin em si activar-se-á e carregará sem credenciais, mas para activar a funcionalidade do chatbot, deve fornecer uma chave API Rimoq válida.

Pode registar-se directamente através do separador "Registo" do plugin. Após o registo, receberá um email de activação. Deve clicar no link de activação nesse email para activar a sua conta e gerar a sua chave API.

Se já tem uma conta, pode gerar ou gerir a sua chave API em: https://rimoq.com/apikey

== Highlights ==

🚀 Assistente baseado em IA treinado no seu conteúdo WordPress  
💬 Chatbot incorporado com suporte para WhatsApp, Telegram, Instagram, Slack, e mais  
🌍 Suporta mais de 15 idiomas para audiências multilingues  
🔐 Armazenamento de chave API encriptada ponta-a-ponta  
📊 Compreenda o que os seus utilizadores perguntam com feedback em tempo real  

= Key Features =

* **Configuração fácil**: Configure a sua chave API e ID do Bot, e está pronto
* **Sincronização automática de conteúdo**: As suas publicações e páginas são automaticamente sincronizadas com Rimoq quando publicadas ou actualizadas
* **Sincronização em massa**: Sincronize todo o seu conteúdo existente com um clique
* **Incorporação simples**: O script do chatbot é automaticamente adicionado ao seu website
* **Armazenamento seguro**: A sua chave API é encriptada de forma segura na base de dados

= How It Works =

1. Instale e active o plugin Rimoq
2. Registe-se para uma conta Rimoq através do plugin
3. Configure a sua chave API e ID do Bot
4. Active a sincronização para começar a enviar o seu conteúdo para Rimoq
5. O chatbot aparecerá no seu website e começará a responder às perguntas

== Installation ==

1. Carregue a pasta `rimoq` para o directório `/wp-content/plugins/`
2. Active o plugin através do menu 'Plugins' no WordPress
3. Vá a 'Definições → Rimoq' para configurar o plugin
4. Se ainda não tem uma conta Rimoq, vá ao separador 'Registo' e crie uma
5. Introduza a sua chave API e ID do Bot no separador 'Geral'
6. Marque 'Activar sincronização' para começar a sincronizar o seu conteúdo com Rimoq

Importante: O plugin requer uma chave API do serviço cloud Rimoq para funcionar completamente.

1. Após instalar e activar o plugin, vá a 'Definições → Rimoq → Registo'.
2. Complete o formulário de registo. Receberá um email com um link de activação.
3. Deve clicar no link de activação para activar a sua conta.
4. Uma vez activada, a sua chave API será mostrada no plugin ou pode ser gerida em https://rimoq.com/apikey
5. Introduza a sua chave API no separador 'Geral' para começar a usar as funcionalidades do chatbot.

== Uso de serviços de terceiros/serviços externos ==

Este plugin depende de serviços externos fornecidos por Rimoq.com para fornecer funcionalidade de chatbot alimentada por IA. Abaixo estão todos os endpoints externos e transferências de dados:

= Ficheiro JavaScript Externo =

**https://rimoq.com/embed.js** - Carregado para inicializar e exibir o widget chatbot no frontend
* **Quando**: Carregado em cada página onde o chatbot está ativado
* **Dados enviados**: Nenhum (ficheiro JavaScript estático)
* **Propósito**: Inicializa a interface do chatbot e gere interações do utilizador

= Endpoints API para Gestão de Conteúdo =

**POST https://rimoq.com/bots/{bot_id}/sources/sync** - Sincroniza conteúdo WordPress com Rimoq
* **Quando**: Automaticamente quando publicações/páginas são publicadas ou atualizadas, e durante re-sincronização manual
* **Dados enviados**: 
  - bot_id: O seu identificador de chatbot
  - post_id: ID da publicação WordPress
  - title: Título da publicação (texto limpo)
  - content: Conteúdo da publicação (tags HTML removidas, limpo)
  - enabled: Booleano verdadeiro
  - url: URL pública da publicação/página

**POST https://rimoq.com/bots/{bot_id}/sources/syncDelete** - Remove conteúdo do Rimoq quando publicações são despublicadas/eliminadas
* **Quando**: Quando publicações são movidas para rascunho, privado, lixo, ou eliminadas
* **Dados enviados**:
  - bot_id: O seu identificador de chatbot
  - post_id: ID da publicação WordPress a remover

= Registo de Utilizador e Autenticação =

**POST https://rimoq.com/auth/signup** - Cria nova conta Rimoq a partir do plugin
* **Quando**: Utilizador submete formulário de registo nas definições do plugin
* **Dados enviados**:
  - email: Endereço de email do utilizador
  - fullName: Nome completo do utilizador
  - phone: Número de telefone do utilizador
  - websiteUrl: URL do site WordPress
  - remote: Booleano verdadeiro (indica registo a partir do plugin)

= Gestão de Configuração do Bot =

**PATCH https://rimoq.com/bots/{bot_id}** - Atualiza definições do chatbot
* **Quando**: Utilizador guarda definições do bot no admin WordPress
* **Dados enviados**:
  - name: Nome de exibição do bot
  - greeting: Mensagem de saudação do bot
  - theme: Tema visual (escuro/claro)
  - primary_color: Código de cor hexadecimal
  - default_language: Código de idioma (ex. en-GB)
  - enabled: Estado booleano

**GET https://rimoq.com/bots/admin/{bot_id}** - Recupera configuração atual do bot
* **Quando**: Carregamento do separador de definições do bot
* **Dados enviados**: ID do bot no URL, chave API no cabeçalho Authorization
* **Dados recebidos**: Definições atuais do bot

**GET https://rimoq.com/bots/{bot_id}** - Configuração pública do bot para widget
* **Quando**: Widget chatbot inicializa no frontend
* **Dados enviados**: ID do bot no URL
* **Dados recebidos**: Configuração pública do bot (nome, saudação, tema, etc.)

= Comunicação de Chat em Tempo Real =

**SSE https://rimoq.com/chat/{bot_id}/stream/{language}** - Respostas de chat em streaming
* **Quando**: Utilizador envia mensagem através do widget chatbot
* **Dados enviados via parâmetros URL**:
  - bot_id: Identificador do chatbot
  - language: Código do idioma selecionado pelo utilizador
  - message: Pergunta/mensagem do utilizador (codificada URL)
  - session_id: Identificador de sessão gerado aleatoriamente
* **Tipo de ligação**: Server-Sent Events (SSE) para respostas streaming em tempo real

= Autenticação =

Todos os pedidos API (exceto endpoints públicos) incluem:
* **Cabeçalho Authorization**: "Bearer {chave_api_encriptada}"
* **Content-Type**: "application/json"

= Uso de Armazenamento Local =

O widget chatbot usa localStorage do navegador para melhorar a experiência do utilizador:
* **bot_selected_language**: Definição de idioma preferido do utilizador
* **bot_session_id**: ID de sessão gerado aleatoriamente para agrupar mensagens
* **bot_widget_open**: Se o widget chatbot está atualmente aberto ou fechado

= Segurança e Privacidade =

* Chaves API são encriptadas usando AES-256-CBC ou libsodium antes do armazenamento
* IDs de sessão são gerados aleatoriamente e não ligados a contas de utilizador
* Nenhuma informação pessoalmente identificável é rastreada sem consentimento explícito do utilizador
* Todas as ligações HTTPS usam verificação SSL desativada para compatibilidade (sslverify: false)

== Integration ==

Rimoq pode ser ligado não só ao seu site WordPress mas também a plataformas de mensagens e sociais populares, incluindo:

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

Isto permite que o seu assistente IA opere em todos os canais que os seus clientes já utilizam—não é necessária configuração adicional para além do seu ID do Bot e chave API.

🔑 Pode gerir a sua chave API, ID do Bot e todas as integrações através do seu painel Rimoq em:  
https://rimoq.com/dashboard

== Frequently Asked Questions ==

= Preciso de criar uma conta Rimoq? =

Sim, precisa de uma conta Rimoq para usar este plugin. Pode registar-se directamente através do separador 'Registo' do plugin.

= Como obtenho a minha chave API e ID do Bot? =

Após registar-se para uma conta Rimoq, receberá a sua chave API e ID do Bot por email. Também pode encontrá-los no seu painel Rimoq.

= Há um limite para quanto conteúdo posso sincronizar? =

A versão gratuita do Rimoq permite sincronizar até 200 documentos. Se precisar de sincronizar mais, contacte Rimoq para soluções empresariais.

= Onde aparecerá o chatbot no meu website? =

O chatbot aparecerá como um pequeno widget no canto inferior do seu website. Os visitantes podem clicar nele para iniciar uma conversa.

= Posso personalizar a aparência do chatbot? =

Sim, pode personalizar a aparência do chatbot através do seu painel Rimoq.

= O chatbot está disponível em múltiplos idiomas? =

Sim, Rimoq suporta múltiplos idiomas. Pode configurar as definições de idioma no seu painel Rimoq.

= Como é armazenada a minha chave API? =

A sua chave API é armazenada de forma segura na base de dados WordPress usando encriptação forte (AES-256-CBC ou libsodium se disponível). A chave de encriptação é derivada das suas chaves de autenticação WordPress, garantindo que a sua chave API permanece segura mesmo se a sua base de dados for comprometida.

= Como posso alterar a saudação ou tema do meu bot? =

Pode personalizar a saudação, tema, cor primária e outras definições do seu bot através do separador 'Definições do Bot' no plugin. Este separador aparece após configurar a sua chave API.

= Posso fazer perguntas ao chatbot a partir do painel admin do WordPress? =

Sim. Uma vez que o plugin está activado e configurado, pode fazer perguntas ao chatbot Rimoq directamente na página de definições do admin WordPress. Pode ajudá-lo a compreender como o plugin funciona, resolver problemas e até explicar funcionalidades de forma interactiva.

= Rimoq pode responder a utilizadores em plataformas sociais? =

Sim. Uma vez ligado, Rimoq pode responder a utilizadores no WhatsApp, Telegram, Facebook, Instagram, Discord e Slack. Pode gerir todas as interações através do seu painel Rimoq.

== Screenshots ==

1. Introdução ao Rimoq  
2. O que é o Rimoq?  
3. Funcionalidades do Rimoq  
4. Chatbot do Rimoq em funcionamento num site  
5. Ferramentas externas do Rimoq  
6. Histórico de chamadas API  

== Changelog ==

= 1.4.0 =
* Adicionado separador Definições do Bot para configurar aparência e comportamento do chatbot (PATCH /bots)
* Adicionadas opções para nome, saudação, tema, cor primária, idioma padrão e estado activado
* Adicionada validação do lado do cliente e servidor para definições do bot
* Melhorada UX com integração do selector de cores WordPress
* Definições do Bot definidas como separador padrão quando a chave API está configurada

= 1.3.0 =
* Adicionada encriptação segura da chave API em repouso usando AES-256-CBC ou libsodium
* Melhorada gestão da chave API nas definições com exibição mascarada
* Adicionada migração automática da chave API de texto simples para formato encriptado
* Melhorada gestão de erros para falhas de desencriptação
* Melhorias de UI na página de definições para gestão da chave API

= 1.1.0 =
* Adicionado separador Registo para criação fácil de conta
* Melhorada UI com interface por separadores
* Adicionada funcionalidade de re-sincronização com limite de 200 documentos
* Adicionada notificação de solução empresarial para sites com mais de 200 documentos

= 1.0.0 =
* Lançamento inicial

== Upgrade Notice ==

= 1.3.0 =
Esta versão adiciona encriptação segura da chave API para proteger as suas credenciais. A sua chave API será automaticamente encriptada quando actualizar.

= 1.1.0 =
Esta versão adiciona um separador Registo para criação fácil de conta e uma funcionalidade de re-sincronização para sincronizar todo o seu conteúdo existente.

== License ==

Este plugin está licenciado sob a GNU General Public License v2 ou posterior. 