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.xmlno 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.
- Clique em "Solicitar QR Code" (ou "Solicitar Novo QR" se a pré-leitura expirar).
- 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.
- 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.
- 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]).
- No Meta, confirme o Webhook com as Messages ativadas, fornecendo a string codificada do seu Webhook Secret (Verify Token).
- 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.
- 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.
- 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.
- 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. - 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").
- Aceda à aba "Visão Geral" e localize o bloco inferior "Configuração MCP".
- 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.
- Se o recurso possuir autenticação, declare à direita de forma granular em duas caixas (Header ex: Authorization e Valor ex: Bearer ...).
- Submeta em "Guardar MCP" ("A guardar..."). O output exibirá "Configurações MCP guardadas."