Open in
n8nతో ThunderPhone ఉపయోగించండి
n8n కోసం ThunderPhone నోడ్‌ను ఇన్‌స్టాల్ చేసి, సర్వర్ API కీని కనెక్ట్ చేసి, ప్రతి కాల్ ముగిసినప్పుడు అమలయ్యే వర్క్‌ఫ్లోను రూపొందించండి.
n8n అనేది వర్క్‌ఫ్లో ఆటోమేషన్ సాధనం. n8n కోసం ThunderPhone ప్యాకేజ్ రెండు నోడ్లను జోడిస్తుంది:
- ThunderPhone ట్రిగ్గర్ కాల్ ముగిసినప్పుడు (కాల్ పూర్తయింది) లేదా కాల్ గ్రేడింగ్ రన్ పూర్తయినప్పుడు (కాల్ గ్రేడ్ చేయబడింది) వర్క్‌ఫ్లోను ప్రారంభిస్తుంది.
- ThunderPhone అవుట్‌బౌండ్ కాల్‌లను చేస్తుంది, క్యాంపెయిన్‌లకు కాంటాక్ట్‌లను జోడించి వాటిని ప్రారంభిస్తుంది, ట్రాన్స్‌క్రిప్ట్ మరియు రికార్డింగ్‌తో కాల్‌లను పొందుతుంది, అలాగే మీ ఏజెంట్లు మరియు ఫోన్ నంబర్‌లను జాబితా చేస్తుంది.
ఇది ధృవీకరించబడిన కమ్యూనిటీ నోడ్, దీనిని n8nలోని ThunderPhone వద్ద జాబితా చేశారు.
నోడ్‌ను ఇన్‌స్టాల్ చేయండి
n8n ఎడిటర్‌లో, నోడ్ల ప్యానెల్ తెరవడానికి + క్లిక్ చేసి ThunderPhone కోసం వెతకండి. ఇతర వినియోగదారులు వాటిని జోడించడానికి ముందు ఇన్‌స్టాన్స్ ఓనర్ ధృవీకరించబడిన నోడ్లను సెటప్ చేయాల్సి రావచ్చు.
సెల్ఫ్-హోస్టెడ్ n8nలో, మీరు ప్యాకేజ్ పేరుతో కూడా ఇన్‌స్టాల్ చేయవచ్చు:
సెట్టింగ్‌లు > కమ్యూనిటీ నోడ్లు తెరిచి n8n-nodes-thunderphoneను ఇన్‌స్టాల్ చేయండి. ఇన్‌స్టాల్ చేసే ముందు
కమ్యూనిటీ-నోడ్ ప్రమాదాలు మరియు మీ ఇన్‌స్టాన్స్ విధానాన్ని పరిశీలించండి.
సర్వర్ API కీని సృష్టించండి
- కీస్ ట్యాబ్‌ను తెరవండి
ThunderPhoneలో, ఆర్గనైజేషన్ → కీస్కు వెళ్లి కీని సృష్టించండి క్లిక్ చేయండి.
- దీనికి పేరు ఇవ్వండి
కీ ఎక్కడ ఉందో తెలిపే పేరును ఉపయోగించండి, ఉదాహరణకు "n8n".
- ఇప్పుడే కాపీ చేయండి
పూర్తి
sk_live_...రహస్యం ఒకసారి మాత్రమే చూపబడుతుంది. డైలాగ్‌ను మూసే ముందు దాన్ని కాపీ చేయండి.
అడ్మిన్ లేదా ఓనర్ మాత్రమే కీని సృష్టించగలరు, మరియు ThunderPhone దానితో చేసిన అభ్యర్థనలను ఆ వ్యక్తి చేసినవిగానే పరిగణిస్తుంది. ట్రిగ్గర్ మరియు క్యాంపెయిన్ ఆపరేషన్‌ల కోసం ఆ వ్యక్తి అడ్మిన్ లేదా ఓనర్ పాత్రను కొనసాగించాలి. సర్వర్ API కీని సృష్టించండి రొటేషన్ మరియు రద్దును వివరిస్తుంది.
n8nలో క్రెడెన్షియల్‌ను జోడించండి
- n8nలో, ThunderPhone API రకానికి చెందిన క్రెడెన్షియల్‌ను సృష్టించండి.
- కీని API కీలో అతికించండి.
- దాన్ని సేవ్ చేసి క్రెడెన్షియల్ పరీక్షను అమలు చేయండి. ఈ పరీక్ష మీ
ఆర్గనైజేషన్ నుండి
GET /v1/calls?limit=1తో ఒక కాల్‌ను చదువుతుంది.
మీ మొదటి వర్క్‌ఫ్లోను నిర్మించండి
ప్రతి కాల్ ముగిసినప్పుడు ఈ వర్క్‌ఫ్లో Google Sheetకు ఒక వరుసను జోడిస్తుంది.
- ట్రిగ్గర్ను జోడించండి
ThunderPhone ట్రిగ్గర్ను జోడించి, మీ ThunderPhone API క్రెడెన్షియల్‌ను ఎంచుకుని, ఈవెంట్ను కాల్ పూర్తయిందిగా సెట్ చేయండి.
- కాల్‌ను పొందండి
ఒక ThunderPhone నోడ్‌ను జోడించండి. రిసోర్స్ను కాల్గా, ఆపరేషన్ను పొందండిగా సెట్ చేసి, కాల్ IDని
{{ $json.data.call_id }}ఎక్స్‌ప్రెషన్‌గా సెట్ చేయండి. అవుట్‌పుట్‌లో కాల్ రికార్డ్తో పాటుtranscriptsమరియుrecording_urlఉంటాయి; ఇది స్వల్పకాలం మాత్రమే చెల్లుబాటయ్యే లింక్, కాల్‌కు రికార్డింగ్ లేకపోతే ఇదిnullగా ఉంటుంది. - వరుసను జోడించండి
ఒక వరుసను జోడించే Google Sheets నోడ్‌ను చేర్చి, మీకు కావలసిన కాలమ్‌లను Get Call అవుట్‌పుట్ నుండి మ్యాప్ చేయండి (క్రింది పట్టికను చూడండి).
- వర్క్‌ఫ్లోను యాక్టివేట్ చేయండి
సేవ్ చేసి యాక్టివేట్ చేయండి. ట్రిగ్గర్ దాని ప్రొడక్షన్ URLను మీ ThunderPhone సంస్థలో వెబ్‌హుక్ ఎండ్‌పాయింట్‌గా నమోదు చేస్తుంది. వర్క్‌ఫ్లోను డీయాక్టివేట్ చేస్తే ఆ ఎండ్‌పాయింట్ తొలగించబడుతుంది.
- దీన్ని పరీక్షించండి
బిల్డర్‌లో ఒక ఏజెంట్‌ను తెరిచి, మాట్లాడండి క్లిక్ చేసి, కాల్‌ను ముగించండి. బిల్డర్ టెస్ట్ కాల్‌లు
web.completeగా డెలివర్ అవుతాయి, ఇది Call Completed వెనుక ఉన్న రెండు ఈవెంట్‌లలో ఒకటి; కాబట్టి వర్క్‌ఫ్లో నడుస్తుంది మరియు ఒక వరుస కనిపిస్తుంది.
ఉపయోగకరమైన కాలమ్‌లు:
| కాలమ్ | ఎక్స్‌ప్రెషన్ |
|---|---|
| కాల్ ID | {{ $json.call_id }} |
| దిశ | {{ $json.direction }} |
| నుండి | {{ $json.from_number }} |
| కు | {{ $json.to_number }} |
| ప్రారంభమైన సమయం | {{ $json.start_time }} |
| వ్యవధి (సె) | {{ $json.duration_seconds }} |
| స్థితి | {{ $json.status }} |
| ముగింపు కారణం | {{ $json.end_reason }} |
| కాల్ లింక్ | https://app.thunderphone.com/dashboard/call-history/{{ $json.call_id }} |
కాల్ లింక్ మీ సంస్థ సభ్యుల కోసం 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 | సేవ్ చేసిన ఏజెంట్. డ్రాప్‌డౌన్ మీ ఏజెంట్‌లను చూపుతుంది. |
| ఫోన్ నంబర్ పేరు లేదా ID | పంపే నంబర్. డ్రాప్‌డౌన్ అవుట్‌బౌండ్ కాల్‌లకు ఎనేబుల్ చేసిన నంబర్‌లను మాత్రమే చూపుతుంది. |
| గమ్య నంబర్ | E.164 ఫార్మాట్‌లో గమ్య నంబర్, ఉదా. +14155552671. |
| వేరియబుల్స్ | ఏజెంట్ prompt లోని ప్లేస్‌హోల్డర్‌ల కోసం విలువల JSON ఆబ్జెక్ట్. |
| ఇడెంపోటెన్సీ కీ | అప్‌స్ట్రీమ్ రికార్డ్ లేదా ఈవెంట్ నుండి స్థిరమైన ID. అవసరం. |
ఇడెంపోటెన్సీ కీని CRM రికార్డ్ ID లేదా ట్రిగ్గర్ యొక్క event_id వంటి రన్‌కు కారణమైన దాని నుండి వచ్చిన IDకి మ్యాప్ చేయండి. నోడ్
n8n:<node ID>:<your value>ను పంపుతుంది, కాబట్టి:
- ఆటోమేటిక్ రీట్రై లేదా ఎగ్జిక్యూషన్‌ను మళ్లీ ప్రయత్నించండి అదే కీని పంపుతుంది, మరియు
మళ్లీ డయల్ చేయడానికి బదులుగా ThunderPhone
idempotent_replay: trueతో అసలు కాల్‌ను తిరిగి ఇస్తుంది. - ఒకే రికార్డ్తో ఫీడ్ చేయబడిన రెండు ThunderPhone నోడ్లు వేర్వేరు కీలను పంపుతాయి.
- ఖాళీ విలువ ఏ అభ్యర్థన పంపకముందే విఫలమవుతుంది.
టైమ్‌స్టాంప్‌లు, యాదృచ్ఛిక విలువలు, మరియు n8n ఎగ్జిక్యూషన్ లేదా వర్క్‌ఫ్లో IDలను నివారించండి. రీట్రైలో కొత్త విలువ రెండవ నిజమైన కాల్‌ను చేస్తుంది. మొత్తం కీ గరిష్ఠంగా 128 అక్షరాలు ఉండవచ్చు. వేరే ఏజెంట్, నంబర్ లేదా వేరియబుల్స్‌తో కీని మళ్లీ ఉపయోగిస్తే కాన్ఫ్లిక్ట్‌తో విఫలమవుతుంది.
క్యాంపెయిన్‌లు. కాంటాక్ట్‌లను జోడించండి (వనరు క్యాంపెయిన్) డ్రాఫ్ట్ క్యాంపెయిన్‌కు కాంటాక్ట్‌లను జోడిస్తుంది. దీనికి క్యాంపెయిన్ ID మరియు కాంటాక్ట్‌ల JSON అరే అవసరం. ప్రతి కాంటాక్ట్‌కు phone_number అవసరం; ఇతర కీలు
కాల్ వేరియబుల్స్‌గా మారతాయి. ప్రతి కాంటాక్ట్ తిరస్కరించబడినప్పుడు నోడ్ విఫలమవుతుంది మరియు
కొన్ని మాత్రమే తిరస్కరించబడినప్పుడు partial_success: trueను సెట్ చేస్తుంది. ప్రారంభించండికు క్యాంపెయిన్ నిజమైన కాల్‌లను చేస్తుందని మరియు ThunderPhone
క్రెడిట్‌లను ఖర్చు చేస్తుందని నిర్ధారించే చెక్‌బాక్స్ అవసరం. అవుట్‌బౌండ్ క్యాంపెయిన్‌లు చూడండి.
వర్క్‌ఫ్లో కాల్‌లను ప్రారంభించే ముందు:
- మీ సంస్థ అవుట్‌బౌండ్ కాల్‌లు TCPA మరియు ఇతర కాలింగ్ చట్టాలను అనుసరిస్తాయని ThunderPhone నిర్ధారించమని అడిగితే, ఒక అడ్మిన్ ముందుగా డ్యాష్‌బోర్డ్‌లో ఆ నిర్ధారణను నమోదు చేయాలి.
- పంపే నంబర్ అవుట్‌బౌండ్ కాల్‌లకు ఎనేబుల్ చేయబడి ఉండాలి. మీరు మీ స్వంత క్యారియర్ నుండి తీసుకొచ్చే నంబర్‌లు ధృవీకరించబడిన తర్వాత అర్హత పొందుతాయి. ThunderPhone నంబర్‌లు మొదట ఇన్‌బౌండ్-మాత్రమే ఉంటాయి మరియు అవుట్‌బౌండ్ ఉపయోగం కోసం ఆమోదించబడవచ్చు: ఒక అడ్మిన్ ఫోన్ నంబర్‌ల పేజీ నుండి దానిని అభ్యర్థిస్తారు. చూడండి ఫోన్ నంబర్ పొందండి.
- ప్రతి నంబర్‌కు కాల్ చేయడానికి సమ్మతి కలిగి ఉండటం మరియు వర్తించే కాలింగ్ చట్టాలను అనుసరించడం మీ సంస్థ బాధ్యత. చూడండి అవుట్‌బౌండ్ కాలింగ్ చట్టాలు.
ఉదాహరణ వర్క్‌ఫ్లోలు
- CRM కాంటాక్ట్‌లను క్యాంపెయిన్‌కు పంపండి. CRM కాంటాక్ట్‌లను డ్రాఫ్ట్ ThunderPhone క్యాంపెయిన్‌కు జోడించండి, ఆపై ఎవరైనా జాబితాను ఆమోదించిన తర్వాత క్యాంపెయిన్‌ను ప్రారంభించండి.
- పూర్తయిన కాల్‌ను కస్టమర్ రికార్డ్‌కు పంపండి. కాల్ పూర్తయినప్పుడు, కాల్ పొందండిను అమలు చేసి ట్రాన్స్‌క్రిప్ట్ మరియు రికార్డింగ్ లింక్‌ను సరిపోలే కస్టమర్ రికార్డ్‌కు సేవ్ చేయండి.
- తక్కువ గ్రేడ్‌లను సమీక్షకు పంపండి. కాల్ గ్రేడ్ చేయబడినప్పుడు,
{{ $json.data.grade.score }}పై ఫిల్టర్ చేసి, తక్కువ స్కోర్ ఉన్న కాల్‌లను కాల్ ID మరియు గ్రేడ్ వివరాలతో సమీక్ష క్యూ‌కు పంపండి. ఒక కాల్‌ను ఒకటి కంటే ఎక్కువసార్లు గ్రేడ్ చేయవచ్చు, మరియు ప్రతి పూర్తైన గ్రేడింగ్ రన్ ట్రిగ్గర్ను ప్రారంభిస్తుంది, కాబట్టి ప్రతి కాల్ ID కోసం తాజాgraded_atను మాత్రమే ఉంచండి.
కాల్ ట్రాన్స్‌క్రిప్ట్‌లు, సారాంశాలు మరియు రికార్డింగ్‌లలో వ్యక్తిగత లేదా ఆరోగ్య సమాచారం ఉండవచ్చు. ఆరోగ్య సమాచారం ఉన్నప్పుడు BAA కింద, మీ సంస్థకు ఆ డేటా కోసం ఉపయోగించడానికి అనుమతి ఉన్న యాప్‌లకే వాటిని పంపండి మరియు మీకు అవసరమైన ఫీల్డ్‌లను మాత్రమే ఉంచండి.