n8n સાથે ThunderPhone વાપરો

n8n માટે ThunderPhone નોડ ઇન્સ્ટોલ કરો, સર્વર API કી કનેક્ટ કરો અને દરેક કૉલ સમાપ્ત થાય ત્યારે ચાલે એવો વર્કફ્લો બનાવો.

n8n એક વર્કફ્લો ઑટોમેશન ટૂલ છે. n8n માટેનું ThunderPhone પેકેજ બે નોડ ઉમેરે છે:

• ThunderPhone ટ્રિગર કૉલ સમાપ્ત થાય ત્યારે (કૉલ પૂર્ણ) અથવા કૉલ ગ્રેડિંગ રન પૂર્ણ થાય ત્યારે (કૉલ ગ્રેડેડ) વર્કફ્લો શરૂ કરે છે.
• ThunderPhone આઉટબાઉન્ડ કૉલ કરે છે, સંપર્કોને કેમ્પેઇનમાં ઉમેરે છે અને તેને શરૂ કરે છે, ટ્રાન્સક્રિપ્ટ અને રેકોર્ડિંગ સાથે કૉલ મેળવે છે, અને તમારા એજન્ટ્સ તથા ફોન નંબરોની સૂચિ આપે છે.

તે ચકાસાયેલ કમ્યુનિટી નોડ છે, જે n8n પર ThunderPhone પર સૂચિબદ્ધ છે.

નોડ ઇન્સ્ટૉલ કરો#

n8n એડિટરમાં, નોડ્સ પેનલ ખોલવા માટે + પર ક્લિક કરો અને ThunderPhone શોધો. અન્ય વપરાશકર્તાઓ તેને ઉમેરી શકે તે પહેલાં ઇન્સ્ટન્સના માલિકે ચકાસાયેલા નોડ્સ સેટ અપ કરવાની જરૂર પડી શકે છે.

સેલ્ફ-હોસ્ટેડ n8n પર, તમે પેકેજના નામથી પણ ઇન્સ્ટૉલ કરી શકો છો: Settings > Community Nodes ખોલો અને n8n-nodes-thunderphone ઇન્સ્ટૉલ કરો. ઇન્સ્ટૉલ કરતા પહેલાં કમ્યુનિટી-નોડના જોખમો અને તમારી ઇન્સ્ટન્સ નીતિ તપાસો.

સર્વર API કી બનાવો#

1. Keys ટૅબ ખોલો

   ThunderPhone માં, Organization → Keys પર જાઓ અને Create key પર ક્લિક કરો.

2. તેને નામ આપો

   કી ક્યાં રાખેલી છે તે દર્શાવતું નામ વાપરો, જેમ કે "n8n".

3. હમણાં જ કૉપી કરો

   સંપૂર્ણ sk_live_... સિક્રેટ એક જ વાર દેખાય છે. ડાયલૉગ બંધ કરો તે પહેલાં તેને કૉપી કરો.

ફક્ત એડમિન અથવા માલિક જ કી બનાવી શકે છે, અને ThunderPhone તેની સાથે કરવામાં આવેલી વિનંતીઓને તે વ્યક્તિ તરફથી આવેલી માને છે. ટ્રિગર અને કેમ્પેઇન ઑપરેશન્સ માટે તે વ્યક્તિએ એડમિન અથવા માલિકની ભૂમિકા જાળવી રાખવી જરૂરી છે. સર્વર API કી બનાવો માં રોટેશન અને રદબાતલ વિશે માહિતી છે.

n8n માં ક્રેડેન્શિયલ ઉમેરો#

1. n8n માં, ThunderPhone API પ્રકારનું ક્રેડેન્શિયલ બનાવો.
2. કીને API Key માં પેસ્ટ કરો.
3. તેને સેવ કરો અને ક્રેડેન્શિયલ ટેસ્ટ ચલાવો. ટેસ્ટ તમારી સંસ્થામાંથી એક કૉલ GET /v1/calls?limit=1 વડે વાંચે છે.

પ્રથમ વર્કફ્લો બનાવો#

દરેક વખત કૉલ પૂર્ણ થાય ત્યારે આ વર્કફ્લો Google Sheets માં એક પંક્તિ ઉમેરે છે.

1. ટ્રિગર ઉમેરો

   ThunderPhone Trigger ઉમેરો, તમારી ThunderPhone API ઓળખપત્ર પસંદ કરો અને ઇવેન્ટ ને કૉલ પૂર્ણ થયું પર સેટ કરો.

2. કૉલ મેળવો

   ThunderPhone નોડ ઉમેરો. રિસોર્સ ને કૉલ, ઓપરેશન ને મેળવો, અને કૉલ ID ને {{ $json.data.call_id }} એક્સપ્રેશન પર સેટ કરો. આઉટપુટમાં કૉલ રેકોર્ડ ઉપરાંત transcripts અને recording_url મળે છે, જે ટૂંકા સમય માટે માન્ય લિંક છે અને કૉલમાં રેકોર્ડિંગ ન હોય ત્યારે null હોય છે.

