KayaAI logo Kaya AI

Documentação

Siga este guia alinhado diretamente com as secções disponíveis no painel da sua Organização para configurar as diferentes capacidades do seu agente inteligente.

Conhecimento (Knowledge Base/Treinamento)

Localizado na aba Conhecimento, permite dar contexto específico à IA do Kaya para que responda precisamente sobre a sua base de dados operacionais ou web.

  • Importar Documentos PDF: Use a área de "Arraste um PDF ou clique" para processar manuais e tabelas. O estado no topo indicará "Processando Conhecimento...".
  • Crawling de URLs: Em alternativa, extraia conhecimento navegacional.
    • URL(s) manual: Insira diretamente o caminho das páginas em linhas separadas.
    • Importar de sitemap: Utilize o link correspondente a sitemap.xml no seu explorador para ingerir um domínio completo em segundos (limite até 20 páginas em ambiente de teste).

WhatsApp Web (Baileys)

A aba WhatsApp Web recorre à engenharia inversa por código QR para efetuar uma ligação simples. Trata-se de uma solução desenhada exclusivamente para demonstrações.

Aviso de Solução não Oficial: Esta integração pode resultar no bloqueio e/ou baneamento irreversível da conta pela Meta caso automatize grandes volumes. Prefira a Business API para produção.

  1. Clique em "Solicitar QR Code" (ou "Solicitar Novo QR" se a pré-leitura expirar).
  2. Use o seu WhatsApp normal (Aba: 'Dispositivos Associados') e aponte para o QR. O painel deve sinalizar "Conectado e ativo". A IA reencaminhará e processará mensagens em tempo real.
  3. Pode pausar a integração facilmente no botão de "Desconectar".

WA Business API (Meta)

Na aba respectiva (WA Business API), pode configurar o acesso aprovado aos Canais Meta de elevada escalabilidade e credibilidade transacional.

  1. Crie a sua ligação no Meta Developers. Utilize o botão à direita para copiar o seu Webhook Callback URL (com o modelo: ext/api/webhooks/wa/[slug]).
  2. No Meta, confirme o Webhook com as Messages ativadas, fornecendo a string codificada do seu Webhook Secret (Verify Token).
  3. Na interface do Kaya AI, acautele o passo final declarando as chaves:
    • Access Token (Permanente): O Token de sistema de acesso à Developer Console.
    • Phone Number ID: Identificador isolado numérico da linha em Meta Developers → WhatsApp → API Setup.
  4. Clique em "Guardar definições API".

Widget para Site

Hospedada na secção Widget para Site, esta aba viabiliza a criação de um Webchat Embed (visualmente amigável) acessível remotamente.

  1. Foto da Organização: No topo, efetue upload de uma imagem representativa. Ela passará a figurar na interface de chat externa. Pode removê-la mais tarde na mesma view.
  2. Domínios permitidos: É estritamente mandatário garantir a integridade via CORS indicando quais domínios web estão isentos de bloqueio (ex: https://exemplo.net). Cada domínio deve ocupar a sua própria linha de texto.
  3. Script de incorporação: Recorrendo ao interface, pode exportar a tag em formato <script src=".../embed.js"></script> copiando para colar a linha anterior de </body>.

Configuração MCP (Visão Geral)

Localizado debaixo de métricas estruturadas como **Saldo de Mensagens** na aba primária Visão Geral, pode criar interligações avançadas recorrendo ao Model Context Protocol ("MCP").

  1. Aceda à aba "Visão Geral" e localize o bloco inferior "Configuração MCP".
  2. Preencha a variável principal da interligação do Servidor de Ferramentas, no campo URL do Servidor SSE. Esta fonte far-se-á audível aos algoritmos em runtime.
  3. Se o recurso possuir autenticação, declare à direita de forma granular em duas caixas (Header ex: Authorization e Valor ex: Bearer ...).
  4. Submeta em "Guardar MCP" ("A guardar..."). O output exibirá "Configurações MCP guardadas."