Naudokite ThunderPhone su n8n

Įdiekite ThunderPhone mazgą, skirtą n8n, prijunkite serverio API raktą ir sukurkite darbo eigą, kuri vykdoma kiekvieną kartą pasibaigus skambučiui.

n8n yra darbo eigų automatizavimo įrankis. „ThunderPhone“ paketas, skirtas n8n, prideda du mazgus:

• ThunderPhone Trigger paleidžia darbo eigą, kai baigiasi skambutis (Skambutis baigtas) arba užbaigiamas skambučio vertinimas (Skambutis įvertintas).
• ThunderPhone inicijuoja išeinančius skambučius, prideda kontaktus prie kampanijų ir jas paleidžia, gauna skambučius su jų transkriptais ir įrašais bei pateikia jūsų agentų ir telefono numerių sąrašą.

Tai patvirtintas bendruomenės mazgas, pateikiamas ThunderPhone sistemoje n8n.

Įdiekite mazgą#

n8n redaktoriuje spustelėkite +, kad atidarytumėte mazgų skydelį, ir ieškokite ThunderPhone. Prieš kitiems naudotojams pridedant mazgus, egzemplioriaus savininkui gali reikėti nustatyti patvirtintus mazgus.

Savo serveryje diegiamoje n8n versijoje taip pat galite įdiegti pagal paketo pavadinimą: atidarykite Nustatymai > Bendruomenės mazgai ir įdiekite n8n-nodes-thunderphone. Prieš diegdami patikrinkite bendruomenės mazgų rizikas ir savo egzemplioriaus politiką.

Sukurkite serverio API raktą#

1. Atidarykite skirtuką „Raktai“

   ThunderPhone sistemoje eikite į Organizacija → Raktai ir spustelėkite Sukurti raktą.

2. Suteikite jam pavadinimą

   Naudokite pavadinimą, nurodantį, kur raktas naudojamas, pavyzdžiui, „n8n“.

3. Nukopijuokite jį dabar

   Visas sk_live_... slaptasis raktas rodomas vieną kartą. Nukopijuokite jį prieš uždarydami dialogo langą.

Raktą gali sukurti tik administratorius arba savininkas, o ThunderPhone užklausas, pateiktas naudojant šį raktą, laiko pateiktomis to asmens vardu. Trigeriui ir kampanijų operacijoms reikia, kad tas asmuo išlaikytų administratoriaus arba savininko vaidmenį. Puslapyje „Sukurkite serverio API raktą“ aprašomas raktų keitimas ir atšaukimas.

Pridėkite prisijungimo duomenis n8n#

1. n8n sukurkite ThunderPhone API tipo prisijungimo duomenis.
2. Įklijuokite raktą į API raktas.
3. Išsaugokite juos ir paleiskite prisijungimo duomenų testą. Testas nuskaito vieną jūsų organizacijos skambutį naudodamas GET /v1/calls?limit=1.

Sukurkite pirmą darbo eigą#

Ši darbo eiga prideda eilutę į „Google Sheets“ kaskart, kai baigiasi skambutis.

1. Pridėkite trigerį

   Pridėkite ThunderPhone Trigger, pasirinkite savo „ThunderPhone“ API kredencialus ir nustatykite Įvykis reikšmę į Skambutis baigtas.

2. Gaukite skambutį

   Pridėkite ThunderPhone mazgą. Nustatykite Išteklius į Skambutis, Operacija į Gauti, o Skambučio ID į išraišką {{ $json.data.call_id }}. Išvestį sudaro skambučio įrašas, taip pat transcripts ir recording_url – trumpalaikė nuoroda, kurios reikšmė yra null, kai skambutis neturi įrašo.

3. Pridėkite eilutę

   Pridėkite „Google Sheets“ mazgą, kuris prideda eilutę, ir susiekite norimus stulpelius iš „Get Call“ išvesties (žr. toliau pateiktą lentelę).

4. Aktyvinkite darbo eigą

   Išsaugokite ir aktyvinkite. Trigeris užregistruoja savo gamybinį URL kaip žiniatinklio kabliuko galinį tašką jūsų „ThunderPhone“ organizacijoje. Išaktyvinus darbo eigą, tas galinis taškas ištrinamas.

5. Išbandykite

   Atidarykite agentą kūrimo priemonėje, spustelėkite Kalbėti ir užbaikite skambutį. Kūrimo priemonės bandomieji skambučiai pateikiami kaip web.complete, vienas iš dviejų įvykių, susijusių su skambučio užbaigimu, todėl darbo eiga vykdoma ir atsiranda eilutė.

Naudingi stulpeliai:

Skambučio nuoroda organizacijos nariams atidaro skambutį „ThunderPhone“ valdymo skydelyje kartu su jo transkriptu ir įrašu, todėl skaičiuoklėje nereikia saugoti nė vieno iš jų.

