Koristite ThunderPhone s n8n

Instalirajte čvor ThunderPhone za n8n, povežite API ključ poslužitelja i izradite radni tijek koji se pokreće svaki put kada poziv završi.

n8n je alat za automatizaciju radnih tijekova. Paket ThunderPhone za n8n dodaje dva čvora:

• ThunderPhone Trigger pokreće radni tijek kada poziv završi (Call Completed) ili kada se dovrši ocjenjivanje poziva (Call Graded).
• ThunderPhone upućuje odlazne pozive, dodaje kontakte u kampanje i pokreće ih, dohvaća pozive s njihovim prijepisom i snimkom te prikazuje vaše agente i telefonske brojeve.

To je verificirani čvor zajednice, naveden na stranici ThunderPhone na n8n-u.

Instalirajte čvor#

U uređivaču n8n kliknite + da biste otvorili ploču čvorova i potražite ThunderPhone. Vlasnik instance možda će morati postaviti verificirane čvorove prije nego što ih drugi korisnici mogu dodati.

Na samostalno hostiranom n8n-u možete instalirati i prema nazivu paketa: otvorite Settings > Community Nodes i instalirajte n8n-nodes-thunderphone. Provjerite rizike čvorova zajednice i pravila svoje instance prije instalacije.

Izradite API ključ poslužitelja#

1. Otvorite karticu Keys

   U ThunderPhoneu idite na Organization → Keys i kliknite Create key.

2. Imenujte ga

   Upotrijebite naziv koji označava gdje se ključ koristi, primjerice „n8n”.

3. Kopirajte ga odmah

   Cijela tajna sk_live_... prikazuje se samo jednom. Kopirajte je prije nego što zatvorite dijaloški okvir.

Samo administrator ili vlasnik može izraditi ključ, a ThunderPhone zahtjeve upućene s njim smatra zahtjevima te osobe. Okidač i radnje za kampanje zahtijevaju da ta osoba zadrži ulogu administratora ili vlasnika. Vodič za izradu API ključa poslužitelja obuhvaća rotaciju i opoziv.

Dodajte vjerodajnicu u n8n#

1. U n8n-u izradite vjerodajnicu vrste ThunderPhone API.
2. Zalijepite ključ u API Key.
3. Spremite je i pokrenite test vjerodajnice. Test čita jedan poziv iz vaše organizacije putem GET /v1/calls?limit=1.

Izradite prvi tijek rada#

Ovaj tijek rada dodaje redak u Google tablicu svaki put kada poziv završi.

1. Dodajte okidač

   Dodajte ThunderPhone Trigger, odaberite svoje vjerodajnice za ThunderPhone API i postavite Događaj na Poziv dovršen.

2. Dohvatite poziv

   Dodajte čvor ThunderPhone. Postavite Resurs na Poziv, Operacija na Dohvati, a ID poziva na izraz {{ $json.data.call_id }}. Izlaz je zapis poziva uz transcripts i recording_url, kratkotrajnu poveznicu koja je null kada poziv nema snimku.

3. Dodajte redak

   Dodajte čvor Google Sheets koji dodaje redak i mapirajte željene stupce iz izlaza Dohvati poziv (pogledajte tablicu u nastavku).

4. Aktivirajte tijek rada

   Spremite i aktivirajte. Okidač registrira svoj produkcijski URL kao krajnju točku webhooka u vašoj organizaciji ThunderPhone. Deaktiviranjem tijeka rada briše se ta krajnja točka.

5. Testirajte

   Otvorite agenta u alatu za izradu, kliknite Razgovarajte i završite poziv. Testni pozivi iz alata za izradu isporučuju se kao web.complete, jedan od dva događaja koji stoje iza događaja Poziv dovršen, pa se tijek rada pokreće i pojavljuje se redak.

Korisni stupci:

Poveznica na poziv otvara poziv u nadzornoj ploči ThunderPhone za članove vaše organizacije, zajedno s prijepisom i snimkom, pa ih tablica ne mora sadržavati.

