KayaAI logo Kaya AI
Sign in Start free

Documentation

Follow this guide aligned with the sections available in your Organization dashboard to configure the different capabilities of your intelligent agent.

Knowledge (Knowledge Base/Training)

Located in the Knowledge tab, it lets you provide specific context to Kaya AI so it can answer accurately about your operational or web data.

  • Import PDF Documents: Use the "Drag a PDF or click" area to process manuals and tables. The status at the top will show "Processing Knowledge...".
  • URL Crawling: As an alternative, extract navigational knowledge.
    • Manual URL(s): Enter page paths directly on separate lines.
    • Import from sitemap: Use the sitemap.xml link in your browser to ingest a full domain in seconds (limit up to 20 pages in test environments).

WhatsApp Web (Baileys)

The WhatsApp Web tab uses reverse engineering via QR code for a simple connection. This is a solution designed exclusively for demonstrations.

Unofficial Solution Warning: this integration may result in irreversible account blocks or bans by Meta if you automate large volumes. Prefer the Business API for production.

  1. Click "Request QR Code" (or "Request New QR" if the preview expires).
  2. Use your normal WhatsApp (tab: Linked Devices) and point it to the QR. The panel should show "Connected and active". The AI will forward and process messages in real time.
  3. You can pause the integration easily using the "Disconnect" button.

WA Business API (Meta)

In its respective tab, you can configure approved access to Meta channels with high scalability and transactional credibility.

  1. Create your connection in Meta Developers. Use the button on the right to copy your Webhook Callback URL (with the model: ext/api/webhooks/wa/[slug]).
  2. In Meta, confirm the webhook with Messages enabled, supplying the encoded string from your Webhook Secret (Verify Token).
  3. In the Kaya AI interface, complete the final step by declaring the keys:
    • Access Token (Permanent): the system access token from the Developer Console.
    • Phone Number ID: the isolated numeric identifier of the line in Meta Developers -> WhatsApp -> API Setup.
  4. Click "Save API settings".

Website Widget

Hosted in the Website Widget section, this tab enables the creation of a visually friendly webchat embed accessible remotely.

  1. Organization Photo: At the top, upload a representative image. It will appear in the external chat interface. You can remove it later in the same view.
  2. Allowed Domains: It is mandatory to ensure integrity through CORS by indicating which web domains are exempt from blocking (example: https://example.net). Each domain must be on its own line.
  3. Embed Script: Through the interface, you can export the tag in the format <script src=".../embed.js"></script> to paste before the closing </body> tag.

MCP Configuration (Overview)

Located below structured metrics such as Message Balance in the primary Overview tab, you can create advanced connections using the Model Context Protocol (MCP).

  1. Open the "Overview" tab and locate the lower "MCP Configuration" block.
  2. Fill the main tools server connection variable in the "SSE Server URL" field. This source will be available to the runtime algorithms.
  3. If the resource requires authentication, provide it on the right using two fields (Header, e.g. Authorization, and Value, e.g. Bearer ...).
  4. Submit via "Save MCP" ("Saving..."). The output will display "MCP settings saved."