---
title: "Bruk ThunderPhone med Zapier"
description: "Koble ThunderPhone-appen på Zapier til organisasjonen din, og bygg en Zap som kjører hver gang en samtale avsluttes."
---

[Zapier](https://zapier.com) kobler apper sammen med automatiserte arbeidsflyter kalt
Zaps. ThunderPhone-appen på Zapier tilbyr:

- **Utløsere:** **Anrop fullført** utløses når et telefon-, nett- eller testanrop avsluttes.
  **Anrop vurdert** utløses når vurderingen av et fullført anrop er tilgjengelig.
- **Handlinger:** **Foreta utgående anrop**, **Legg til kontakter i kampanje** og
  **Start kampanje**.
- **Søk:** **Finn anrop** slår opp et anrop etter ID og returnerer det med
  transkripsjonen og en signert URL til opptaket når en er tilgjengelig.

Finn den på [ThunderPhone på Zapier](https://zapier.com/apps/thunderphone/integrations).
For en oversikt over begge måtene å bruke Zapier med ThunderPhone på, se
[integrasjonssiden for Zapier](https://thunderphone.com/integrations/zapier).

## Koble til organisasjonen din

Appen kobles til via OAuth. Du logger inn på ThunderPhone og godkjenner
tilgang for én organisasjon, uten at noen API-nøkkel kopieres inn i Zapier.

<Steps>
  <Step title="Legg til et ThunderPhone-trinn">
    I Zap-redigereren søker du etter **ThunderPhone** (vist med en Beta-etikett)
    og velger en utløser eller handling. Når Zapier ber om en konto, kobler du til en ny. Zapier åpner
    et innloggingsvindu for ThunderPhone.
  </Step>
  <Step title="Logg inn og velg organisasjonen">
    Logg inn, kontroller de forespurte tillatelsene, velg organisasjonen og
    velg **Godkjenn**. Appen ber om tillatelse til å lese agentene og telefonnumrene dine,
    lese og skrive anrop og kampanjer, administrere integrasjoner som webhook-
    endepunkter og se e-postadressen for kontoen din.
  </Step>
  <Step title="Kontroller tilkoblingsnavnet">
    Zapier navngir tilkoblingen etter organisasjonen du godkjente, slik at du
    kan skille mellom tilkoblinger når du tilhører mer enn én.
  </Step>
</Steps>

Koble til med en konto som har administrator- eller eierrollen i den
organisasjonen. Å slå en utløser-Zap av eller på, og alle handlinger, krever denne
rollen. En utløser-Zap som allerede er på, fortsetter å motta anropshendelser etter at
rollen endres eller tilkoblingen tilbakekalles. Slå den av for å stoppe dem. Finn
anrop fungerer for alle medlemmer.

Appen har ingen egen kostnad fra ThunderPhone. Anrop den foretar eller starter
faktureres til de vanlige ThunderPhone-prisene dine, og Zapier teller oppgaver på
Zapier-abonnementet ditt.

## Lag din første Zap

Denne Zap-en legger til en rad i et Google-ark hver gang et anrop avsluttes.

<Steps>
  <Step title="Foreta et anrop som skal brukes som eksempeldata">
    Åpne en agent i builderen, klikk på **Snakk**, og avslutt anropet. Testanrop
    i builderen utløser **Anrop fullført**, så dette gir utløseren et nylig anrop
    å laste inn.
  </Step>
  <Step title="Legg til utløseren">
    Velg **ThunderPhone** som utløserapp, sett hendelsen til **Anrop
    fullført**, og velg ThunderPhone-tilkoblingen din. Test utløseren.
    Zapier laster inn de sist fullførte anropene dine som eksempler, i samme
    format som en aktiv hendelse.
  </Step>
  <Step title="Legg til Google Sheets">
    Legg til en Google Sheets-handling som oppretter en regnearkrad. Velg et
    ark med en overskriftsrad, og tilordne deretter hver kolonne til et felt
    fra utløseren (se tabellen nedenfor).
  </Step>
  <Step title="Publiser Zap-en">
    Publiser og slå på Zap-en. Når du slår den på, opprettes et webhook-endepunkt
    i ThunderPhone-organisasjonen din med navnet **Zapier: Anrop fullført**. Når
    du slår av Zap-en, slettes dette endepunktet.
  </Step>
  <Step title="Test den">
    Foreta enda et testanrop i builderen. Når det avsluttes, kjører Zap-en og en
    rad vises.
  </Step>
</Steps>

Nyttige kolonner:

| Kolonne | Felt for Anrop fullført |
|---|---|
| Anrops-ID | Anrops-ID |
| Agent | Agentnavn |
| Retning | Retning |
| Fra | Nummer fra |
| Til | Nummer til |
| Startet | Startet kl. |
| Avsluttet | Avsluttet kl. |
| Varighet (s) | Varighet i sekunder |
| Status | Status |
| Årsak til avslutning | Årsak til avslutning |
| Anropslenke | Skriv inn `https://app.thunderphone.com/dashboard/call-history/`, og sett deretter inn anrops-ID |

Anropslenken åpner anropet i ThunderPhone-dashbordet for medlemmer av
organisasjonen din, med transkripsjon og opptak, slik at arket ikke trenger å
inneholde noen av dem.

Hendelsen kan også inneholde transkripsjonen som en liste over replikker, og en
opptaks-URL, en signert lenke som utløper. Legg dem bare til hvis arket trenger
dem. Anropstranskripsjoner, sammendrag og opptak kan inneholde person- eller
helseinformasjon. Send dem bare til apper organisasjonen din har tillatelse til
å bruke for disse dataene, under en BAA når helseinformasjon er involvert, og
behold bare feltene du trenger. Se
[`telephony.complete` / `web.complete`](/nb/webhooks/call-complete) for alle
felt.

<Note>
  Hver levering er signert. Appen kontrollerer `X-ThunderPhone-Signature`
  HMAC-en mot endepunktets hemmelighet før Zap-en kjører, og stopper alt som
  er usignert eller ugyldig. Hvis Zapier ikke godtar en levering, prøver
  ThunderPhone på nytt i opptil 24 timer. Se [oversikt over webhooks](/nb/webhooks/overview).
</Note>

## Utløsere, handlinger og søk

**Anrop vurdert** gir anrops-ID, agent-ID, agentnavn og vurderingen: vurderings-ID, poengsum, anropsutfall, sammendrag, vurderingsmodell og vurdert tidspunkt. Når du slår på en Zap, opprettes et endepunkt med navnet **Zapier: Call Graded**. Et anrop kan vurderes mer enn én gang, og hver fullførte vurderingskjøring utløser utløseren. Se
[`call.graded`](/nb/webhooks/events).

**Finn anrop** tar en anrops-ID, med en rullegardinliste over nylige anrop. Den returnerer agenten for anropet, retning, numre, start- og sluttidspunkter, status, avslutningsårsak, vurderingspoengsum og anropsutfall, transkripsjonen og en signert URL til opptaket når den er tilgjengelig. En ukjent anrops-ID returnerer ikke noe resultat i stedet for en feil.

**Foreta utgående anrop** tar:

| Felt | Betydning |
|---|---|
| Agent | En lagret agent. Rullegardinlisten viser agentene dine. |
| Til-nummer | Destinasjon i E.164-format, for eksempel `+14155552671`. |
| Fra-nummer | Rullegardinlisten viser bare numre som er aktivert for utgående anrop. |
| Variabler | Valgfritt JSON-objekt med verdier for plassholdere i agentens ledetekst. |
| Idempotensnøkkel | En stabil ID fra utløseren eller kildeposten. Påkrevd. |

Den returnerer anrops-ID, status og idempotent gjentakelse.

**Legg til kontakter i kampanje** legger til kontakter i en utkastkampanje. For én kontakt fyller du ut **Telefonnummer** i E.164-format og eventuelt **Kontaktvariabler**, et JSON-objekt der egenskapene blir kampanjevariabler. For en gruppe fyller du ut **Kontakter JSON** med en matrise på opptil 5 000 objekter. Hvert objekt trenger `phone_number`, og de andre egenskapene blir variabler. Trinnet mislykkes når alle kontakter avvises, og angir **Delvis vellykket** når bare noen av dem avvises.

**Start kampanje** starter eller gjenopptar en kampanje som har minst én kontakt. Den krever **Samtykke til belastning**. Se
[Utgående kampanjer](/nb/guides/outbound-campaigns).

## Før en Zap foretar anrop

Foreta utgående anrop og Start kampanje ringer ekte telefonnumre og starter fakturerbare anrop.

- Hvis ThunderPhone ber organisasjonen din om å bekrefte at de utgående anropene følger TCPA og andre lover for oppringing, må en administrator registrere denne bekreftelsen i dashbordet før en Zap kan starte anrop.
- Fra-nummeret må være aktivert for utgående anrop. Numre du tar med fra din egen operatør, kan brukes når de er verifisert. Numre levert av ThunderPhone er i utgangspunktet bare for innkommende anrop, og du kan be om utgående tilgang for dem i dashbordet. Se [Få et telefonnummer](/nb/guides/get-a-phone-number).
- Foreta utgående anrop krever en **Idempotensnøkkel**. Koble til en stabil ID fra utløseren eller kildeposten, for eksempel ThunderPhone-hendelses-ID-en eller en CRM-post-ID. Hvis Zapier prøver trinnet på nytt, gjenkjenner ThunderPhone nøkkelen og returnerer det opprinnelige anropet i stedet for å foreta et nytt. Unngå tidsstempler, tilfeldige verdier eller Zap-ID-en alene.
- Start kampanje krever **Samtykke til belastning**, som bekrefter at Zapen kan starte fakturerbare utgående anrop på kontoen din.
- Organisasjonen din er ansvarlig for å ha samtykke til å ringe hvert nummer og for å følge gjeldende lover for oppringing. Se
  [lover for utgående anrop](/nb/guides/outbound-calling-laws).

En idempotensnøkkel er unik i hele organisasjonen og kan være på maksimalt 128
tegn. Gjenbruk av en nøkkel med en annen agent, et annet nummer eller andre variabler mislykkes med en konflikt, så hvis to Zaper kan ringe om samme post, må du gi hver Zap sitt eget faste prefiks før post-ID-en.
[Foreta utgående anrop](/nb/guides/place-outbound-calls) beskriver API-et bak
denne handlingen.

## Eksempel-Zaps

- **Fullført samtale til et CRM-system.** Loggfør en aktivitet for hver fullførte samtale med
  status, avslutningsårsak og transkripsjon.
- **Vurdert samtale til oppfølging.** Filtrer på samtaleutfall eller poengsum, og send
  samtalen til riktig oppfølgingsarbeidsflyt.
- **Ny kundeemne til en kampanje.** Legg til kundeemnet i en utkastkampanje med Legg
  til kontakter i kampanje, og kjør deretter Start kampanje når noen godkjenner
  listen.

Samtaletranskripsjoner, sammendrag og opptak kan inneholde person- eller
helseopplysninger. Send dem bare til apper organisasjonen din har tillatelse
til å bruke for slike data, i henhold til en BAA når helseopplysninger er
involvert, og behold bare feltene du trenger.

## Feilsøking

**Et trinn mislykkes med en autorisasjonsfeil.** Koble ThunderPhone-
tilkoblingen til på nytt i Zapier, og godkjenn igjen. En tilkobling slutter å
fungere når personen som koblet den til, tilbakekaller den i ThunderPhone under
**Organisasjon → Nøkler → Autoriserte apper**, når personen forlater
organisasjonen, eller når det går 30 dager uten en vellykket tokenoppdatering.
Se [Koble til med OAuth](/nb/guides/oauth).

**Det mislykkes å slå en Zap på eller av, eller en handling avvises.** Personen
som koblet til, trenger administrator- eller eierrollen i organisasjonen.
Koble til på nytt med en konto som har rollen. En utløser-Zap som allerede er
på, fortsetter å motta samtalehendelser etter at rollen endres eller
tilkoblingen tilbakekalles. Slå den av for å stoppe dem.

**Du vil koble fra appen.** Slå av ThunderPhone-Zapene dine før du
tilbakekaller tilkoblingen, siden det å slå av en Zap sletter endepunktet og
krever en fungerende tilkobling. Hvis du tilbakekalte først, sletter du det
gjenværende **Zapier: …**-endepunktet med `DELETE /v1/developer/webhook-endpoints/{id}`
ved å bruke en administrator-API-nøkkel. Se [Webhook-endepunkter](/nb/webhooks/endpoints).

**Zapen skal bruke en annen organisasjon.** Hver tilkobling dekker én
organisasjon. Slå av Zapen først, slik at webhook-endepunktet slettes fra den
nåværende organisasjonen. Koble deretter en ny ThunderPhone-konto til i Zapier,
velg den andre organisasjonen når du godkjenner, og velg den tilkoblingen i
hvert ThunderPhone-trinn. Agenter, numre og kampanjer er forskjellige mellom
organisasjoner, så velg **Agent**, **Fra-nummer** og **Kampanje** på nytt i
hvert trinn som har dem. Slå deretter Zapen på igjen.

**Utløseren sluttet å kjøre.** Hver Zap med en ThunderPhone-utløser har ett
webhook-endepunkt i organisasjonen din, med navnet **Zapier: Samtale fullført**
eller **Zapier: Samtale vurdert**. Det opprettes når Zapen slås på og slettes
når den slås av. La det være som det er. Hvis det ble redigert eller slettet i
ThunderPhone, slår du Zapen av og på igjen for å opprette et nytt.
Med en administrator-API-nøkkel viser
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
nylige leveringsforsøk.

<Note>
  Vil du at agenten skal bruke Zapier-handlinger under en samtale i stedet for
  etter den? Koble til et Zapier MCP-endepunkt under **Tilkoblinger → MCP**. Se
  [MCP-servere](/nb/guides/mcp-servers). Hvis du vil sende de samme
  samtalehendelsene til din egen server, se
  [Webhook-endepunkter](/nb/webhooks/endpoints).
</Note>