3. પંક્તિ ઉમેરો

   પંક્તિ ઉમેરતો Google Sheets નોડ ઉમેરો અને તમને જોઈતા કૉલમને Get Call આઉટપુટમાંથી મેપ કરો (નીચેનું ટેબલ જુઓ).

4. વર્કફ્લો સક્રિય કરો

   સાચવો અને સક્રિય કરો. ટ્રિગર તેની પ્રોડક્શન URL ને તમારી ThunderPhone સંસ્થામાં વેબહૂક એન્ડપોઇન્ટ તરીકે નોંધે છે. વર્કફ્લો નિષ્ક્રિય કરવાથી તે એન્ડપોઇન્ટ કાઢી નાખવામાં આવે છે.

5. તેનું પરીક્ષણ કરો

   બિલ્ડરમાં એજન્ટ ખોલો, વાત કરો પર ક્લિક કરો અને કૉલ સમાપ્ત કરો. બિલ્ડર પરીક્ષણ કૉલ web.complete તરીકે મોકલવામાં આવે છે, જે કૉલ પૂર્ણ થયા પાછળની બે ઇવેન્ટમાંથી એક છે, તેથી વર્કફ્લો ચાલે છે અને એક પંક્તિ દેખાય છે.

ઉપયોગી કૉલમ:

કૉલ લિંક તમારી સંસ્થાના સભ્યો માટે ThunderPhone ડૅશબોર્ડમાં કૉલને તેના ટ્રાન્સક્રિપ્ટ અને રેકોર્ડિંગ સાથે ખોલે છે, તેથી શીટમાં તેમાંથી કોઈપણ રાખવાની જરૂર નથી.

છતાં ટ્રાન્સક્રિપ્ટ ઉમેરવા માટે, {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }} મેપ કરો. રેકોર્ડિંગ URL ની સમયમર્યાદા સમાપ્ત થાય છે, તેથી કૉલ ID સંગ્રહો અને નવી લિંકની જરૂર પડે ત્યારે Get Call ફરી ચલાવો. કૉલ ટ્રાન્સક્રિપ્ટ, સારાંશો અને રેકોર્ડિંગમાં વ્યક્તિગત અથવા આરોગ્ય સંબંધિત માહિતી હોઈ શકે છે. તે ફક્ત એવી એપ્સને મોકલો જેનો ઉપયોગ તમારી સંસ્થાને તે ડેટા માટે કરવાની મંજૂરી હોય, આરોગ્ય માહિતી સામેલ હોય ત્યારે BAA હેઠળ, અને તમને જરૂરી હોય તેવા ફીલ્ડ્સ જ રાખો.

ટ્રિગર સંપૂર્ણ ઇવેન્ટ આઉટપુટ કરે છે: type, event_id અને data. દરેક ફીલ્ડ માટે telephony.complete / web.complete અને call.graded જુઓ. ડિલિવરી ઓછામાં ઓછી એક વખત થાય છે, અને એક ઇવેન્ટના ફરી પ્રયાસોમાં event_id એકસરખું રહે છે, તેથી પુનરાવર્તિત ન થવો જોઈએ તેવા પગલા પહેલાં તેને તપાસો.

આઉટબાઉન્ડ કૉલ સુરક્ષિત રીતે કરો#

આઉટબાઉન્ડ કૉલ કરો (રિસોર્સ આઉટબાઉન્ડ કૉલ, ઓપરેશન કરો) આ લે છે:

આઇડેમ્પોટન્સી કીને રન શરૂ કરનાર વસ્તુની ID સાથે મેપ કરો, જેમ કે CRM રેકોર્ડ ID અથવા ટ્રિગરનું event_id. નોડ n8n:<node ID>:<your value> મોકલે છે, તેથી:

• સ્વચાલિત રીટ્રાય અથવા એક્ઝિક્યુશન ફરી પ્રયાસ કરો એ જ કી મોકલે છે, અને ThunderPhone ફરી ડાયલ કરવાને બદલે idempotent_replay: true સાથે મૂળ કૉલ પરત કરે છે.
• એક જ રેકોર્ડથી ફીડ થતા બે ThunderPhone નોડ્સ અલગ કીઓ મોકલે છે.
• ખાલી મૂલ્ય કોઈપણ વિનંતી મોકલાય તે પહેલાં નિષ્ફળ જાય છે.

ટાઇમસ્ટેમ્પ, રેન્ડમ મૂલ્યો અને n8n એક્ઝિક્યુશન અથવા વર્કફ્લો ID ટાળો. રીટ્રાય વખતે નવું મૂલ્ય બીજી વાસ્તવિક કૉલ કરે છે. સમગ્ર કી મહત્તમ 128 અક્ષરોની હોઈ શકે છે. અલગ એજન્ટ, નંબર અથવા વેરિએબલ્સ સાથે કીનો ફરી ઉપયોગ કરવાથી કૉન્ફ્લિક્ટ સાથે નિષ્ફળતા થાય છે.

