---
title: "Använd ThunderPhone med Zapier"
description: "Anslut ThunderPhone-appen i Zapier till din organisation och skapa en Zap som körs varje gång ett samtal avslutas."
---

[Zapier](https://zapier.com) kopplar ihop appar med automatiserade arbetsflöden som kallas
Zaps. ThunderPhone-appen på Zapier lägger till:

- **Utlösare:** **Samtal slutfört** utlöses när ett telefon-, webb- eller testsamtal avslutas.
  **Samtal betygsatt** utlöses när betyget för ett slutfört samtal är tillgängligt.
- **Åtgärder:** **Ring utgående samtal**, **Lägg till kontakter i kampanj** och
  **Starta kampanj**.
- **Sökning:** **Hitta samtal** söker upp ett samtal efter ID och returnerar det med dess
  transkription och en signerad URL för inspelningen när en sådan är tillgänglig.

Hitta den på [ThunderPhone på Zapier](https://zapier.com/apps/thunderphone/integrations).
För en översikt över båda sätten att använda Zapier med ThunderPhone, se
[sidan för Zapier-integrationen](https://thunderphone.com/integrations/zapier).

## Anslut din organisation

Appen ansluter via OAuth. Du loggar in på ThunderPhone och godkänner
åtkomst för en organisation, och ingen API-nyckel kopieras till Zapier.

<Steps>
  <Step title="Lägg till ett ThunderPhone-steg">
    I Zap-redigeraren söker du efter **ThunderPhone** (visas med en Beta-etikett)
    och väljer en utlösare eller åtgärd. När Zapier frågar efter ett konto ansluter du ett nytt. Zapier öppnar
    ett inloggningsfönster för ThunderPhone.
  </Step>
  <Step title="Logga in och välj organisation">
    Logga in, kontrollera de begärda behörigheterna, välj organisationen och
    välj **Godkänn**. Appen begär åtkomst för att läsa dina agenter och telefonnummer,
    läsa och skriva samtal och kampanjer, hantera integrationer som webhook-
    slutpunkter samt se e-postadressen för ditt konto.
  </Step>
  <Step title="Kontrollera anslutningsnamnet">
    Zapier namnger anslutningen efter organisationen du godkände, så att du
    kan skilja anslutningar åt när du tillhör fler än en.
  </Step>
</Steps>

Anslut med ett konto som har administratörs- eller ägarrollen i den
organisationen. Att aktivera eller inaktivera en Zap med utlösare, och varje åtgärd, kräver den
rollen. En Zap med utlösare som redan är aktiverad fortsätter att ta emot samtalshändelser efter att
rollen ändras eller anslutningen återkallas. Inaktivera den för att stoppa dem. Hitta
samtal fungerar för alla medlemmar.

Appen har ingen egen kostnad från ThunderPhone. Samtal som den ringer upp eller startar
debiteras enligt dina vanliga ThunderPhone-priser, och Zapier räknar uppgifter enligt din
Zapier-plan.

## Bygg din första Zap

Den här Zapen lägger till en rad i ett Google-kalkylark varje gång ett samtal avslutas.

<Steps>
  <Step title="Ring ett samtal som du kan använda som exempeldata">
    Öppna en agent i byggaren, klicka på **Prata** och avsluta samtalet. Testanrop
    i byggaren utlöser Samtal slutfört, så detta ger utlösaren ett nyligt samtal
    att läsa in.
  </Step>
  <Step title="Lägg till utlösaren">
    Välj **ThunderPhone** som utlösarapp, ställ in händelsen på **Samtal
    slutfört** och välj din ThunderPhone-anslutning. Testa utlösaren.
    Zapier läser in dina senast slutförda samtal som exempel, med samma
    struktur som en livehändelse.
  </Step>
  <Step title="Lägg till Google Sheets">
    Lägg till en Google Sheets-åtgärd som skapar en kalkylarksrad. Välj ett
    kalkylark med en rubrikrad och mappa sedan varje kolumn till ett fält från
    utlösaren (se tabellen nedan).
  </Step>
  <Step title="Publicera Zapen">
    Publicera och aktivera Zapen. När du aktiverar den skapas en webhookslutpunkt
    i din ThunderPhone-organisation med namnet **Zapier: Samtal slutfört**. När
    du inaktiverar Zapen tas slutpunkten bort.
  </Step>
  <Step title="Testa den">
    Gör ett nytt testanrop i byggaren. När det avslutas körs Zapen och en rad
    visas.
  </Step>
</Steps>

Användbara kolumner:

| Kolumn | Fält för Samtal slutfört |
|---|---|
| Samtals-ID | Samtals-ID |
| Agent | Agentnamn |
| Riktning | Riktning |
| Från | Frånnummer |
| Till | Tillnummer |
| Startade | Starttid |
| Avslutades | Sluttid |
| Varaktighet (s) | Varaktighet i sekunder |
| Status | Status |
| Orsak till avslut | Orsak till avslut |
| Samtalslänk | Skriv `https://app.thunderphone.com/dashboard/call-history/` och infoga sedan samtals-ID |

Samtalslänken öppnar samtalet i ThunderPhone-instrumentpanelen för medlemmar
i din organisation, tillsammans med transkriptionen och inspelningen, så
kalkylarket behöver inte innehålla någon av dem.

Händelsen kan även innehålla transkriptionen som en lista med turer och en
inspelnings-URL, en signerad länk som upphör att gälla. Lägg bara till dem om
kalkylarket behöver dem. Samtalstranskriptioner, sammanfattningar och
inspelningar kan innehålla person- eller hälsoinformation. Skicka dem endast
till appar som din organisation får använda för den informationen, enligt ett
BAA när hälsoinformation ingår, och behåll endast de fält du behöver. Se
[`telephony.complete` / `web.complete`](/sv/webhooks/call-complete) för alla
fält.

<Note>
  Varje leverans är signerad. Appen kontrollerar `X-ThunderPhone-Signature`
  HMAC mot slutpunktens hemlighet innan Zapen körs och stoppar allt som är
  osignerat eller ogiltigt. Om Zapier inte godtar en leverans försöker
  ThunderPhone igen i upp till 24 timmar. Se [Översikt över webhooks](/sv/webhooks/overview).
</Note>

## Utlösare, åtgärder och sökning

**Samtal betygsatt** ger samtals-ID, agent-ID, agentnamn och bedömningen: bedömnings-ID, poäng, samtalsutfall, sammanfattning, bedömningsmodell och betygsatt den. När du aktiverar en Zap skapas en slutpunkt med namnet **Zapier: Samtal betygsatt**. Ett samtal kan betygsättas mer än en gång, och varje slutförd bedömningskörning utlöser utlösaren. Se
[`call.graded`](/sv/webhooks/events).

**Hitta samtal** tar ett samtals-ID med en rullista över senaste samtal. Det returnerar samtalets agent, riktning, nummer, start- och sluttider, status, avslutsorsak, bedömningspoäng och samtalsutfall, transkriptionen samt en signerad inspelnings-URL när en sådan är tillgänglig. Ett okänt samtals-ID returnerar inget resultat i stället för ett fel.

**Ring utgående samtal** tar:

| Fält | Betydelse |
|---|---|
| Agent | En sparad agent. Rullistan visar dina agenter. |
| Till-nummer | Destination i E.164-format, till exempel `+14155552671`. |
| Från-nummer | Rullistan visar endast nummer som är aktiverade för utgående samtal. |
| Variabler | Valfritt JSON-objekt med värden för platshållare i agentens prompt. |
| Idempotensnyckel | Ett stabilt ID från utlösaren eller källposten. Krävs. |

Den returnerar samtals-ID, status och idempotent upprepning.

**Lägg till kontakter i kampanj** lägger till kontakter i ett kampanjutkast. För en kontakt fyller du i **Telefonnummer** i E.164-format och valfritt **Kontaktvariabler**, ett JSON-objekt vars egenskaper blir kampanjvariabler. För ett parti fyller du i **Kontakter JSON** med en matris med upp till 5 000 objekt. Varje objekt behöver `phone_number`, och dess övriga egenskaper blir variabler. Steget misslyckas när alla kontakter avvisas och anger **Delvis lyckad** när endast vissa avvisas.

**Starta kampanj** startar eller återupptar en kampanj som har minst en kontakt. Det kräver **Godkännande av debitering**. Se
[Utgående kampanjer](/sv/guides/outbound-campaigns).

## Innan en Zap ringer samtal

Ring utgående samtal och Starta kampanj ringer riktiga telefonnummer och startar debiterbara samtal.

- Om ThunderPhone ber din organisation att bekräfta att dess utgående samtal följer TCPA och andra lagar för uppringningar måste en administratör registrera bekräftelsen i kontrollpanelen innan en Zap kan starta samtal.
- Från-numret måste vara aktiverat för utgående samtal. Nummer som du tar med från din egen operatör kan användas när de har verifierats. Nummer från ThunderPhone är först endast för inkommande samtal, och du kan begära åtkomst för utgående samtal för dem i kontrollpanelen. Se [Skaffa ett telefonnummer](/sv/guides/get-a-phone-number).
- Ring utgående samtal kräver en **Idempotensnyckel**. Mappa ett stabilt ID från utlösaren eller källposten, till exempel ThunderPhone-händelse-ID:t eller ett CRM-post-ID. Om Zapier försöker steget igen känner ThunderPhone igen nyckeln och returnerar det ursprungliga samtalet i stället för att ringa ett andra. Undvik tidsstämplar, slumpmässiga värden eller endast Zap-ID:t.
- Starta kampanj kräver **Godkännande av debitering**, vilket bekräftar att Zapen får starta debiterbara utgående samtal på ditt konto.
- Din organisation ansvarar för att ha samtycke till att ringa varje nummer och för att följa tillämpliga lagar för uppringningar. Se
  [lagar för utgående samtal](/sv/guides/outbound-calling-laws).

En idempotensnyckel är unik inom din organisation och får vara högst 128
tecken. Att återanvända en nyckel med en annan agent, ett annat nummer eller andra variabler misslyckas med en konflikt, så om två Zapar kan ringa om samma post ska du ge varje Zap ett eget fast prefix före post-ID:t.
[Ring utgående samtal](/sv/guides/place-outbound-calls) beskriver API:t bakom
den här åtgärden.

## Exempel på Zaps

- **Avslutat samtal till ett CRM-system.** Logga en aktivitet för varje avslutat samtal med dess status, avslutsorsak och transkription.
- **Bedömt samtal till uppföljning.** Filtrera efter samtalsresultat eller poäng och dirigera samtalet till rätt uppföljningsarbetsflöde.
- **Ny lead till en kampanj.** Lägg till leaden i en utkastkampanj med Lägg till kontakter i kampanj och kör sedan Starta kampanj när någon har godkänt listan.

Samtalstranskriptioner, sammanfattningar och inspelningar kan innehålla person- eller hälsouppgifter. Skicka dem endast till appar som din organisation får använda för dessa uppgifter, under en BAA när hälsouppgifter ingår, och behåll endast de fält du behöver.

## Felsökning

**Ett steg misslyckas med ett auktoriseringsfel.** Återanslut ThunderPhone-anslutningen i Zapier och godkänn igen. En anslutning slutar fungera när personen som anslöt den återkallar den i ThunderPhone under **Organisation → Nycklar → Auktoriserade appar**, när personen lämnar organisationen eller när det går 30 dagar utan en lyckad tokenuppdatering. Se [Anslut med OAuth](/sv/guides/oauth).

**Det går inte att slå på eller stänga av en Zap, eller så nekas en åtgärd.** Personen som anslöt behöver administratörs- eller ägarrollen i organisationen. Återanslut med ett konto som har den. En Zap med en utlösare som redan är på fortsätter att ta emot samtalshändelser efter att rollen ändras eller anslutningen återkallas. Stäng av den för att stoppa dem.

**Du vill koppla från appen.** Stäng av dina ThunderPhone Zaps innan du återkallar anslutningen, eftersom det att stänga av en Zap tar bort dess slutpunkt och kräver en fungerande anslutning. Om du återkallade först tar du bort den kvarvarande **Zapier: …**-slutpunkten med `DELETE /v1/developer/webhook-endpoints/{id}` med en administratörs-API-nyckel. Se [Webhook-slutpunkter](/sv/webhooks/endpoints).

**Zapen ska använda en annan organisation.** Varje anslutning omfattar en organisation. Stäng först av Zapen så att dess webhook-slutpunkt tas bort från den aktuella organisationen. Anslut sedan ett nytt ThunderPhone-konto i Zapier, välj den andra organisationen när du godkänner och välj den anslutningen i varje ThunderPhone-steg. Agenter, nummer och kampanjer skiljer sig mellan organisationer, så välj **Agent**, **Frånnummer** och **Kampanj** igen i varje steg som har dem. Slå sedan på Zapen igen.

**Utlösaren slutade utlösas.** Varje Zap med en ThunderPhone-utlösare har en webhook-slutpunkt i din organisation med namnet **Zapier: Samtal slutfört** eller **Zapier: Samtal bedömt**. Den skapas när Zapen slås på och tas bort när den stängs av. Låt den vara som den är. Om den har redigerats eller tagits bort i ThunderPhone stänger du av och slår på Zapen igen för att skapa en ny.
Med en administratörs-API-nyckel visar
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
senaste leveransförsöken.

<Note>
  Vill du att agenten ska använda Zapier-åtgärder under ett samtal i stället för efter det?
  Anslut en Zapier MCP-slutpunkt under **Anslutningar → MCP**. Se
  [MCP-servrar](/sv/guides/mcp-servers). För att skicka samma samtalshändelser till din
  egen server, se [Webhook-slutpunkter](/sv/webhooks/endpoints).
</Note>