Jei vis tiek norite pridėti transkriptą, susiekite {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. Įrašo URL galiojimas baigiasi, todėl saugokite skambučio ID ir paleiskite „Get Call“ dar kartą, kai reikia naujos nuorodos. Skambučių transkriptuose, santraukose ir įrašuose gali būti asmens arba sveikatos informacijos. Siųskite juos tik į programas, kurias jūsų organizacijai leidžiama naudoti tokiems duomenims, pagal BAA, kai naudojama sveikatos informacija, ir saugokite tik reikalingus laukus.

Trigerio išvestį sudaro visas įvykis: type, event_id ir data. Visus laukus žr. telephony.complete / web.complete ir call.graded. Pristatymas vykdomas mažiausiai vieną kartą, o event_id nesikeičia pakartotinai bandant pristatyti vieną įvykį, todėl patikrinkite jį prieš veiksmą, kuris neturi būti kartojamas.

Saugiai vykdykite išeinančius skambučius#

Vykdyti išeinantį skambutį (išteklius Išeinantis skambutis, operacija Vykdyti) priima:

Susiekite idempotentiškumo raktą su ID iš to, kas sukėlė vykdymą, pvz., CRM įrašo ID arba aktyviklio event_id. Mazgas siunčia n8n:<node ID>:<your value>, todėl:

• Automatinis pakartotinis bandymas arba Pakartoti vykdymą siunčia tą patį raktą, o ThunderPhone grąžina pradinį skambutį su idempotent_replay: true, užuot skambinęs dar kartą.
• Du ThunderPhone mazgai, gaunantys tą patį įrašą, siunčia skirtingus raktus.
• Tuščia reikšmė nepavyksta dar prieš išsiunčiant užklausą.

Venkite laiko žymų, atsitiktinių reikšmių ir n8n vykdymo ar darbo eigos ID. Nauja reikšmė pakartotinio bandymo metu vykdo antrą tikrą skambutį. Visas raktas gali turėti ne daugiau kaip 128 simbolius. Pakartotinai naudojant raktą su kitu agentu, numeriu ar kintamaisiais, gaunamas konfliktas.

Kampanijos. Pridėti kontaktus (išteklius Kampanija) prideda kontaktus į juodraštinę kampaniją. Tam reikia kampanijos ID ir JSON kontaktų masyvo. Kiekvienam kontaktui reikia phone_number; kiti raktai tampa skambučio kintamaisiais. Mazgui nepavyksta, kai atmetami visi kontaktai, ir nustatoma partial_success: true, kai atmetama tik dalis jų. Pradėti reikia pažymėti žymimąjį langelį, patvirtinantį, kad kampanija vykdo tikrus skambučius ir naudoja ThunderPhone kreditus. Žr. Išeinančios kampanijos.

Prieš darbo eigai pradedant skambučius:

• Jei ThunderPhone prašo jūsų organizacijos patvirtinti, kad jos išeinantys skambučiai atitinka TCPA ir kitus skambučių įstatymus, administratorius pirmiausia turi užregistruoti šį patvirtinimą valdymo skydelyje.
• Numeris, iš kurio skambinama, turi būti įgalintas išeinantiems skambučiams. Numeriai, kuriuos perkeli ate iš savo operatoriaus, tinkami juos patvirtinus. ThunderPhone numeriai iš pradžių skirti tik įeinantiems skambučiams ir gali būti patvirtinti išeinančiam naudojimui: administratorius to paprašo puslapyje Telefono numeriai. Žr. Gaukite telefono numerį.
• Jūsų organizacija atsako už sutikimo skambinti kiekvienu numeriu gavimą ir taikomų skambučių įstatymų laikymąsi. Žr. Išeinančių skambučių įstatymai.

Darbo eigų pavyzdžiai#

• CRM kontaktai į kampaniją. Pridėkite CRM kontaktus į juodraštinę ThunderPhone kampaniją, tada pradėkite kampaniją, kai kas nors patvirtina sąrašą.
• Užbaigtas skambutis į kliento įrašą. Įvykus Call Completed, vykdykite Get Call ir išsaugokite nuorašą bei įrašo nuorodą atitinkamame kliento įraše.
• Žemi įvertinimai peržiūrai. Įvykus Call Graded, filtruokite pagal {{ $json.data.grade.score }} ir nukreipkite žemai įvertintus skambučius į peržiūros eilę su skambučio ID ir įvertinimo informacija. Skambutis gali būti įvertintas daugiau nei vieną kartą, o kiekvienas baigtas vertinimo vykdymas suaktyvina aktyviklį, todėl kiekvienam skambučio ID saugokite tik naujausią graded_at.

Skambučių nuorašuose, suvestinėse ir įrašuose gali būti asmens ar sveikatos informacijos. Siųskite juos tik į programas, kurias jūsų organizacijai leidžiama naudoti tokiems duomenims, pagal BAA, kai tvarkoma sveikatos informacija, ir saugokite tik jums reikalingus laukus.