કેમ્પેઇન્સ. કોન્ટેક્ટ્સ ઉમેરો (રિસોર્સ કેમ્પેઇન) ડ્રાફ્ટ કેમ્પેઇનમાં કોન્ટેક્ટ્સ ઉમેરે છે. તે કેમ્પેઇન ID અને કોન્ટેક્ટ્સનો JSON એરે લે છે. દરેક કોન્ટેક્ટ માટે phone_number જરૂરી છે; અન્ય કીઓ કૉલ વેરિએબલ્સ બને છે. જ્યારે દરેક કોન્ટેક્ટ નકારવામાં આવે ત્યારે નોડ નિષ્ફળ જાય છે અને માત્ર કેટલાક નકારાય ત્યારે partial_success: true સેટ કરે છે. શરૂ કરો માટે કેમ્પેઇન વાસ્તવિક કૉલ કરે છે અને ThunderPhone ક્રેડિટ્સ ખર્ચે છે તેની પુષ્ટિ કરતો ચેકબૉક્સ જરૂરી છે. આઉટબાઉન્ડ કેમ્પેઇન્સ જુઓ.

વર્કફ્લો કૉલ શરૂ કરે તે પહેલાં:

• જો ThunderPhone તમારી સંસ્થાને તેના આઉટબાઉન્ડ કૉલ TCPA અને અન્ય કૉલિંગ કાયદાઓનું પાલન કરે છે તેની પુષ્ટિ કરવા કહે, તો એડમિને પહેલા ડેશબોર્ડમાં તે પુષ્ટિ નોંધવી આવશ્યક છે.
• પ્રેષક નંબર આઉટબાઉન્ડ કૉલ માટે સક્ષમ હોવો આવશ્યક છે. તમે તમારા પોતાના કેરિયર પાસેથી લાવતા નંબરો વેરિફાઇ થયા પછી પાત્ર બને છે. ThunderPhone નંબરો શરૂઆતમાં માત્ર ઇનબાઉન્ડ હોય છે અને આઉટબાઉન્ડ ઉપયોગ માટે મંજૂર થઈ શકે છે: એડમિન ફોન નંબર્સ પેજ પરથી તેની વિનંતી કરે છે. જુઓ ફોન નંબર મેળવો.
• તમારી સંસ્થા પાસે દરેક નંબર પર કૉલ કરવા માટે સંમતિ હોવી અને લાગુ પડતા કૉલિંગ કાયદાઓનું પાલન કરવું તેની જવાબદારી તમારી છે. જુઓ આઉટબાઉન્ડ કૉલિંગ કાયદાઓ.

ઉદાહરણ વર્કફ્લોઝ#

• CRM કોન્ટેક્ટ્સને કેમ્પેઇનમાં ઉમેરો. CRM કોન્ટેક્ટ્સને ડ્રાફ્ટ ThunderPhone કેમ્પેઇનમાં ઉમેરો, પછી કોઈ વ્યક્તિ સૂચિને મંજૂરી આપે ત્યારે કેમ્પેઇન શરૂ કરો.
• પૂર્ણ થયેલ કૉલને ગ્રાહક રેકોર્ડમાં ઉમેરો. કૉલ પૂર્ણ થાય ત્યારે, કૉલ મેળવો ચલાવો અને ટ્રાન્સક્રિપ્ટ તથા રેકોર્ડિંગ લિંકને મેળ ખાતા ગ્રાહક રેકોર્ડમાં સાચવો.
• ઓછા ગ્રેડ્સને સમીક્ષા માટે મોકલો. કૉલ ગ્રેડ થાય ત્યારે, {{ $json.data.grade.score }} પર ફિલ્ટર કરો અને ઓછા સ્કોરવાળા કૉલ્સને કૉલ ID અને ગ્રેડ વિગતો સાથે સમીક્ષા ક્યૂમાં મોકલો. કૉલને એકથી વધુ વાર ગ્રેડ કરી શકાય છે, અને દરેક પૂર્ણ થયેલ ગ્રેડિંગ રન ટ્રિગર ચલાવે છે, તેથી દરેક કૉલ ID માટે માત્ર નવીનતમ graded_at રાખો.

કૉલ ટ્રાન્સક્રિપ્ટ્સ, સારાંશો અને રેકોર્ડિંગ્સમાં વ્યક્તિગત અથવા આરોગ્ય સંબંધિત માહિતી હોઈ શકે છે. તે ફક્ત એવી એપ્સને મોકલો જેનો તમારી સંસ્થાને આ ડેટા માટે ઉપયોગ કરવાની મંજૂરી હોય, આરોગ્ય માહિતી સામેલ હોય ત્યાં BAA હેઠળ, અને ફક્ત જરૂરી ફીલ્ડ્સ જ રાખો.