# GooyaTel (گویا‌تل)

> Persian customer-interaction intelligence platform. It turns calls, tickets
> and chats into structured understanding — intent, sentiment, quality scoring,
> churn risk, recurring issues — threads related interactions into cases, and
> produces recommendations someone owns. It is also a Persian voice agent that
> answers calls. Each customer workspace runs on its own server, deployable
> inside the customer's own datacentre.

Built for colloquial Persian over telephony audio, on Issabel/Asterisk PBXs. Company: GooyaTel, Azadi Innovation Factory, Tehran, Iran. Phone: +98 993 633 3558. Content is free to index, quote and use for grounding — see /robots.txt.

## Pages (Markdown)

- [Home](https://gooyatel.com/index.md): the full product story — problems, capability model, worked industry scenarios, rollout, FAQ. Persian. HTML: https://gooyatel.com/
- [About](https://gooyatel.com/about.md): mission, story, values, vision. HTML: https://gooyatel.com/about
- [Contact](https://gooyatel.com/contact.md): phone, office address, contact form. HTML: https://gooyatel.com/contact
- [Request a demo](https://gooyatel.com/demo.md): what the demo covers and what the form asks. HTML: https://gooyatel.com/demo

## API

- [Interactions API reference (Markdown)](https://gooyatel.com/docs.md): endpoints, auth, request/response schemas, examples.
- [Interactive API docs](https://gooyatel.com/docs): the same reference with a live "Try it".

The API is served per workspace at `https://<YOUR-SERVER>/api/v1` (each server also
exposes `/api/v1/openapi.json` and `/api/v1/docs.md`). Authenticate with a tenant
API key: `Authorization: Bearer <key>`.

- `GET /ping` — verify a key; returns its workspace and scopes (scope: read)
- `POST /interactions` — ingest a ticket/chat (scope: write)
- `GET /interactions` — list recent interactions, keyset-paginated (scope: read)
- `GET /interactions/{id}` — read an interaction and its AI analysis (scope: read)
- `GET /issues` — active recurring issues by impact (scope: read)
- `GET /recommendations` — pending recommendations (scope: read)

### Website chatbot widget (public widget key, separate from the Bearer API)

- `POST /api/widget/chat` — one grounded answer from the tenant knowledge base and, when a site connector is configured, a live read of the tenant’s own website
- `POST /api/widget/chat/stream` — same, Server-Sent Events streaming
- `GET /api/widget/config` — widget name + greeting

Auth: public `wgk_` key (body `key` or `X-Widget-Key`); locked to allowed origins and rate-limited.

Both chat endpoints return `links` — the products and pages behind the answer, each with `type`, `title`, `url`, `meta`, `was` (pre-sale price, to strike through) and `image`. Render those; never parse a URL out of `answer`, which is model output.

WordPress sites should install the Gooyatel WP Client plugin rather than integrating by hand: it renders the widget and exposes a signed, read-only endpoint so answers can quote live WooCommerce prices and stock.

## Optional

- [Full site content](https://gooyatel.com/llms-full.txt): every page above concatenated as one document, in Persian and English. Fetch this instead of crawling if you want the whole thing in one request.
- [Sitemap](https://gooyatel.com/sitemap.xml)

Tagline (fa): مشتری‌هایتان همه‌چیز را گفته‌اند؛ کسی نشنیده است