---
title: "A ThunderPhone használata az n8n-nel"
description: "Telepítse az n8n-hez készült ThunderPhone-csomópontot, csatlakoztasson egy szerveroldali API-kulcsot, és hozzon létre egy munkafolyamatot, amely minden hívás befejezésekor lefut."
---

[n8n](https://n8n.io) egy munkafolyamat-automatizálási eszköz. Az n8n-hez készült ThunderPhone csomag
két csomópontot ad hozzá:

- A **ThunderPhone Trigger** munkafolyamatot indít, amikor egy hívás véget ér (**Hívás
  befejezve**), vagy amikor egy hívásértékelési futtatás befejeződik (**Hívás
  kiértékelve**).
- A **ThunderPhone** kimenő hívásokat indít, névjegyeket ad kampányokhoz és
  elindítja azokat, lekéri a hívásokat azok átiratával és felvételével együtt,
  valamint felsorolja az ügynökeit és telefonszámait.

Ez egy hitelesített közösségi csomópont, amely itt szerepel:
[ThunderPhone az n8n-en](https://n8n.io/integrations/thunderphone/).

## A csomópont telepítése

Az n8n szerkesztőben kattintson a **+** jelre a csomópontpanel megnyitásához, majd keressen rá a
**ThunderPhone** elemre. Előfordulhat, hogy a példány tulajdonosának előbb be kell állítania a hitelesített csomópontokat, mielőtt
más felhasználók hozzáadhatnák azokat.

Saját üzemeltetésű n8n esetén csomagnév alapján is telepíthet: nyissa meg a
**Beállítások > Közösségi csomópontok** menüt, és telepítse a `n8n-nodes-thunderphone` csomagot. A telepítés előtt
ellenőrizze a közösségi csomópontok kockázatait és a példányára vonatkozó szabályzatot.

## Szerveroldali API-kulcs létrehozása

<Steps>
  <Step title="Nyissa meg a Kulcsok lapot">
    A ThunderPhone-ban lépjen a **Szervezet → Kulcsok** menüponthoz, majd kattintson a **Kulcs létrehozása** lehetőségre.
  </Step>
  <Step title="Nevezze el">
    Olyan nevet használjon, amely jelzi, hol található a kulcs, például „n8n”.
  </Step>
  <Step title="Másolja ki most">
    A teljes `sk_live_...` titkos kulcs csak egyszer jelenik meg. Másolja ki, mielőtt bezárja a
    párbeszédablakot.
  </Step>
</Steps>

A kulcsot csak rendszergazda vagy tulajdonos hozhatja létre, és a ThunderPhone az ezzel
végrehajtott kéréseket úgy kezeli, mintha az adott személytől érkeznének. Az eseményindítóhoz és a kampányműveletekhez
szükséges, hogy ez a személy megtartsa a rendszergazdai vagy tulajdonosi szerepkört.
A [szerveroldali API-kulcs létrehozása](/hu/guides/api-keys) útmutató ismerteti a kulcsforgatást és a visszavonást.

## Hitelesítő adat hozzáadása az n8n-ben

1. Az n8n-ben hozzon létre egy **ThunderPhone API** típusú hitelesítő adatot.
2. Illessze be a kulcsot az **API-kulcs** mezőbe.
3. Mentse el, majd futtassa a hitelesítőadat-tesztet. A teszt egy hívást olvas ki a
   szervezetéből a `GET /v1/calls?limit=1` használatával.

## Az első munkafolyamat létrehozása

Ez a munkafolyamat minden hívás befejeződésekor hozzáad egy sort egy Google Sheethez.

<Steps>
  <Step title="Indító hozzáadása">
    Adja hozzá a **ThunderPhone Trigger** elemet, válassza ki ThunderPhone API-hitelesítő adatait, és
    állítsa az **Esemény** értékét **Hívás befejezve** értékre.
  </Step>
  <Step title="A hívás lekérése">
    Adjon hozzá egy **ThunderPhone** csomópontot. Állítsa az **Erőforrás**
    értékét **Hívás** értékre, a **Művelet** értékét **Lekérés** értékre, a **Hívásazonosító**
    értékét pedig erre a kifejezésre: `{{ $json.data.call_id }}`.
    A kimenet a [hívásrekordot](/api-reference/calls), valamint a `transcripts`
    és `recording_url` mezőt tartalmazza; utóbbi egy rövid élettartamú hivatkozás, amely `null`, ha a híváshoz
    nem tartozik felvétel.
  </Step>
  <Step title="Sor hozzáfűzése">
    Adjon hozzá egy sort hozzáfűző Google Sheets csomópontot, és képezze le a kívánt oszlopokat
    a Hívás lekérése kimenetből (lásd az alábbi táblázatot).
  </Step>
  <Step title="A munkafolyamat aktiválása">
    Mentse és aktiválja a munkafolyamatot. Az indító webhook-végpontként regisztrálja az éles URL-jét
    a ThunderPhone-szervezetében. A munkafolyamat deaktiválása törli ezt a végpontot.
  </Step>
  <Step title="Tesztelés">
    Nyisson meg egy ügynököt a szerkesztőben, kattintson a **Beszélgetés** gombra, majd fejezze be a hívást. A szerkesztő
    teszthívásai `web.complete` eseményként érkeznek, amely a Hívás befejezve mögötti két esemény egyike,
    így a munkafolyamat lefut, és megjelenik egy sor.
  </Step>
</Steps>

Hasznos oszlopok:

| Oszlop | Kifejezés |
|---|---|
| Hívásazonosító | `{{ $json.call_id }}` |
| Irány | `{{ $json.direction }}` |
| Honnan | `{{ $json.from_number }}` |
| Hová | `{{ $json.to_number }}` |
| Kezdés | `{{ $json.start_time }}` |
| Időtartam (mp.) | `{{ $json.duration_seconds }}` |
| Állapot | `{{ $json.status }}` |
| Befejezés oka | `{{ $json.end_reason }}` |
| Híváshivatkozás | `https://app.thunderphone.com/dashboard/call-history/{{ $json.call_id }}` |

A híváshivatkozás megnyitja a hívást a ThunderPhone irányítópultján a
szervezet tagjai számára, az átirattal és a felvétellel együtt, így ezeket nem
kell a táblázatban tárolni.

Az átirat hozzáadásához is képezze le ezt:
`{{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}`.
A felvétel URL-je lejár, ezért tárolja a hívásazonosítót, és futtassa újra a Hívás lekérése műveletet, amikor
friss hivatkozásra van szüksége. A hívásátiratok, összefoglalók és felvételek
személyes vagy egészségügyi információkat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete
jogosult használni ezekhez az adatokhoz, egészségügyi információ esetén BAA keretében,
és csak a szükséges mezőket tartsa meg.

<Note>
  A ThunderPhone `POST` kérésekkel kézbesíti az eseményeket az indító **Éles
  URL** címére, ezért az n8n-példánynak HTTPS-en keresztül elérhetőnek kell lennie az internetről,
  és a munkafolyamatnak aktívnak kell lennie. Az indító minden kérésnél ellenőrzi az
  `X-ThunderPhone-Signature` HMAC-értékét, és `401` választ ad minden aláíratlan vagy
  érvénytelen kérésre.
</Note>

Az indító a teljes eseményt adja ki: `type`, `event_id` és `data`. Az összes mezőt lásd itt:
[`telephony.complete` / `web.complete`](/hu/webhooks/call-complete) és
[`call.graded`](/hu/webhooks/events). A kézbesítés legalább egyszer történik,
és az `event_id` ugyanaz marad egy esemény újrapróbálkozásai során, ezért ellenőrizze azt egy
olyan lépés előtt, amelynek nem szabad megismétlődnie.

## Külső hívások biztonságos indítása

**Külső hívás indítása** (erőforrás: **Külső hívás**, művelet: **Indítás**)
a következőket fogadja:

| Mező | Jelentés |
|---|---|
| Ügynök neve vagy azonosítója | Mentett ügynök. A legördülő lista az Ön ügynökeit tartalmazza. |
| Telefonszám neve vagy azonosítója | A hívó szám. A legördülő lista csak a külső hívásokhoz engedélyezett számokat tartalmazza. |
| Hívott szám | Célállomás E.164 formátumban, például: `+14155552671`. |
| Változók | JSON-objektum az ügynöki prompt helyőrzőihez tartozó értékekkel. |
| Idempotenciakulcs | Stabil azonosító a forrásrekordból vagy -eseményből. Kötelező. |

Rendelje hozzá az **Idempotenciakulcsot** a futtatást kiváltó elem egyik
azonosítójához, például egy CRM-rekord azonosítójához vagy a kiváltó
`event_id` értékéhez. A csomópont a következőt küldi:
`n8n:<node ID>:<your value>`, ezért:

- Az automatikus újrapróbálás vagy a **Végrehajtás újrapróbálása** ugyanazt a kulcsot küldi, és a
  ThunderPhone az eredeti hívást adja vissza `idempotent_replay: true`
  értékkel, ahelyett hogy újra tárcsázna.
- Két, ugyanazzal a rekorddal ellátott ThunderPhone-csomópont különböző kulcsokat küld.
- Üres érték esetén a művelet még kérés küldése előtt sikertelen.

Kerülje az időbélyegeket, a véletlenszerű értékeket, valamint az n8n-végrehajtási
vagy munkafolyamat-azonosítókat. Az újrapróbáláskor megadott új érték egy második
valódi hívást indít. A teljes kulcs legfeljebb 128 karakter lehet. Ha ugyanazt a
kulcsot más ügynökkel, számmal vagy változókkal használja újra, ütközés miatt
sikertelen lesz.

**Kampányok.** A **Névjegyek hozzáadása** (erőforrás: **Kampány**) névjegyeket ad hozzá egy
piszkozatkampányhoz. Kampányazonosítót és névjegyek JSON-tömbjét fogadja. Minden névjegyhez szükséges a `phone_number`; a többi kulcs
hívásváltozóvá válik. A csomópont akkor sikertelen, ha minden névjegyet elutasítanak, és
`partial_success: true` értéket állít be, ha csak néhányat utasítanak el. Az **Indítás** művelethez szükséges a jelölőnégyzet
kiválasztása, amely megerősíti, hogy a kampány valódi hívásokat indít és ThunderPhone-krediteket használ fel. Lásd:
[Külső kampányok](/hu/guides/outbound-campaigns).

Mielőtt egy munkafolyamat hívásokat indít:

- Ha a ThunderPhone arra kéri a szervezetét, hogy erősítse meg, hogy külső hívásai
  megfelelnek a TCPA-nak és más hívásra vonatkozó jogszabályoknak, egy rendszergazdának először
  rögzítenie kell ezt a megerősítést az irányítópulton.
- A hívó számnak engedélyezve kell lennie külső hívásokhoz. A saját
  szolgáltatójától hozott számok ellenőrzés után megfelelnek a feltételeknek. A ThunderPhone-számok kezdetben
  csak bejövő hívásokra használhatók, és külső használatra jóváhagyhatók: ezt egy rendszergazda kérelmezi
  a Telefonszámok oldalon. Lásd:
  [Telefonszám beszerzése](/hu/guides/get-a-phone-number).
- Az Ön szervezete felelős azért, hogy rendelkezzen hozzájárulással az egyes számok hívásához,
  és betartsa az alkalmazandó hívási jogszabályokat. Lásd:
  [Külső hívásokra vonatkozó jogszabályok](/hu/guides/outbound-calling-laws).

## Példa-munkafolyamatok

- **CRM-névjegyek kampányba.** Adjon CRM-névjegyeket egy piszkozat ThunderPhone-kampányhoz,
  majd indítsa el a kampányt, amikor valaki jóváhagyja a listát.
- **Befejezett hívás az ügyfélrekordba.** A Hívás befejezésekor futtassa a Hívás lekérése műveletet,
  és mentse az átiratot és a felvétel hivatkozását a megfelelő ügyfélrekordhoz.
- **Alacsony értékelések felülvizsgálatra.** A Hívás értékelésekor szűrjön a
  `{{ $json.data.grade.score }}` alapján, és irányítsa az alacsony pontszámú hívásokat felülvizsgálati várólistára
  a hívásazonosítóval és az értékelés részleteivel együtt. Egy hívás több alkalommal is értékelhető,
  és minden befejezett értékelési futás aktiválja a kiváltót, ezért hívásazonosítónként csak a legfrissebb
  `graded_at` értéket tartsa meg.

A hívásátiratok, összefoglalók és felvételek személyes vagy egészségügyi
információkat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete jogosult
használni ezekhez az adatokhoz, egészségügyi információk esetén BAA alapján, és
csak a szükséges mezőket tartsa meg.

<Note>
  Inkább ugyanazokat a hívási eseményeket küldi a saját szerverére? Lásd:
  [Webhook-végpontok](/hu/webhooks/endpoints).
  A [Külső hívások indítása](/hu/guides/place-outbound-calls) az
  Külső hívás indítása mögötti API-t ismerteti.
</Note>