--- title: "Käytä ThunderPhonea Zapierin kanssa" description: "Yhdistä Zapierin ThunderPhone-sovellus organisaatioosi ja rakenna Zap, joka suoritetaan aina puhelun päättyessä." --- [Zapier](https://zapier.com) yhdistää sovelluksia automatisoituihin työnkulkuihin, joita kutsutaan Zapeiksi. Zapierin ThunderPhone-sovellus tarjoaa: - **Käynnistimet:** **Puhelu päättyi** käynnistyy, kun puhelin-, verkko- tai testipuhelu päättyy. **Puhelu arvioitu** käynnistyy, kun päättyneen puhelun arvio on saatavilla. - **Toiminnot:** **Soita lähtevä puhelu**, **Lisää yhteystietoja kampanjaan** ja **Aloita kampanja**. - **Haku:** **Etsi puhelu** hakee puhelun tunnuksella ja palauttaa sen yhdessä transkriptin ja allekirjoitetun tallenne-URL:n kanssa, jos sellainen on saatavilla. Löydät sen osoitteesta [ThunderPhone Zapierissa](https://zapier.com/apps/thunderphone/integrations). Yleiskatsauksen molempiin tapoihin käyttää Zapieria ThunderPhonen kanssa löydät [Zapier-integraatiosivulta](https://thunderphone.com/integrations/zapier). ## Yhdistä organisaatiosi Sovellus yhdistetään OAuthin kautta. Kirjaudut sisään ThunderPhoneen ja hyväksyt pääsyn yhteen organisaatioon, eikä API-avainta kopioida Zapieriin. Etsi Zap-editorissa **ThunderPhone** (näkyy Beeta-merkinnällä) ja valitse käynnistin tai toiminto. Kun Zapier pyytää tiliä, yhdistä uusi tili. Zapier avaa ThunderPhonen kirjautumisikkunan. Kirjaudu sisään, tarkista pyydetyt käyttöoikeudet, valitse organisaatio ja valitse **Hyväksy**. Sovellus pyytää oikeutta lukea agenttejasi ja puhelinnumeroitasi, lukea ja kirjoittaa puheluita ja kampanjoita, hallita integraatioita, kuten webhook-päätepisteitä, sekä nähdä tilisi sähköpostiosoitteen. Zapier nimeää yhteyden hyväksymäsi organisaation mukaan, joten voit erottaa yhteydet toisistaan, kun kuulut useampaan kuin yhteen organisaatioon. Yhdistä tilillä, jolla on kyseisessä organisaatiossa ylläpitäjän tai omistajan rooli. Käynnistin-Zapin ottaminen käyttöön tai poistaminen käytöstä sekä kaikki toiminnot edellyttävät tätä roolia. Jo käytössä oleva käynnistin-Zap vastaanottaa edelleen puhelutapahtumia, vaikka roolisi muuttuu tai yhteys peruutetaan. Poista se käytöstä, jotta ne lakkaavat. **Etsi puhelu** toimii kaikille jäsenille. Sovelluksella ei ole omaa ThunderPhone-maksua. Sen soittamat tai käynnistämät puhelut laskutetaan normaalien ThunderPhone-hintojesi mukaan, ja Zapier laskee tehtävät Zapier-tilauksesi mukaan. ## Luo ensimmäinen Zap Tämä Zap lisää rivin Google Sheetiin aina, kun puhelu päättyy. Avaa agentti rakennustyökalussa, napsauta **Keskustele** ja lopeta puhelu. Rakennustyökalun testipuhelut käynnistävät Puhelu päättynyt -tapahtuman, joten käynnistimellä on viimeisin puhelu ladattavana. Valitse **ThunderPhone** käynnistinsovellukseksi, aseta tapahtumaksi **Puhelu päättynyt** ja valitse ThunderPhone-yhteytesi. Testaa käynnistin. Zapier lataa viimeisimmät päättyneet puhelusi esimerkeiksi samassa muodossa kuin reaaliaikainen tapahtuma. Lisää Google Sheets -toiminto, joka luo laskentataulukkorivin. Valitse taulukko, jossa on otsikkorivi, ja kohdista sitten jokainen sarake käynnistimen kenttään (katso alla oleva taulukko). Julkaise ja ota Zap käyttöön. Käyttöönotto luo ThunderPhone-organisaatioosi webhook-päätepisteen nimeltä **Zapier: Puhelu päättynyt**. Zapin poistaminen käytöstä poistaa kyseisen päätepisteen. Soita toinen testipuhelu rakennustyökalussa. Kun se päättyy, Zap suoritetaan ja rivi ilmestyy. Hyödyllisiä sarakkeita: | Sarake | Puhelu päättynyt -kenttä | |---|---| | Puhelun tunnus | Puhelun tunnus | | Agentti | Agentin nimi | | Suunta | Suunta | | Lähettäjä | Lähettäjän numero | | Vastaanottaja | Vastaanottajan numero | | Alkoi | Alkoi | | Päättyi | Päättyi | | Kesto (s) | Kesto sekunteina | | Tila | Tila | | Päättymissyy | Päättymissyy | | Puhelulinkki | Kirjoita `https://app.thunderphone.com/dashboard/call-history/` ja lisää sitten puhelun tunnus | Puhelulinkki avaa puhelun ThunderPhone-hallintapaneelissa organisaatiosi jäsenille sen tekstin ja tallenteen kanssa, joten taulukkoon ei tarvitse tallentaa kumpaakaan. Tapahtuma voi sisältää myös puhelun tekstin vuoroluettelona sekä Recording URL -osoitteen, joka on vanheneva allekirjoitettu linkki. Lisää ne vain, jos taulukko tarvitsee niitä. Puhelujen tekstit, yhteenvedot ja tallenteet voivat sisältää henkilö- tai terveystietoja. Lähetä niitä vain sovelluksiin, joita organisaatiosi saa käyttää kyseisille tiedoille, terveystietojen osalta BAA-sopimuksen mukaisesti, ja säilytä vain tarvitsemasi kentät. Katso [`telephony.complete` / `web.complete`](/fi/webhooks/call-complete), jossa ovat kaikki kentät. Jokainen toimitus on allekirjoitettu. Sovellus tarkistaa `X-ThunderPhone-Signature`- HMAC-arvon päätepisteen salaisuutta vasten ennen Zapin suorittamista ja pysäyttää kaikki allekirjoittamattomat tai virheelliset toimitukset. Jos Zapier ei hyväksy toimitusta, ThunderPhone yrittää sitä uudelleen enintään 24 tunnin ajan. Katso [Webhookien yleiskatsaus](/fi/webhooks/overview). ## Käynnistimet, toiminnot ja haku **Puhelu arvioitu** antaa puhelutunnuksen, agenttitunnuksen, agentin nimen ja arvioinnin tiedot: arviointitunnuksen, pisteet, puhelun lopputuloksen, yhteenvedon, arvioijamallin ja arviointiajan. Zapin käyttöönotto luo päätepisteen nimeltä **Zapier: Puhelu arvioitu**. Puhelu voidaan arvioida useammin kuin kerran, ja jokainen valmistunut arviointiajo käynnistää käynnistimen. Katso [`call.graded`](/fi/webhooks/events). **Etsi puhelu** ottaa vastaan puhelutunnuksen, ja siinä on avattava luettelo viimeisimmistä puheluista. Se palauttaa puhelun agentin, suunnan, numerot, alkamis- ja päättymisajat, tilan, päättymissyyn, arviointipisteet ja puhelun lopputuloksen, litteroinnin sekä allekirjoitetun tallenteen URL-osoitteen, kun sellainen on saatavilla. Tuntematon puhelutunnus ei palauta tulosta virheen sijaan. **Soita lähtevä puhelu** ottaa vastaan: | Kenttä | Merkitys | |---|---| | Agentti | Tallennettu agentti. Avattavassa luettelossa näkyvät agenttisi. | | Kohdenumero | Kohde E.164-muodossa, kuten `+14155552671`. | | Lähtönumero | Avattavassa luettelossa näkyvät vain lähteviin puheluihin käyttöön otetut numerot. | | Muuttujat | Valinnainen JSON-objekti arvoille, jotka korvaavat paikkamerkkejä agentin kehotteessa. | | Idempotenssiavain | Vakaa tunniste käynnistimestä tai lähdetietueesta. Pakollinen. | Se palauttaa puhelutunnuksen, tilan ja idempotenssitoiston. **Lisää yhteystietoja kampanjaan** lisää yhteystietoja luonnoskampanjaan. Täytä yhtä yhteystietoa varten **Puhelinnumero** E.164-muodossa ja valinnaisesti **Yhteystietomuuttujat**, JSON-objekti, jonka ominaisuuksista tulee kampanjamuuttujia. Täytä erää varten **Yhteystiedot JSON** enintään 5 000 objektin taulukolla. Jokainen tarvitsee `phone_number`-kentän, ja sen muista ominaisuuksista tulee muuttujia. Vaihe epäonnistuu, kun kaikki yhteystiedot hylätään, ja asettaa arvon **Osittainen onnistuminen**, kun vain osa hylätään. **Käynnistä kampanja** käynnistää tai jatkaa kampanjaa, jossa on vähintään yksi yhteystieto. Se edellyttää **Suostumusta laskutukseen**. Katso [Lähtevät kampanjat](/fi/guides/outbound-campaigns). ## Ennen kuin Zap soittaa puheluita Soita lähtevä puhelu ja Käynnistä kampanja soittavat oikeisiin puhelinnumeroihin ja aloittavat laskutettavia puheluita. - Jos ThunderPhone pyytää organisaatiotasi vahvistamaan, että sen lähtevät puhelut noudattavat TCPA:ta ja muita puheluita koskevia lakeja, ylläpitäjän on kirjattava tämä vahvistus hallintapaneeliin, ennen kuin Zap voi aloittaa puheluita. - Lähtönumeron on oltava otettu käyttöön lähteviä puheluita varten. Omasta operaattoristasi tuomasi numerot kelpaavat vahvistamisen jälkeen. ThunderPhonen tarjoamat numerot ovat aluksi vain saapuvia puheluita varten, ja voit pyytää niille lähtevien puheluiden käyttöoikeutta hallintapaneelissa. Katso [Hanki puhelinnumero](/fi/guides/get-a-phone-number). - Soita lähtevä puhelu edellyttää **idempotenssiavainta**. Yhdistä vakaa tunniste käynnistimestä tai lähdetietueesta, kuten ThunderPhone-tapahtumatunnus tai CRM-tietuetunnus. Jos Zapier yrittää vaihetta uudelleen, ThunderPhone tunnistaa avaimen ja palauttaa alkuperäisen puhelun toisen puhelun soittamisen sijaan. Vältä aikaleimoja, satunnaisia arvoja tai pelkkää Zap-tunnusta. - Käynnistä kampanja edellyttää **suostumusta laskutukseen**, joka vahvistaa, että Zap saa aloittaa laskutettavia lähteviä puheluita tililläsi. - Organisaatiosi vastaa siitä, että sillä on suostumus soittaa kuhunkin numeroon ja että se noudattaa sovellettavia puheluita koskevia lakeja. Katso [lähteviä puheluita koskevat lait](/fi/guides/outbound-calling-laws). Idempotenssiavain on yksilöllinen koko organisaatiossasi, ja se voi olla enintään 128 merkkiä pitkä. Avaimen uudelleenkäyttö eri agentin, numeron tai muuttujien kanssa epäonnistuu ristiriitaan, joten jos kaksi Zapia voi soittaa samasta tietueesta, anna kummallekin Zapille oma kiinteä etuliite ennen tietuetunnusta. [Soita lähteviä puheluita](/fi/guides/place-outbound-calls) käsittelee tämän toiminnon taustalla olevaa APIa. ## Esimerkki-Zapit - **Valmis puhelu CRM:ään.** Kirjaa aktiviteetti jokaisesta päättyneestä puhelusta sekä sen tila, päättymissyy ja litterointi. - **Arvioitu puhelu jatkotoimiin.** Suodata puhelun tuloksen tai pistemäärän perusteella ja ohjaa puhelu oikeaan jatkotoimien työnkulkuun. - **Uusi liidi kampanjaan.** Lisää liidi luonnoskampanjaan toiminnolla Add Contacts to Campaign ja suorita sitten Start Campaign, kun joku hyväksyy luettelon. Puhelulitteroinnit, yhteenvedot ja tallenteet voivat sisältää henkilö- tai terveystietoja. Lähetä niitä vain sovelluksiin, joita organisaatiosi saa käyttää kyseisten tietojen käsittelyyn, terveyteen liittyvien tietojen osalta BAA-sopimuksen mukaisesti, ja säilytä vain tarvitsemasi kentät. ## Vianmääritys **Vaihe epäonnistuu valtuutusvirheeseen.** Yhdistä ThunderPhone-yhteys uudelleen Zapierissa ja hyväksy se uudelleen. Yhteys lakkaa toimimasta, kun yhteyden muodostanut henkilö peruuttaa sen ThunderPhonessa kohdassa **Organisaatio → Avaimet → Valtuutetut sovellukset**, kun henkilö poistuu organisaatiosta tai kun onnistuneesta tunnuksen päivityksestä on kulunut 30 päivää. Katso [Yhdistä OAuthilla](/fi/guides/oauth). **Zapin käyttöönotto tai käytöstäpoisto epäonnistuu tai toiminto hylätään.** Yhteyden muodostaneella henkilöllä on oltava organisaation ylläpitäjän tai omistajan rooli. Yhdistä uudelleen tilillä, jolla on kyseinen rooli. Jo käytössä oleva käynnistin-Zap vastaanottaa edelleen puhelutapahtumia roolin muutoksen tai yhteyden peruuttamisen jälkeen. Poista se käytöstä lopettaaksesi ne. **Haluat katkaista sovelluksen yhteyden.** Poista ThunderPhone-Zapit käytöstä ennen yhteyden peruuttamista, koska Zapin käytöstäpoisto poistaa sen päätepisteen ja vaatii toimivan yhteyden. Jos peruutit yhteyden ensin, poista jäljelle jäänyt **Zapier: …** -päätepiste komennolla `DELETE /v1/developer/webhook-endpoints/{id}` käyttäen ylläpitäjän API-avainta. Katso [Webhook-päätepisteet](/fi/webhooks/endpoints). **Zapin pitäisi käyttää eri organisaatiota.** Kukin yhteys kattaa yhden organisaation. Poista Zap ensin käytöstä, jotta sen webhook-päätepiste poistetaan nykyisestä organisaatiosta. Yhdistä sitten uusi ThunderPhone-tili Zapierissa, valitse toinen organisaatio hyväksynnän yhteydessä ja valitse kyseinen yhteys jokaisessa ThunderPhone-vaiheessa. Agentit, numerot ja kampanjat ovat organisaatiokohtaisia, joten valitse **Agentti**, **Lähtönumero** ja **Kampanja** uudelleen jokaisessa vaiheessa, jossa ne ovat käytettävissä. Ota sitten Zap uudelleen käyttöön. **Käynnistin lakkasi toimimasta.** Jokaisella Zapilla, jossa on ThunderPhone-käynnistin, on yksi organisaatiosi webhook-päätepiste, jonka nimi on **Zapier: Puhelu päättynyt** tai **Zapier: Puhelu arvioitu**. Se luodaan, kun Zap otetaan käyttöön, ja poistetaan, kun Zap poistetaan käytöstä. Jätä se ennalleen. Jos sitä muokattiin tai se poistettiin ThunderPhonessa, luo uusi poistamalla Zap käytöstä ja ottamalla se uudelleen käyttöön. Ylläpitäjän API-avaimella [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) näyttää viimeisimmät toimitusyritykset. Haluatko agentin käyttävän Zapier-toimintoja puhelun aikana sen sijaan, että niitä käytettäisiin puhelun jälkeen? Yhdistä Zapier MCP -päätepiste kohdassa **Yhteydet → MCP**. Katso [MCP-palvelimet](/fi/guides/mcp-servers). Jos haluat lähettää samat puhelutapahtumat omalle palvelimellesi, katso [Webhook-päätepisteet](/fi/webhooks/endpoints).