---
title: "Brug ThunderPhone med Zapier"
description: "Forbind ThunderPhone-appen på Zapier med din organisation, og opbyg en Zap, der kører, hver gang et opkald afsluttes."
---

[Zapier](https://zapier.com) forbinder apps med automatiserede arbejdsgange kaldet
Zaps. ThunderPhone-appen på Zapier tilføjer:

- **Udløsere:** **Opkald afsluttet** udløses, når et telefon-, web- eller testopkald afsluttes.
  **Opkald vurderet** udløses, når vurderingen af et afsluttet opkald er tilgængelig.
- **Handlinger:** **Foretag udgående opkald**, **Føj kontakter til kampagne** og
  **Start kampagne**.
- **Søgning:** **Find opkald** slår et opkald op efter ID og returnerer det med
  dets transskription og en signeret URL til optagelsen, når en sådan er tilgængelig.

Find den på [ThunderPhone på Zapier](https://zapier.com/apps/thunderphone/integrations).
Du kan få et overblik over begge måder at bruge Zapier med ThunderPhone på på
[integrationssiden for Zapier](https://thunderphone.com/integrations/zapier).

## Forbind din organisation

Appen forbindes via OAuth. Du logger ind på ThunderPhone og godkender
adgang for én organisation, og ingen API-nøgle kopieres til Zapier.

<Steps>
  <Step title="Tilføj et ThunderPhone-trin">
    I Zap-editoren skal du søge efter **ThunderPhone** (vist med mærkatet Beta)
    og vælge en udløser eller handling. Når Zapier beder om en konto, skal du oprette forbindelse til en ny. Zapier åbner
    et ThunderPhone-logindvindue.
  </Step>
  <Step title="Log ind, og vælg organisationen">
    Log ind, gennemgå de anmodede tilladelser, vælg organisationen, og
    vælg **Godkend**. Appen anmoder om at læse dine agenter og telefonnumre,
    læse og skrive opkald og kampagner, administrere integrationer såsom webhook-
    slutpunkter og se din kontos e-mailadresse.
  </Step>
  <Step title="Kontrollér forbindelsens navn">
    Zapier navngiver forbindelsen efter den organisation, du godkendte, så du
    kan skelne mellem forbindelser, når du tilhører mere end én.
  </Step>
</Steps>

Brug en konto, der har administrator- eller ejersrollen i den pågældende
organisation. Aktivering eller deaktivering af en udløser-Zap og alle handlinger kræver
denne rolle. En udløser-Zap, der allerede er aktiv, bliver ved med at modtage opkaldshændelser, efter
rollen ændres, eller forbindelsen tilbagekaldes. Deaktiver den for at stoppe dem. Find
opkald fungerer for alle medlemmer.

Appen har ingen egne ThunderPhone-omkostninger. Opkald, den foretager eller starter,
faktureres efter dine normale ThunderPhone-priser, og Zapier tæller opgaver på dit
Zapier-abonnement.

## Opret din første Zap

Denne Zap tilføjer en række i et Google-ark, hver gang et opkald afsluttes.

<Steps>
  <Step title="Foretag et opkald, der kan bruges som eksempeldata">
    Åbn en agent i byggeren, klik på **Tal**, og afslut opkaldet. Testopkald i
    byggeren udløser Opkald fuldført, så dette giver udløseren et nyligt
    opkald at indlæse.
  </Step>
  <Step title="Tilføj udløseren">
    Vælg **ThunderPhone** som udløserapp, indstil hændelsen til **Opkald
    fuldført**, og vælg din ThunderPhone-forbindelse. Test udløseren.
    Zapier indlæser dine senest fuldførte opkald som eksempler i samme format
    som en aktiv hændelse.
  </Step>
  <Step title="Tilføj Google Sheets">
    Tilføj en Google Sheets-handling, der opretter en regnearksrække. Vælg et
    ark med en overskriftsrække, og tilknyt derefter hver kolonne til et felt
    fra udløseren (se tabellen nedenfor).
  </Step>
  <Step title="Udgiv Zap'en">
    Udgiv og slå Zap'en til. Når du slår den til, oprettes der et webhook-slutpunkt
    i din ThunderPhone-organisation med navnet **Zapier: Opkald fuldført**.
    Når du slår Zap'en fra, slettes dette slutpunkt.
  </Step>
  <Step title="Test den">
    Foretag endnu et testopkald i byggeren. Når det afsluttes, kører Zap'en,
    og der vises en række.
  </Step>
</Steps>

Nyttige kolonner:

| Kolonne | Felt for Opkald fuldført |
|---|---|
| Opkalds-id | Opkalds-id |
| Agent | Agentnavn |
| Retning | Retning |
| Fra | Fra-nummer |
| Til | Til-nummer |
| Startet | Startet på |
| Afsluttet | Afsluttet på |
| Varighed (s) | Varighed i sekunder |
| Status | Status |
| Årsag til afslutning | Årsag til afslutning |
| Opkaldslink | Skriv `https://app.thunderphone.com/dashboard/call-history/`, og indsæt derefter opkalds-id |

Opkaldslinket åbner opkaldet i ThunderPhone-dashboardet for medlemmer af
din organisation sammen med dets transskription og optagelse, så arket ikke
behøver at indeholde nogen af delene.

Hændelsen kan også indeholde transskriptionen som en liste over replikskift
samt en optagelses-URL, et signeret link, der udløber. Tilføj dem kun, hvis
arket har brug for dem. Opkaldstransskriptioner, resuméer og optagelser kan
indeholde person- eller helbredsoplysninger. Send dem kun til apps, som din
organisation har tilladelse til at bruge til disse data, i henhold til en BAA,
når der er tale om helbredsoplysninger, og behold kun de felter, du har brug
for. Se
[`telephony.complete` / `web.complete`](/da/webhooks/call-complete) for alle
felter.

<Note>
  Hver levering er signeret. Appen kontrollerer `X-ThunderPhone-Signature`
  HMAC'en mod slutpunktets hemmelighed, før Zap'en kører, og stopper ved alt,
  der er usigneret eller ugyldigt. Hvis Zapier ikke accepterer en levering,
  prøver ThunderPhone igen i op til 24 timer. Se [Oversigt over webhooks](/da/webhooks/overview).
</Note>

## Udløsere, handlinger og søgning

**Opkald bedømt** giver opkalds-id, agent-id, agentnavn og bedømmelsen: Bedømmelses-id, score, opkaldsresultat, opsummering, bedømmermodel og bedømt kl. Når du aktiverer en Zap, oprettes et endpoint med navnet **Zapier: Opkald bedømt**. Et opkald kan bedømmes mere end én gang, og hver afsluttet bedømmelseskørsel udløser udløseren. Se
[`call.graded`](/da/webhooks/events).

**Find opkald** tager et opkalds-id med en rullemenu over seneste opkald. Den returnerer opkaldets agent, retning, numre, start- og sluttidspunkter, status, afslutningsårsag, bedømmelsesscore og opkaldsresultat, transskriptionen og en signeret optagelses-URL, når en er tilgængelig. Et ukendt opkalds-id returnerer intet resultat i stedet for en fejl.

**Foretag udgående opkald** tager:

| Felt | Betydning |
|---|---|
| Agent | En gemt agent. Rullemenuen viser dine agenter. |
| Til-nummer | Destination i E.164-format, f.eks. `+14155552671`. |
| Fra-nummer | Rullemenuen viser kun numre, der er aktiveret til udgående opkald. |
| Variabler | Valgfrit JSON-objekt med værdier til pladsholdere i agentens prompt. |
| Idempotensnøgle | Et stabilt id fra udløseren eller kildeposten. Påkrævet. |

Den returnerer opkalds-id, status og idempotent gentagelse.

**Føj kontakter til kampagne** føjer kontakter til en kladdekampagne. For én kontakt skal du udfylde **Telefonnummer** i E.164-format og eventuelt **Kontaktvariabler**, et JSON-objekt, hvis egenskaber bliver kampagnevariabler. For en batch skal du udfylde **Kontakter JSON** med et array på op til 5.000 objekter. Hvert objekt skal have `phone_number`, og dets øvrige egenskaber bliver variabler. Trinnet fejler, når alle kontakter afvises, og angiver **Delvis succes**, når kun nogle af dem afvises.

**Start kampagne** starter eller genoptager en kampagne, der har mindst én kontakt. Den kræver **Samtykke til opkrævning**. Se
[Udgående kampagner](/da/guides/outbound-campaigns).

## Før en Zap foretager opkald

Foretag udgående opkald og Start kampagne ringer til rigtige telefonnumre og starter opkald, der faktureres.

- Hvis ThunderPhone beder din organisation om at bekræfte, at dens udgående opkald overholder TCPA og andre opkaldslove, skal en administrator registrere den bekræftelse i dashboardet, før en Zap kan starte opkald.
- Fra-nummeret skal være aktiveret til udgående opkald. Numre, du medbringer fra din egen operatør, kvalificerer sig, når de er verificeret. Numre leveret af ThunderPhone starter kun med indgående opkald, og du kan anmode om udgående adgang til dem i dashboardet. Se [Få et telefonnummer](/da/guides/get-a-phone-number).
- Foretag udgående opkald kræver en **Idempotensnøgle**. Knyt et stabilt id fra udløseren eller kildeposten, f.eks. ThunderPhone-hændelses-id'et eller et CRM-post-id. Hvis Zapier prøver trinnet igen, genkender ThunderPhone nøglen og returnerer det oprindelige opkald i stedet for at foretage et andet. Undgå tidsstempler, tilfældige værdier eller Zap-id'et alene.
- Start kampagne kræver **Samtykke til opkrævning**, som bekræfter, at Zap'en må starte fakturerbare udgående opkald på din konto.
- Din organisation er ansvarlig for at have samtykke til at ringe til hvert nummer og for at overholde de gældende opkaldslove. Se
  [love for udgående opkald](/da/guides/outbound-calling-laws).

En idempotensnøgle er unik på tværs af din organisation og kan højst være 128 tegn. Genbrug af en nøgle med en anden agent, et andet nummer eller andre variabler fejler med en konflikt, så hvis to Zaps kan ringe vedrørende den samme post, skal hver Zap have sit eget faste præfiks før post-id'et.
[Foretag udgående opkald](/da/guides/place-outbound-calls) dækker API'et bag denne handling.

## Eksempel-Zaps

- **Gennemført opkald til et CRM.** Registrer en aktivitet for hvert afsluttet opkald med dets status, afslutningsårsag og transskription.
- **Vurderet opkald til opfølgning.** Filtrer efter opkaldsresultatet eller scoren, og send opkaldet til det rette opfølgningsworkflow.
- **Nyt lead til en kampagne.** Føj leadet til en kladdekampagne med Tilføj kontakter til kampagne, og kør derefter Start kampagne, når nogen har godkendt listen.

Opkaldstransskriptioner, opsummeringer og optagelser kan indeholde person- eller helbredsoplysninger. Send dem kun til apps, som din organisation har tilladelse til at bruge til disse data, under en BAA, når der er tale om helbredsoplysninger, og gem kun de felter, du har brug for.

## Fejlfinding

**Et trin fejler med en autorisationsfejl.** Genopret ThunderPhone-forbindelsen i Zapier, og godkend den igen. En forbindelse holder op med at virke, når personen, der oprettede forbindelsen, tilbagekalder den i ThunderPhone under **Organisation → Nøgler → Autoriserede apps**, når personen forlader organisationen, eller hvis der går 30 dage uden en vellykket tokenfornyelse. Se
[Forbind med OAuth](/da/guides/oauth).

**Det fejler at slå en Zap til eller fra, eller en handling afvises.** Personen, der oprettede forbindelsen, skal have rollen som administrator eller ejer i organisationen. Genopret forbindelsen med en konto, der har rollen. En trigger-Zap, der allerede er slået til, fortsætter med at modtage opkaldshændelser, efter rollen ændres, eller forbindelsen tilbagekaldes. Slå den fra for at stoppe dem.

**Du vil afbryde appen.** Slå dine ThunderPhone-Zaps fra, før du tilbagekalder forbindelsen, da det at slå en Zap fra sletter dens endpoint og kræver en fungerende forbindelse. Hvis du tilbagekaldte først, skal du slette det resterende **Zapier: …**-endpoint med `DELETE /v1/developer/webhook-endpoints/{id}` ved hjælp af en administrator-API-nøgle. Se [Webhook-endpoints](/da/webhooks/endpoints).

**Zappen skal bruge en anden organisation.** Hver forbindelse dækker én organisation. Slå først Zappen fra, så dens webhook-endpoint slettes fra den aktuelle organisation. Tilslut derefter en ny ThunderPhone-konto i Zapier, vælg den anden organisation, når du godkender, og vælg den forbindelse på hvert ThunderPhone-trin. Agenter, numre og kampagner er forskellige mellem organisationer, så vælg **Agent**, **Fra-nummer** og **Kampagne** igen på hvert trin, der har dem. Slå derefter Zappen til igen.

**Triggeren holdt op med at udløses.** Hver Zap med en ThunderPhone-trigger har sit eget webhook-endpoint i din organisation med navnet **Zapier: Opkald gennemført** eller **Zapier: Opkald vurderet**. Det oprettes, når Zappen slås til, og slettes, når den slås fra. Lad det være, som det er. Hvis det blev redigeret eller slettet i ThunderPhone, skal du slå Zappen fra og til igen for at oprette et nyt.
Med en administrator-API-nøgle viser
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
seneste leveringsforsøg.

<Note>
  Vil du have, at agenten bruger Zapier-handlinger under et opkald i stedet for bagefter?
  Forbind et Zapier MCP-endpoint under **Forbindelser → MCP**. Se
  [MCP-servere](/da/guides/mcp-servers). Hvis du vil sende de samme opkaldshændelser til din
  egen server, kan du se [Webhook-endpoints](/da/webhooks/endpoints).
</Note>