> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Iegult tīmekļa logrīku

> Pievienojiet balss aģentu savai mārketinga vai atbalsta vietnei — tālruņa numurs nav nepieciešams.

Tīmekļa logrīks sniedz jūsu vietnes apmeklētājiem iespēju sākt sarunu ar balss aģentu, noklikšķinot, izmantojot pārlūkprogrammas mikrofonu. Tā ir atsevišķa JavaScript / React SDK ar savu [SDK atsauci](/lv/widget/overview) — šajā ceļvedī galvenā uzmanība pievērsta ThunderPhone puses iestatīšanai, kas nepieciešama logrīkam.

<Note>
  To visu varat izdarīt bez cURL: informācijas paneļa lapa **Tīmekļa logrīki**
  (`/dashboard/web-widgets`) izveido logrīku, iestata tā režīmu
  un aģentu, pārvalda atļautos domēnus un sniedz jums iegulšanas fragmentu.
</Note>

## Priekšnosacījumi

<Steps>
  <Step title="Izveidojiet aģentu">
    Aģents, kura uzvedne un balss darbosies logrīka sesijā. Iestatiet
    `widget_enabled: true` (noklusējuma vērtība).
  </Step>

  <Step title="Izvēlieties maršrutēšanas režīmu">
    * `mode="agent"` — viens statisks aģents katrai atslēgai. Vienkāršākais variants.
    * `mode="webhook"` — jūsu serveris izvēlas aģentu katram apmeklētājam, izmantojot
      [`web.incoming` tīmekļa aizķeri](/lv/webhooks/call-incoming). Izmantojiet to
      pieteiktiem lietotājiem, A/B testiem vai maršrutēšanai katrai lapai.
  </Step>

  <Step title="Norādiet atļautos domēnus">
    Publicējamās atslēgas ir piesaistītas izcelsmei. Jānorāda katrs resursdatora nosaukums,
    kurā tiks iegults logrīks. Lokālās izstrādes laikā `localhost` / `127.0.0.1`
    vienmēr ir atļauti.
  </Step>
</Steps>

## Izveidojiet publicējamu atslēgu

<CodeGroup>
  ```bash Static agent theme={null}
  curl -X POST https://api.thunderphone.com/v1/publishable-key \
    -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name":            "Marketing site (prod)",
      "mode":            "agent",
      "agent_id":        12,
      "allowed_domains": ["example.com", "*.example.com"]
    }'
  ```

  ```bash Dynamic via webhook theme={null}
  curl -X POST https://api.thunderphone.com/v1/publishable-key \
    -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name":            "Support (dynamic)",
      "mode":            "webhook",
      "webhook_url":     "https://example.com/thunderphone/widget-hook",
      "allowed_domains": ["support.example.com"]
    }'
  ```
</CodeGroup>

Atbildē ir iekļauta `key`, kas sākas ar `pk_live_...`. **Publicējamās
atslēgas pēc būtības ir publiskas** — tās var droši iekļaut jūsu priekšgala komplektā.
Visus laukus skatiet [publicējamo atslēgu atsaucē](/api-reference/publishable-keys).

<Warning>
  `allowed_domains` jāietver vismaz viens ieraksts. `*.example.com`
  atbilst apakšdomēniem (piemēram, `api.example.com`), bet **neatbilst**
  pamata domēnam. Pamata aizstājējzīmes, piemēram, `*` vai `*.*`, tiek noraidītas.
</Warning>

## Pievienojiet logrīku savai vietnei

Trīs integrācijas iespējas ir aprakstītas
[logrīka SDK dokumentācijā](/lv/widget/overview):

<CardGroup cols={3}>
  <Card title="React komponents" icon="react" href="/lv/widget/react">
    `<ThunderPhoneWidget publishableKey="pk_live_..." />`.
  </Card>

  <Card title="Headless āķis" icon="circle-nodes" href="/lv/widget/headless-hook">
    `useThunderPhone()` pielāgotām lietotāja saskarnēm.
  </Card>

  <Card title="CDN skripta tags" icon="code" href="/lv/widget/cdn-script-tag">
    `ThunderPhone.mount({...})` vietnēm bez komplektēšanas rīka.
  </Card>
</CardGroup>

Visas trīs pieņem vienu un to pašu `publishableKey` un attēlo mikrofona pogu
kopā ar zvana audio elementu.

Logrīka `context` tiek saīsināts līdz 12 000 rakstzīmēm (aptuveni 3400
tipiska angļu valodas teksta tokeniem) un tiek ieskaitīts
[uzvednes lieluma piemaksā](/lv/guides/billing-and-topups).

## Logrīka režīma tīmekļa aizķeres

Kad `mode="webhook"`, ThunderPhone katras sesijas sākumā izsauc jūsu `webhook_url`
ar `web.incoming` slodzi. Atgrieziet aģenta konfigurāciju, kuru vēlaties palaist
šim apmeklētājam — tā izmanto to pašu
[atbildes shēmu](/lv/webhooks/call-incoming) kā tālruņa
zvani:

```json theme={null}
{
  "prompt":  "You are a VIP concierge for Jane Doe.",
  "voice":   "john",
  "product": "storm-base",
  "tools":   [ /* per-customer tools */ ]
}
```

Uzvednē varat iekļaut kontekstu no savas sesijas (kurš klients pārlūko vietni,
kurā lapā viņš atrodas) un mainīt aģentus katrā ieviešanas posmā.

## Pārraugiet sesijas

Logrīka sesijas tiek rādītas sadaļā
[`GET /v1/calls`](/api-reference/calls#list-calls) ar
`direction="widget"` — ar tādu pašu transkriptu, ierakstu, vērtēšanu un
norēķiniem kā tālruņa zvaniem. Filtrējiet pēc `direction`, lai izveidotu tikai logrīkam paredzētu
paneli.

***

## Nākamās darbības

<CardGroup cols={2}>
  <Card title="Logrīka SDK atsauce" icon="window-maximize" href="/lv/widget/overview">
    React / hook / CDN integrācijas informācija.
  </Card>

  <Card title="Dinamiska konfigurācija katram zvanam" icon="bolt" href="/lv/guides/dynamic-call-config">
    Ieviesiet `mode="webhook"` plūsmu no sākuma līdz beigām.
  </Card>

  <Card title="Publicējamo atslēgu atsauce" icon="key" href="/api-reference/publishable-keys">
    Katrs atslēgas resursa lauks.
  </Card>

  <Card title="Mikrofona sesiju API" icon="microphone" href="/api-reference/mic-sessions">
    Izlaidiet logrīku; izmantojiet LiveKit tieši pielāgotām lietotāja saskarnēm.
  </Card>
</CardGroup>