Ako ipak želite dodati prijepis, mapirajte {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. URL snimke istječe, stoga spremite ID poziva i ponovno pokrenite Dohvati poziv kada vam je potrebna nova poveznica. Prijepisi, sažeci i snimke poziva mogu sadržavati osobne ili zdravstvene podatke. Šaljite ih samo aplikacijama koje vaša organizacija smije upotrebljavati za te podatke, u skladu s BAA ugovorom kada je riječ o zdravstvenim informacijama, i zadržite samo potrebna polja.

Okidač ispisuje cjelokupan događaj: type, event_id i data. Pogledajte telephony.complete / web.complete i call.graded za sva polja. Isporuka se obavlja najmanje jednom, a event_id ostaje isti pri ponovnim pokušajima jednog događaja, stoga ga provjerite prije koraka koji se ne smije ponoviti.

Sigurno upućujte odlazne pozive#

Upućivanje odlaznog poziva (resurs Odlazni poziv, radnja Upućivanje) prima:

Povežite Ključ idempotentnosti s ID-jem iz onoga što je pokrenulo izvršavanje, primjerice ID-jem CRM zapisa ili event_id okidača. Čvor šalje n8n:<node ID>:<your value>, stoga:

• Automatski ponovni pokušaj ili Ponovi izvršavanje šalje isti ključ, a ThunderPhone vraća izvorni poziv s idempotent_replay: true umjesto da ponovno bira broj.
• Dva ThunderPhone čvora koja primaju isti zapis šalju različite ključeve.
• Prazna vrijednost ne uspijeva prije slanja bilo kakvog zahtjeva.

Izbjegavajte vremenske oznake, nasumične vrijednosti te ID-jeve izvršavanja ili tijeka rada n8n. Nova vrijednost pri ponovnom pokušaju upućuje drugi stvarni poziv. Cijeli ključ može imati najviše 128 znakova. Ponovna upotreba ključa s drugim agentom, brojem ili varijablama ne uspijeva zbog sukoba.

Kampanje. Dodavanje kontakata (resurs Kampanja) dodaje kontakte u nacrt kampanje. Prima ID kampanje i JSON polje kontakata. Svaki kontakt treba phone_number; ostali ključevi postaju varijable poziva. Čvor ne uspijeva kada je svaki kontakt odbijen i postavlja partial_success: true kada su odbijeni samo neki. Pokretanje zahtijeva potvrdni okvir koji potvrđuje da kampanja upućuje stvarne pozive i troši ThunderPhone kredite. Pogledajte Odlazne kampanje.

Prije nego što tijek rada počne upućivati pozive:

• Ako ThunderPhone zatraži od vaše organizacije da potvrdi da njezini odlazni pozivi slijede TCPA i druge zakone o pozivima, administrator prvo mora zabilježiti tu potvrdu u nadzornoj ploči.
• Broj s kojeg se upućuje poziv mora biti omogućen za odlazne pozive. Brojevi koje prenesete od vlastitog operatera ispunjavaju uvjete nakon provjere. ThunderPhone brojevi u početku su samo za dolazne pozive i mogu biti odobreni za odlaznu upotrebu: administrator to zatraži na stranici Telefonski brojevi. Pogledajte Dobivanje telefonskog broja.
• Vaša organizacija odgovorna je za pribavljanje pristanka za pozivanje svakog broja i za poštovanje primjenjivih zakona o pozivima. Pogledajte Zakoni o odlaznim pozivima.

Primjeri tijekova rada#

• CRM kontakti u kampanju. Dodajte CRM kontakte u nacrt ThunderPhone kampanje, a zatim pokrenite kampanju kada netko odobri popis.
• Dovršeni poziv u zapis klijenta. Pri dovršetku poziva pokrenite Dohvati poziv i spremite prijepis i poveznicu na snimku u odgovarajući zapis klijenta.
• Niske ocjene na pregled. Pri ocjenjivanju poziva filtrirajte prema {{ $json.data.grade.score }} i usmjerite pozive s niskim ocjenama u red za pregled s ID-jem poziva i pojedinostima ocjene. Poziv se može ocijeniti više puta, a svako dovršeno ocjenjivanje aktivira okidač, stoga zadržite samo najnoviji graded_at za svaki ID poziva.

Prijepisi poziva, sažeci i snimke mogu sadržavati osobne ili zdravstvene podatke. Šaljite ih samo aplikacijama koje vaša organizacija smije koristiti za te podatke, uz BAA kada su uključeni zdravstveni podaci, i zadržite samo polja koja su vam potrebna.