--- title: "A ThunderPhone használata a Zapierrel" description: "Csatlakoztassa a Zapieren található ThunderPhone alkalmazást a szervezetéhez, és hozzon létre egy Zapet, amely minden hívás befejeződésekor lefut." --- [Zapier](https://zapier.com) a Zaps nevű automatizált munkafolyamatokkal kapcsolja össze az alkalmazásokat. A Zapier ThunderPhone alkalmazása a következőket kínálja: - **Kiváltó események:** A **Hívás befejeződött** akkor aktiválódik, amikor egy telefonos, webes vagy teszthívás véget ér. A **Hívás értékelve** akkor aktiválódik, amikor egy befejezett hívás értékelése elérhetővé válik. - **Műveletek:** **Kimenő hívás indítása**, **Kapcsolatok hozzáadása kampányhoz** és **Kampány indítása**. - **Keresés:** A **Hívás keresése** hívásazonosító alapján megkeres egy hívást, és elérhetőség esetén visszaadja annak átiratát és aláírt felvételi URL-jét. Itt találja: [ThunderPhone a Zapieren](https://zapier.com/apps/thunderphone/integrations). A Zapier ThunderPhone-nal való használatának mindkét módjáról áttekintést a [Zapier-integráció oldalán](https://thunderphone.com/integrations/zapier) talál. ## Szervezet csatlakoztatása Az alkalmazás OAuthon keresztül csatlakozik. Jelentkezzen be a ThunderPhone-ba, és hagyja jóvá egy szervezet hozzáférését; API-kulcs nem kerül átmásolásra a Zapierbe. A Zap-szerkesztőben keressen rá a **ThunderPhone** alkalmazásra (amely Beta címkével jelenik meg), majd válasszon kiváltó eseményt vagy műveletet. Amikor a Zapier fiókot kér, csatlakoztasson egy újat. A Zapier megnyit egy ThunderPhone-bejelentkezési ablakot. Jelentkezzen be, ellenőrizze a kért engedélyeket, válassza ki a szervezetet, majd válassza a **Jóváhagyás** lehetőséget. Az alkalmazás engedélyt kér az AI-ügynökei és telefonszámai olvasására, a hívások és kampányok olvasására és írására, az olyan integrációk kezelésére, mint a webhook- végpontok, valamint a fiókjához tartozó e-mail-cím megtekintésére. A Zapier a jóváhagyott szervezetről nevezi el a kapcsolatot, így meg tudja különböztetni a kapcsolatokat, ha egynél több szervezethez tartozik. Olyan fiókkal csatlakozzon, amely rendszergazdai vagy tulajdonosi szerepkörrel rendelkezik az adott szervezetben. Egy kiváltó Zap be- vagy kikapcsolásához, valamint minden művelethez szükség van erre a szerepkörre. Egy már bekapcsolt kiváltó Zap a szerepkör módosítása vagy a kapcsolat visszavonása után is fogadja a hívási eseményeket. Kapcsolja ki a leállításukhoz. A Hívás keresése bármely tag számára működik. Az alkalmazásnak nincs saját ThunderPhone-díja. Az általa kezdeményezett vagy indított hívásokra a szokásos ThunderPhone-díjszabás vonatkozik, a Zapier pedig a Zapier-csomagjában számolja a feladatokat. ## Az első Zap létrehozása Ez a Zap minden hívás befejeződésekor hozzáad egy sort egy Google-táblázathoz. Nyisson meg egy ügynököt a szerkesztőben, kattintson a **Beszélgetés** lehetőségre, majd fejezze be a hívást. A szerkesztőben indított teszthívások kiváltják a Hívás befejeződött eseményt, így az eseményindító egy nemrég lezajlott hívást tud betölteni. Válassza eseményindító alkalmazásként a **ThunderPhone** alkalmazást, állítsa az eseményt **Hívás befejeződött** értékre, majd válassza ki a ThunderPhone-kapcsolatát. Tesztelje az eseményindítót. A Zapier a legutóbb befejezett hívásait tölti be mintaként, ugyanabban a formátumban, mint egy éles eseményt. Adjon hozzá egy Google Sheets-műveletet, amely létrehoz egy táblázatsort. Válasszon egy fejlécsort tartalmazó táblázatot, majd rendelje hozzá az egyes oszlopokat az eseményindító egyik mezőjéhez (lásd az alábbi táblázatot). Tegye közzé és kapcsolja be a Zapot. A bekapcsolás létrehoz egy **Zapier: Hívás befejeződött** nevű webhook-végpontot a ThunderPhone szervezetében. A Zap kikapcsolása törli ezt a végpontot. Indítson egy újabb teszthívást a szerkesztőben. Amikor a hívás befejeződik, a Zap lefut, és megjelenik egy sor. Hasznos oszlopok: | Oszlop | Hívás befejeződött mező | |---|---| | Hívásazonosító | Hívásazonosító | | Ügynök | Ügynök neve | | Irány | Irány | | Hívótól | Hívó száma | | Hívottnak | Hívott száma | | Kezdés | Kezdés időpontja | | Befejezés | Befejezés időpontja | | Időtartam (mp.) | Időtartam másodpercben | | Állapot | Állapot | | Befejezés oka | Befejezés oka | | Híváshivatkozás | Írja be a következőt: `https://app.thunderphone.com/dashboard/call-history/`, majd szúrja be a hívásazonosítót | A híváshivatkozás megnyitja a hívást a ThunderPhone irányítópultján a szervezet tagjai számára, az átiratával és felvételével együtt, így ezeket nem kell a táblázatban tárolni. Az esemény az átiratot is tartalmazhatja, megszólalások listájaként, valamint egy Felvétel URL-címet, amely egy lejáró, aláírt hivatkozás. Csak akkor adja hozzá ezeket, ha a táblázatnak szüksége van rájuk. A hívásátiratok, összefoglalók és felvételek személyes vagy egészségügyi adatokat tartalmazhatnak. Csak olyan alkalmazásoknak küldje el őket, amelyeket a szervezete jogosult használni az adott adatokhoz, egészségügyi adatok esetén BAA alapján, és csak a szükséges mezőket őrizze meg. Az összes mezőt lásd itt: [`telephony.complete` / `web.complete`](/hu/webhooks/call-complete). Minden kézbesítés alá van írva. Az alkalmazás a Zap futása előtt ellenőrzi az `X-ThunderPhone-Signature` HMAC-et a végpont titkos kulcsával, és leállít minden aláírás nélküli vagy érvénytelen kézbesítésnél. Ha a Zapier nem fogad el egy kézbesítést, a ThunderPhone legfeljebb 24 órán át újrapróbálja azt. Lásd: [Webhookok áttekintése](/hu/webhooks/overview). ## Eseményindítók, műveletek és keresés A **Hívás kiértékelve** megadja a hívásazonosítót, az ügynökazonosítót, az ügynök nevét és az értékelést: az értékelés azonosítóját, a pontszámot, a hívás kimenetelét, az összefoglalót, az értékelő modellt és az értékelés időpontját. Egy Zap bekapcsolásakor létrejön egy **Zapier: Hívás kiértékelve** nevű végpont. Egy hívás többször is kiértékelhető, és minden befejezett értékelési futás aktiválja az eseményindítót. Lásd: [`call.graded`](/hu/webhooks/events). A **Hívás keresése** egy hívásazonosítót fogad, a legutóbbi hívások legördülő listájával. Visszaadja a hívás ügynökét, irányát, telefonszámait, kezdési és befejezési időpontját, állapotát, befejezési okát, értékelési pontszámát és híváskimenetelét, az átiratot, valamint egy aláírt felvétel-URL-t, ha elérhető. Ismeretlen hívásazonosító esetén hiba helyett nem ad vissza találatot. A **Kimenő hívás indítása** a következőket fogadja: | Mező | Jelentés | |---|---| | Ügynök | Mentett ügynök. A legördülő lista az Ön ügynökeit tartalmazza. | | Cél telefonszáma | Célállomás E.164 formátumban, például `+14155552671`. | | Kiinduló telefonszám | A legördülő lista csak a kimenő hívásokhoz engedélyezett számokat tartalmazza. | | Változók | Nem kötelező JSON-objektum az ügynök promptjában szereplő helyőrzők értékeivel. | | Idempotenciakulcs | Stabil azonosító az eseményindítóból vagy a forrásrekordból. Kötelező. | Visszaadja a hívásazonosítót, az állapotot és az idempotens ismétlést. A **Kapcsolatok hozzáadása kampányhoz** kapcsolatokat ad hozzá egy piszkozat állapotú kampányhoz. Egy kapcsolat esetén töltse ki a **Telefonszám** mezőt E.164 formátumban, és opcionálisan a **Kapcsolati változók** mezőt, amely egy JSON-objektum, és amelynek tulajdonságai kampányváltozókká válnak. Köteg esetén töltse ki a **Kapcsolatok JSON** mezőt legfeljebb 5 000 objektumot tartalmazó tömbbel. Mindegyiknek szüksége van `phone_number` értékre, a többi tulajdonsága pedig változóvá válik. A lépés sikertelen, ha minden kapcsolat elutasításra kerül, és **Részleges siker** értéket állít be, ha csak néhány kapcsolat kerül elutasításra. A **Kampány indítása** elindít vagy folytat egy legalább egy kapcsolatot tartalmazó kampányt. Ehhez **Hozzájárulás a terheléshez** szükséges. Lásd: [Kimenő kampányok](/hu/guides/outbound-campaigns). ## Mielőtt egy Zap hívásokat indít A Kimenő hívás indítása és a Kampány indítása valós telefonszámokat hív, és számlázható hívásokat indít. - Ha ThunderPhone arra kéri szervezetét, hogy erősítse meg, hogy kimenő hívásai megfelelnek a TCPA és más hívási jogszabályok előírásainak, egy rendszergazdának rögzítenie kell ezt a megerősítést az irányítópulton, mielőtt egy Zap hívásokat indíthat. - A Kiinduló telefonszámnak engedélyezve kell lennie kimenő hívásokhoz. A saját szolgáltatójától hozott telefonszámok ellenőrzés után jogosultak erre. A ThunderPhone által biztosított telefonszámok kezdetben csak bejövő hívásokhoz használhatók, és az irányítópulton kérhet hozzájuk kimenő hozzáférést. Lásd: [Telefonszám beszerzése](/hu/guides/get-a-phone-number). - A Kimenő hívás indítása művelethez **Idempotenciakulcs** szükséges. Társítson egy stabil azonosítót az eseményindítóból vagy a forrásrekordból, például a ThunderPhone eseményazonosítóját vagy egy CRM-rekord azonosítóját. Ha a Zapier újrapróbálja a lépést, ThunderPhone felismeri a kulcsot, és az eredeti hívást adja vissza egy második hívás indítása helyett. Kerülje az időbélyegek, a véletlenszerű értékek vagy önmagában a Zap azonosítójának használatát. - A Kampány indítása művelethez **Hozzájárulás a terheléshez** szükséges, amely megerősíti, hogy a Zap számlázható kimenő hívásokat indíthat az Ön fiókjában. - 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: [kimenő hívásokra vonatkozó jogszabályok](/hu/guides/outbound-calling-laws). Az idempotenciakulcs szervezeten belül egyedi, és legfeljebb 128 karakterből állhat. Ha ugyanazt a kulcsot más ügynökkel, telefonszámmal vagy változókkal használja újra, az ütközés miatt sikertelen lesz, ezért ha két Zap ugyanazzal a rekorddal kapcsolatban hívhat, adjon mindegyik Zapnak saját rögzített előtagot a rekordazonosító előtt. [A kimenő hívások indítása](/hu/guides/place-outbound-calls) bemutatja a művelet mögötti API-t. ## Példa Zapek - **Befejezett hívás a CRM-be.** Naplózzon tevékenységet minden befejezett híváshoz annak állapotával, befejezési okával és átiratával együtt. - **Értékelt hívás utókövetéshez.** Szűrjön a hívás eredménye vagy pontszáma alapján, és irányítsa a hívást a megfelelő utókövetési munkafolyamatba. - **Új érdeklődő kampányhoz.** Adja hozzá az érdeklődőt egy vázlatkampányhoz a Add Contacts to Campaign művelettel, majd futtassa a Start Campaign műveletet, miután valaki jóváhagyta a listát. 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 szervezete jogosult használni az adott adatokhoz, egészségügyi információk esetén BAA-megállapodás alapján, és csak a szükséges mezőket őrizze meg. ## Hibaelhárítás **Egy lépés engedélyezési hibával meghiúsul.** Csatlakoztassa újra a ThunderPhone-kapcsolatot a Zapierben, és hagyja jóvá ismét. Egy kapcsolat akkor szűnik meg működni, ha a csatlakoztatást végző személy visszavonja azt a ThunderPhone-ban a **Szervezet → Kulcsok → Engedélyezett alkalmazások** alatt, ha az illető elhagyja a szervezetet, vagy ha 30 napon keresztül nem történik sikeres tokenfrissítés. Lásd: [Csatlakozás OAuth-szal](/hu/guides/oauth). **Egy Zap be- vagy kikapcsolása meghiúsul, vagy egy műveletet elutasítanak.** A csatlakoztatást végző személynek rendszergazdai vagy tulajdonosi szerepkörrel kell rendelkeznie a szervezetben. Csatlakoztassa újra egy ilyen jogosultságú fiókkal. Egy már bekapcsolt trigger Zap a szerepkör módosítása vagy a kapcsolat visszavonása után is tovább fogadja a hívási eseményeket. Kapcsolja ki az események leállításához. **Le szeretné választani az alkalmazást.** A kapcsolat visszavonása előtt kapcsolja ki ThunderPhone Zapjeit, mivel egy Zap kikapcsolása törli annak végpontját, és működő kapcsolatra van szükség hozzá. Ha előbb vonta vissza a kapcsolatot, törölje a megmaradt **Zapier: …** végpontot a `DELETE /v1/developer/webhook-endpoints/{id}` használatával egy rendszergazdai API-kulccsal. Lásd: [Webhook-végpontok](/hu/webhooks/endpoints). **A Zapnak másik szervezetet kell használnia.** Minden kapcsolat egy szervezetet fed le. Először kapcsolja ki a Zapet, hogy a webhook-végpontja törlődjön az aktuális szervezetből. Ezután csatlakoztasson egy új ThunderPhone-fiókot a Zapierben, a jóváhagyáskor válassza a másik szervezetet, majd válassza ki azt a kapcsolatot minden ThunderPhone-lépésnél. Az ügynökök, számok és kampányok szervezetenként eltérnek, ezért válassza ki újra az **Ügynök**, a **Hívószám** és a **Kampány** elemet minden olyan lépésben, ahol szerepelnek. Ezután kapcsolja vissza a Zapet. **A trigger leállt.** Minden ThunderPhone-triggert tartalmazó Zap egy webhook-végpontot birtokol a szervezetében, amelynek neve **Zapier: Hívás befejezve** vagy **Zapier: Hívás értékelve**. A Zap bekapcsolásakor jön létre, és kikapcsolásakor törlődik. Hagyja változatlanul. Ha a ThunderPhone-ban szerkesztették vagy törölték, kapcsolja ki, majd be újra a Zapet, hogy új végpont jöjjön létre. Rendszergazdai API-kulccsal a [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) megjeleníti a legutóbbi kézbesítési kísérleteket. Azt szeretné, hogy az ügynök a hívás során, ne pedig utána használjon Zapier-műveleteket? Csatlakoztasson egy Zapier MCP-végpontot a **Kapcsolatok → MCP** alatt. Lásd: [MCP-kiszolgálók](/hu/guides/mcp-servers). Ha ugyanezeket a hívási eseményeket saját kiszolgálójára szeretné küldeni, lásd: [Webhook-végpontok](/hu/webhooks/endpoints).