---
title: "Naudokite ThunderPhone su n8n"
description: "Įdiekite ThunderPhone mazgą, skirtą n8n, prijunkite serverio API raktą ir sukurkite darbo eigą, kuri vykdoma kiekvieną kartą pasibaigus skambučiui."
---

[n8n](https://n8n.io) yra darbo eigų automatizavimo įrankis. „ThunderPhone“ paketas,
skirtas n8n, prideda du mazgus:

- **ThunderPhone Trigger** paleidžia darbo eigą, kai baigiasi skambutis (**Skambutis
  baigtas**) arba užbaigiamas skambučio vertinimas (**Skambutis įvertintas**).
- **ThunderPhone** inicijuoja išeinančius skambučius, prideda kontaktus prie kampanijų ir
  jas paleidžia, gauna skambučius su jų transkriptais ir įrašais bei pateikia jūsų
  agentų ir telefono numerių sąrašą.

Tai patvirtintas bendruomenės mazgas, pateikiamas
[ThunderPhone sistemoje n8n](https://n8n.io/integrations/thunderphone/).

## Įdiekite mazgą

n8n redaktoriuje spustelėkite **+**, kad atidarytumėte mazgų skydelį, ir ieškokite
**ThunderPhone**. Prieš kitiems naudotojams pridedant mazgus, egzemplioriaus savininkui
gali reikėti nustatyti patvirtintus mazgus.

Savo serveryje diegiamoje n8n versijoje taip pat galite įdiegti pagal paketo pavadinimą:
atidarykite **Nustatymai > Bendruomenės mazgai** ir įdiekite `n8n-nodes-thunderphone`. Prieš diegdami
patikrinkite bendruomenės mazgų rizikas ir savo egzemplioriaus politiką.

## Sukurkite serverio API raktą

<Steps>
  <Step title="Atidarykite skirtuką „Raktai“">
    ThunderPhone sistemoje eikite į **Organizacija → Raktai** ir spustelėkite **Sukurti raktą**.
  </Step>
  <Step title="Suteikite jam pavadinimą">
    Naudokite pavadinimą, nurodantį, kur raktas naudojamas, pavyzdžiui, „n8n“.
  </Step>
  <Step title="Nukopijuokite jį dabar">
    Visas `sk_live_...` slaptasis raktas rodomas vieną kartą. Nukopijuokite jį prieš uždarydami
    dialogo langą.
  </Step>
</Steps>

Raktą gali sukurti tik administratorius arba savininkas, o ThunderPhone užklausas,
pateiktas naudojant šį raktą, laiko pateiktomis to asmens vardu. Trigeriui ir kampanijų
operacijoms reikia, kad tas asmuo išlaikytų administratoriaus arba savininko vaidmenį.
[Puslapyje „Sukurkite serverio API raktą“](/lt/guides/api-keys) aprašomas raktų keitimas ir atšaukimas.

## Pridėkite prisijungimo duomenis n8n

1. n8n sukurkite **ThunderPhone API** tipo prisijungimo duomenis.
2. Įklijuokite raktą į **API raktas**.
3. Išsaugokite juos ir paleiskite prisijungimo duomenų testą. Testas nuskaito vieną jūsų
   organizacijos skambutį naudodamas `GET /v1/calls?limit=1`.

## Sukurkite pirmą darbo eigą

Ši darbo eiga prideda eilutę į „Google Sheets“ kaskart, kai baigiasi skambutis.

<Steps>
  <Step title="Pridėkite trigerį">
    Pridėkite **ThunderPhone Trigger**, pasirinkite savo „ThunderPhone“ API kredencialus ir
    nustatykite **Įvykis** reikšmę į **Skambutis baigtas**.
  </Step>
  <Step title="Gaukite skambutį">
    Pridėkite **ThunderPhone** mazgą. Nustatykite **Išteklius** į **Skambutis**, **Operacija**
    į **Gauti**, o **Skambučio ID** į išraišką `{{ $json.data.call_id }}`.
    Išvestį sudaro [skambučio įrašas](/api-reference/calls), taip pat `transcripts`
    ir `recording_url` – trumpalaikė nuoroda, kurios reikšmė yra `null`, kai skambutis
    neturi įrašo.
  </Step>
  <Step title="Pridėkite eilutę">
    Pridėkite „Google Sheets“ mazgą, kuris prideda eilutę, ir susiekite norimus stulpelius
    iš „Get Call“ išvesties (žr. toliau pateiktą lentelę).
  </Step>
  <Step title="Aktyvinkite darbo eigą">
    Išsaugokite ir aktyvinkite. Trigeris užregistruoja savo gamybinį URL kaip žiniatinklio kabliuko
    galinį tašką jūsų „ThunderPhone“ organizacijoje. Išaktyvinus darbo eigą,
    tas galinis taškas ištrinamas.
  </Step>
  <Step title="Išbandykite">
    Atidarykite agentą kūrimo priemonėje, spustelėkite **Kalbėti** ir užbaikite skambutį. Kūrimo
    priemonės bandomieji skambučiai pateikiami kaip `web.complete`, vienas iš dviejų įvykių,
    susijusių su skambučio užbaigimu, todėl darbo eiga vykdoma ir atsiranda eilutė.
  </Step>
</Steps>

Naudingi stulpeliai:

| Stulpelis | Išraiška |
|---|---|
| Skambučio ID | `{{ $json.call_id }}` |
| Kryptis | `{{ $json.direction }}` |
| Iš | `{{ $json.from_number }}` |
| Į | `{{ $json.to_number }}` |
| Pradžia | `{{ $json.start_time }}` |
| Trukmė (s) | `{{ $json.duration_seconds }}` |
| Būsena | `{{ $json.status }}` |
| Baigimo priežastis | `{{ $json.end_reason }}` |
| Skambučio nuoroda | `https://app.thunderphone.com/dashboard/call-history/{{ $json.call_id }}` |

Skambučio nuoroda organizacijos nariams atidaro skambutį „ThunderPhone“ valdymo
skydelyje kartu su jo transkriptu ir įrašu, todėl skaičiuoklėje nereikia saugoti
nė vieno iš jų.

Jei vis tiek norite pridėti transkriptą, susiekite
`{{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}`.
Įrašo URL galiojimas baigiasi, todėl saugokite skambučio ID ir paleiskite „Get Call“ dar kartą,
kai reikia naujos nuorodos. Skambučių transkriptuose, santraukose ir įrašuose gali būti
asmens arba sveikatos informacijos. Siųskite juos tik į programas, kurias jūsų organizacijai
leidžiama naudoti tokiems duomenims, pagal BAA, kai naudojama sveikatos informacija,
ir saugokite tik reikalingus laukus.

<Note>
  „ThunderPhone“ pateikia įvykius naudodama `POST` į trigerio gamybinį URL, todėl jūsų
  n8n egzempliorius turi būti pasiekiamas iš interneto per HTTPS, o darbo eiga turi būti
  aktyvi. Trigeris kiekvienai užklausai patikrina `X-ThunderPhone-Signature` HMAC ir
  grąžina `401` kiekvienai nepasirašytai arba netinkamai užklausai.
</Note>

Trigerio išvestį sudaro visas įvykis: `type`, `event_id` ir `data`. Visus laukus žr.
[`telephony.complete` / `web.complete`](/lt/webhooks/call-complete) ir
[`call.graded`](/lt/webhooks/events). Pristatymas vykdomas mažiausiai vieną kartą,
o `event_id` nesikeičia pakartotinai bandant pristatyti vieną įvykį, todėl patikrinkite jį prieš
veiksmą, kuris neturi būti kartojamas.

## Saugiai vykdykite išeinančius skambučius

**Vykdyti išeinantį skambutį** (išteklius **Išeinantis skambutis**, operacija **Vykdyti**)
priima:

| Laukas | Reikšmė |
|---|---|
| Agento pavadinimas arba ID | Išsaugotas agentas. Išskleidžiamajame sąraše pateikiami jūsų agentai. |
| Telefono numerio pavadinimas arba ID | Numeris, iš kurio skambinama. Išskleidžiamajame sąraše pateikiami tik išeinantiems skambučiams įgalinti numeriai. |
| Gavėjo numeris | Paskirties numeris E.164 formatu, pvz., `+14155552671`. |
| Kintamieji | JSON reikšmių objektas agento raginimo vietos rezervavimo ženklams. |
| Idempotentiškumo raktas | Stabilus ID iš pirminio įrašo arba įvykio. Privalomas. |

Susiekite **idempotentiškumo raktą** su ID iš to, kas sukėlė vykdymą, pvz.,
CRM įrašo ID arba aktyviklio `event_id`. Mazgas siunčia
`n8n:<node ID>:<your value>`, todėl:

- Automatinis pakartotinis bandymas arba **Pakartoti vykdymą** siunčia tą patį raktą, o
  ThunderPhone grąžina pradinį skambutį su `idempotent_replay: true`,
  užuot skambinęs dar kartą.
- Du ThunderPhone mazgai, gaunantys tą patį įrašą, siunčia skirtingus raktus.
- Tuščia reikšmė nepavyksta dar prieš išsiunčiant užklausą.

Venkite laiko žymų, atsitiktinių reikšmių ir n8n vykdymo ar darbo eigos ID. Nauja
reikšmė pakartotinio bandymo metu vykdo antrą tikrą skambutį. Visas raktas gali
turėti ne daugiau kaip 128 simbolius. Pakartotinai naudojant raktą su kitu agentu,
numeriu ar kintamaisiais, gaunamas konfliktas.

**Kampanijos.** **Pridėti kontaktus** (išteklius **Kampanija**) prideda kontaktus į
juodraštinę kampaniją. Tam reikia kampanijos ID ir JSON kontaktų masyvo. Kiekvienam kontaktui
reikia `phone_number`; kiti raktai tampa skambučio kintamaisiais. Mazgui nepavyksta, kai atmetami
visi kontaktai, ir nustatoma `partial_success: true`, kai atmetama tik dalis jų. **Pradėti** reikia pažymėti žymimąjį langelį,
patvirtinantį, kad kampanija vykdo tikrus skambučius ir naudoja ThunderPhone
kreditus. Žr. [Išeinančios kampanijos](/lt/guides/outbound-campaigns).

Prieš darbo eigai pradedant skambučius:

- Jei ThunderPhone prašo jūsų organizacijos patvirtinti, kad jos išeinantys skambučiai
  atitinka TCPA ir kitus skambučių įstatymus, administratorius pirmiausia turi
  užregistruoti šį patvirtinimą valdymo skydelyje.
- Numeris, iš kurio skambinama, turi būti įgalintas išeinantiems skambučiams. Numeriai, kuriuos perkeli ate iš
  savo operatoriaus, tinkami juos patvirtinus. ThunderPhone numeriai iš pradžių
  skirti tik įeinantiems skambučiams ir gali būti patvirtinti išeinančiam naudojimui: administratorius to paprašo
  puslapyje Telefono numeriai. Žr.
  [Gaukite telefono numerį](/lt/guides/get-a-phone-number).
- Jūsų organizacija atsako už sutikimo skambinti kiekvienu numeriu gavimą
  ir taikomų skambučių įstatymų laikymąsi. Žr.
  [Išeinančių skambučių įstatymai](/lt/guides/outbound-calling-laws).

## Darbo eigų pavyzdžiai

- **CRM kontaktai į kampaniją.** Pridėkite CRM kontaktus į juodraštinę ThunderPhone
  kampaniją, tada pradėkite kampaniją, kai kas nors patvirtina sąrašą.
- **Užbaigtas skambutis į kliento įrašą.** Įvykus Call Completed, vykdykite Get Call
  ir išsaugokite nuorašą bei įrašo nuorodą atitinkamame kliento įraše.
- **Žemi įvertinimai peržiūrai.** Įvykus Call Graded, filtruokite pagal
  `{{ $json.data.grade.score }}` ir nukreipkite žemai įvertintus skambučius į peržiūros eilę
  su skambučio ID ir įvertinimo informacija. Skambutis gali būti įvertintas daugiau nei vieną kartą,
  o kiekvienas baigtas vertinimo vykdymas suaktyvina aktyviklį, todėl kiekvienam
  skambučio ID saugokite tik naujausią `graded_at`.

Skambučių nuorašuose, suvestinėse ir įrašuose gali būti asmens ar sveikatos
informacijos. Siųskite juos tik į programas, kurias jūsų organizacijai leidžiama naudoti
tokiems duomenims, pagal BAA, kai tvarkoma sveikatos informacija, ir saugokite tik
jums reikalingus laukus.

<Note>
  Vietoje to tuos pačius skambučių įvykius siunčiate į savo serverį? Žr.
  [Webhook galiniai taškai](/lt/webhooks/endpoints).
  [Vykdykite išeinančius skambučius](/lt/guides/place-outbound-calls) aprašo API, kuri naudojama
  vykdant išeinantį skambutį.
</Note>