Brug ThunderPhone med n8n

Installer ThunderPhone-noden til n8n, tilslut en server-API-nøgle, og opbyg et workflow, der kører, hver gang et opkald afsluttes.

n8n er et værktøj til automatisering af workflows. ThunderPhone-pakken til n8n tilføjer to noder:

• ThunderPhone Trigger starter et workflow, når et opkald slutter (Opkald afsluttet), eller når en kørsel til opkaldsvurdering afsluttes (Opkald vurderet).
• ThunderPhone foretager udgående opkald, tilføjer kontakter til kampagner og starter dem, henter opkald med deres transskription og optagelse og viser dine agenter og telefonnumre.

Det er en verificeret fællesskabsnode, som er angivet på ThunderPhone på n8n.

Installer noden#

Klik på + i n8n-editoren for at åbne nodepanelet, og søg efter ThunderPhone. En instansejer skal muligvis konfigurere verificerede noder, før andre brugere kan tilføje dem.

På selvhostet n8n kan du også installere efter pakkenavn: Åbn Indstillinger > Fællesskabsnoder, og installer n8n-nodes-thunderphone. Kontrollér risiciene ved fællesskabsnoder og din instanspolitik, før du installerer.

Opret en server-API-nøgle#

1. Åbn fanen Nøgler

   Gå til Organisation → Nøgler i ThunderPhone, og klik på Opret nøgle.

2. Giv den et navn

   Brug et navn, der angiver, hvor nøglen bruges, f.eks. "n8n".

3. Kopiér den nu

   Den fulde sk_live_...-hemmelighed vises kun én gang. Kopiér den, før du lukker dialogen.

Kun en administrator eller ejer kan oprette nøglen, og ThunderPhone behandler anmodninger foretaget med den, som om de kommer fra den pågældende person. Triggeren og kampagne- handlingerne kræver, at personen beholder rollen som administrator eller ejer. Opret en server-API-nøgle beskriver rotation og tilbagekaldelse.

Tilføj legitimationsoplysningerne i n8n#

1. Opret legitimationsoplysninger af typen ThunderPhone API i n8n.
2. Indsæt nøglen i API-nøgle.
3. Gem den, og kør testen af legitimationsoplysningerne. Testen læser ét opkald fra din organisation med GET /v1/calls?limit=1.

Byg et første workflow#

Dette workflow tilføjer en række til et Google Sheet, hver gang et opkald afsluttes.

1. Tilføj udløseren

   Tilføj ThunderPhone Trigger, vælg din ThunderPhone API-legitimationsoplysning, og indstil Event til Call Completed.

2. Hent opkaldet

   Tilføj en ThunderPhone-node. Indstil Resource til Call, Operation til Get og Call ID til udtrykket {{ $json.data.call_id }}. Outputtet er opkaldsposten plus transcripts og recording_url, et kortvarigt link, som er null, når opkaldet ikke har nogen optagelse.

3. Tilføj en række

   Tilføj en Google Sheets-node, der tilføjer en række, og knyt de ønskede kolonner fra outputtet Get Call (se tabellen nedenfor).

4. Aktivér workflowet

   Gem og aktivér. Udløseren registrerer sin Production URL som et webhook-slutpunkt i din ThunderPhone-organisation. Deaktivering af workflowet sletter dette slutpunkt.

5. Test det

   Åbn en agent i builderen, klik på Talk, og afslut opkaldet. Builderens testopkald leveres som web.complete, en af de to hændelser bag Call Completed, så workflowet kører, og der vises en række.

Nyttige kolonner:

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

For også at tilføje transskriptionen skal du knytte {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. Optagelses-URL'en udløber, så gem opkalds-ID'et, og kør Get Call igen, når du har brug for et nyt link. Opkaldstransskriptioner, resuméer og optagelser kan indeholde personlige oplysninger eller helbredsoplysninger. Send dem kun til apps, som din organisation må bruge til disse data, under en BAA, når helbredsoplysninger er involveret, og behold kun de felter, du har brug for.

Udløseren giver hele hændelsen som output: type, event_id og data. Se telephony.complete / web.complete og call.graded for alle felter. Levering sker mindst én gang, og event_id forbliver det samme ved genforsøg for én hændelse, så kontrollér det før et trin, der ikke må gentages.

Foretag udgående opkald sikkert#

Foretag udgående opkald (Ressource Udgående opkald, Handling Foretag) tager:

Knyt Idempotensnøgle til et id fra det, der udløste kørslen, f.eks. et CRM-post-id eller udløserens event_id. Noden sender n8n:<node ID>:<your value>, så:

• Et automatisk genforsøg eller Prøv kørsel igen sender den samme nøgle, og ThunderPhone returnerer det oprindelige opkald med idempotent_replay: true i stedet for at ringe op igen.
• To ThunderPhone-noder, der modtager den samme post, sender forskellige nøgler.
• En tom værdi fejler, før der sendes nogen anmodning.

Undgå tidsstempler, tilfældige værdier og n8n-kørsels- eller workflow-id'er. En ny værdi ved genforsøg foretager et andet rigtigt opkald. Hele nøglen må højst være på 128 tegn. Genbrug af en nøgle med en anden agent, et andet nummer eller andre variabler fejler med en konflikt.

Kampagner. Tilføj kontakter (Ressource Kampagne) tilføjer kontakter til en kladdekampagne. Den tager et kampagne-id og et JSON-array med kontakter. Hver kontakt skal have phone_number; andre nøgler bliver opkaldsvariabler. Noden fejler, når alle kontakter afvises, og angiver partial_success: true, når kun nogle af dem afvises. Start kræver afkrydsningsfeltet, der bekræfter, at kampagnen foretager rigtige opkald og bruger ThunderPhone- kreditter. Se Udgående kampagner.

Før et workflow starter opkald:

• Hvis ThunderPhone beder din organisation om at bekræfte, at dens udgående opkald overholder TCPA og andre opkaldslove, skal en administrator først registrere den bekræftelse i dashboardet.
• Afsendernummeret skal være aktiveret til udgående opkald. Numre, du medbringer fra din egen udbyder, kvalificerer, når de er verificeret. ThunderPhone-numre starter kun med indgående opkald og kan godkendes til udgående brug: En administrator anmoder om det fra siden Telefonnumre. Se Få et telefonnummer.
• 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.

Eksempel-workflows#

• CRM-kontakter til en kampagne. Tilføj CRM-kontakter til en ThunderPhone- kladdekampagne, og start derefter kampagnen, når nogen godkender listen.
• Fuldført opkald til kundeposten. Ved Opkald fuldført skal du køre Hent opkald og gemme transskriptionen og optagelseslinket på den tilsvarende kundepost.
• Lave vurderinger til gennemgang. Ved Opkald bedømt skal du filtrere efter {{ $json.data.grade.score }} og sende opkald med lave vurderinger til en gennemgangskø med opkalds-id og vurderingsoplysninger. Et opkald kan blive vurderet mere end én gang, og hver afsluttet vurderingskørsel udløser triggeren, så behold kun den seneste graded_at for hvert opkalds-id.

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 helbredsoplysninger er involveret, og behold kun de felter, du har brug for.