---
title: "n8nతో ThunderPhone ఉపయోగించండి"
description: "n8n కోసం ThunderPhone నోడ్‌ను ఇన్‌స్టాల్ చేసి, సర్వర్ API కీని కనెక్ట్ చేసి, ప్రతి కాల్ ముగిసినప్పుడు అమలయ్యే వర్క్‌ఫ్లోను రూపొందించండి."
---

[n8n](https://n8n.io) అనేది వర్క్‌ఫ్లో ఆటోమేషన్ సాధనం. n8n కోసం ThunderPhone ప్యాకేజ్
రెండు నోడ్లను జోడిస్తుంది:

- **ThunderPhone ట్రిగ్గర్** కాల్ ముగిసినప్పుడు (**కాల్
  పూర్తయింది**) లేదా కాల్ గ్రేడింగ్ రన్ పూర్తయినప్పుడు (**కాల్ గ్రేడ్ చేయబడింది**) వర్క్‌ఫ్లోను ప్రారంభిస్తుంది.
- **ThunderPhone** అవుట్‌బౌండ్ కాల్‌లను చేస్తుంది, క్యాంపెయిన్‌లకు కాంటాక్ట్‌లను జోడించి
  వాటిని ప్రారంభిస్తుంది, ట్రాన్స్‌క్రిప్ట్ మరియు రికార్డింగ్‌తో కాల్‌లను పొందుతుంది, అలాగే మీ
  ఏజెంట్లు మరియు ఫోన్ నంబర్‌లను జాబితా చేస్తుంది.

ఇది ధృవీకరించబడిన కమ్యూనిటీ నోడ్, దీనిని
[n8nలోని ThunderPhone](https://n8n.io/integrations/thunderphone/) వద్ద జాబితా చేశారు.

## నోడ్‌ను ఇన్‌స్టాల్ చేయండి

n8n ఎడిటర్‌లో, నోడ్ల ప్యానెల్ తెరవడానికి **+** క్లిక్ చేసి
**ThunderPhone** కోసం వెతకండి. ఇతర వినియోగదారులు వాటిని జోడించడానికి ముందు ఇన్‌స్టాన్స్ ఓనర్ ధృవీకరించబడిన నోడ్లను సెటప్ చేయాల్సి రావచ్చు.

సెల్ఫ్-హోస్టెడ్ n8nలో, మీరు ప్యాకేజ్ పేరుతో కూడా ఇన్‌స్టాల్ చేయవచ్చు: 
**సెట్టింగ్‌లు > కమ్యూనిటీ నోడ్లు** తెరిచి `n8n-nodes-thunderphone`ను ఇన్‌స్టాల్ చేయండి. ఇన్‌స్టాల్ చేసే ముందు
కమ్యూనిటీ-నోడ్ ప్రమాదాలు మరియు మీ ఇన్‌స్టాన్స్ విధానాన్ని పరిశీలించండి.

## సర్వర్ API కీని సృష్టించండి

<Steps>
  <Step title="కీస్ ట్యాబ్‌ను తెరవండి">
    ThunderPhoneలో, **ఆర్గనైజేషన్ → కీస్**కు వెళ్లి **కీని సృష్టించండి** క్లిక్ చేయండి.
  </Step>
  <Step title="దీనికి పేరు ఇవ్వండి">
    కీ ఎక్కడ ఉందో తెలిపే పేరును ఉపయోగించండి, ఉదాహరణకు "n8n".
  </Step>
  <Step title="ఇప్పుడే కాపీ చేయండి">
    పూర్తి `sk_live_...` రహస్యం ఒకసారి మాత్రమే చూపబడుతుంది. డైలాగ్‌ను మూసే ముందు దాన్ని
    కాపీ చేయండి.
  </Step>
</Steps>

అడ్మిన్ లేదా ఓనర్ మాత్రమే కీని సృష్టించగలరు, మరియు ThunderPhone దానితో చేసిన అభ్యర్థనలను
ఆ వ్యక్తి చేసినవిగానే పరిగణిస్తుంది. ట్రిగ్గర్ మరియు క్యాంపెయిన్
ఆపరేషన్‌ల కోసం ఆ వ్యక్తి అడ్మిన్ లేదా ఓనర్ పాత్రను కొనసాగించాలి.
[సర్వర్ API కీని సృష్టించండి](/te/guides/api-keys) రొటేషన్ మరియు రద్దును వివరిస్తుంది.

## n8nలో క్రెడెన్షియల్‌ను జోడించండి

1. n8nలో, **ThunderPhone API** రకానికి చెందిన క్రెడెన్షియల్‌ను సృష్టించండి.
2. కీని **API కీ**లో అతికించండి.
3. దాన్ని సేవ్ చేసి క్రెడెన్షియల్ పరీక్షను అమలు చేయండి. ఈ పరీక్ష మీ
   ఆర్గనైజేషన్ నుండి `GET /v1/calls?limit=1`తో ఒక కాల్‌ను చదువుతుంది.

## మీ మొదటి వర్క్‌ఫ్లోను నిర్మించండి

ప్రతి కాల్ ముగిసినప్పుడు ఈ వర్క్‌ఫ్లో Google Sheetకు ఒక వరుసను జోడిస్తుంది.

<Steps>
  <Step title="ట్రిగ్గర్‌ను జోడించండి">
    **ThunderPhone ట్రిగ్గర్**ను జోడించి, మీ ThunderPhone API క్రెడెన్షియల్‌ను ఎంచుకుని,
    **ఈవెంట్**ను **కాల్ పూర్తయింది**గా సెట్ చేయండి.
  </Step>
  <Step title="కాల్‌ను పొందండి">
    ఒక **ThunderPhone** నోడ్‌ను జోడించండి. **రిసోర్స్**ను **కాల్**గా, **ఆపరేషన్**ను
    **పొందండి**గా సెట్ చేసి, **కాల్ ID**ని `{{ $json.data.call_id }}` ఎక్స్‌ప్రెషన్‌గా సెట్ చేయండి.
    అవుట్‌పుట్‌లో [కాల్ రికార్డ్](/api-reference/calls)తో పాటు `transcripts`
    మరియు `recording_url` ఉంటాయి; ఇది స్వల్పకాలం మాత్రమే చెల్లుబాటయ్యే లింక్, కాల్‌కు
    రికార్డింగ్ లేకపోతే ఇది `null`గా ఉంటుంది.
  </Step>
  <Step title="వరుసను జోడించండి">
    ఒక వరుసను జోడించే Google Sheets నోడ్‌ను చేర్చి, మీకు కావలసిన కాలమ్‌లను
    Get Call అవుట్‌పుట్ నుండి మ్యాప్ చేయండి (క్రింది పట్టికను చూడండి).
  </Step>
  <Step title="వర్క్‌ఫ్లోను యాక్టివేట్ చేయండి">
    సేవ్ చేసి యాక్టివేట్ చేయండి. ట్రిగ్గర్ దాని ప్రొడక్షన్ URLను మీ ThunderPhone సంస్థలో
    వెబ్‌హుక్ ఎండ్‌పాయింట్‌గా నమోదు చేస్తుంది. వర్క్‌ఫ్లోను డీయాక్టివేట్ చేస్తే
    ఆ ఎండ్‌పాయింట్ తొలగించబడుతుంది.
  </Step>
  <Step title="దీన్ని పరీక్షించండి">
    బిల్డర్‌లో ఒక ఏజెంట్‌ను తెరిచి, **మాట్లాడండి** క్లిక్ చేసి, కాల్‌ను ముగించండి. బిల్డర్
    టెస్ట్ కాల్‌లు `web.complete`గా డెలివర్ అవుతాయి, ఇది Call Completed వెనుక ఉన్న రెండు
    ఈవెంట్‌లలో ఒకటి; కాబట్టి వర్క్‌ఫ్లో నడుస్తుంది మరియు ఒక వరుస కనిపిస్తుంది.
  </Step>
</Steps>

ఉపయోగకరమైన కాలమ్‌లు:

| కాలమ్ | ఎక్స్‌ప్రెషన్ |
|---|---|
| కాల్ 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 కింద పంపండి మరియు మీకు అవసరమైన
ఫీల్డ్‌లను మాత్రమే ఉంచండి.

<Note>
  ThunderPhone ట్రిగ్గర్ యొక్క **ప్రొడక్షన్
  URL**కు `POST` ద్వారా ఈవెంట్‌లను డెలివర్ చేస్తుంది, కాబట్టి మీ n8n ఇన్‌స్టాన్స్ ఇంటర్నెట్ నుండి
  HTTPS ద్వారా చేరుకోగలిగేలా ఉండాలి మరియు వర్క్‌ఫ్లో యాక్టివ్‌గా ఉండాలి. ట్రిగ్గర్ ప్రతి
  రిక్వెస్ట్‌లోని `X-ThunderPhone-Signature` HMACను ధృవీకరిస్తుంది మరియు సంతకం లేని లేదా
  చెల్లని దేనికైనా `401`తో స్పందిస్తుంది.
</Note>

ట్రిగ్గర్ పూర్తి ఈవెంట్‌ను అవుట్‌పుట్ చేస్తుంది: `type`, `event_id` మరియు `data`. ప్రతి
ఫీల్డ్ కోసం [`telephony.complete` / `web.complete`](/te/webhooks/call-complete) మరియు
[`call.graded`](/te/webhooks/events) చూడండి. డెలివరీ కనీసం ఒకసారి జరుగుతుంది మరియు ఒకే
ఈవెంట్‌కు రీట్రైలు జరిగినప్పటికీ `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
క్రెడిట్‌లను ఖర్చు చేస్తుందని నిర్ధారించే చెక్‌బాక్స్ అవసరం. [అవుట్‌బౌండ్ క్యాంపెయిన్‌లు](/te/guides/outbound-campaigns) చూడండి.

వర్క్‌ఫ్లో కాల్‌లను ప్రారంభించే ముందు:

- మీ సంస్థ అవుట్‌బౌండ్ కాల్‌లు TCPA మరియు ఇతర కాలింగ్ చట్టాలను
  అనుసరిస్తాయని ThunderPhone నిర్ధారించమని అడిగితే, ఒక అడ్మిన్ ముందుగా
  డ్యాష్‌బోర్డ్‌లో ఆ నిర్ధారణను నమోదు చేయాలి.
- పంపే నంబర్ అవుట్‌బౌండ్ కాల్‌లకు ఎనేబుల్ చేయబడి ఉండాలి. మీరు మీ స్వంత
  క్యారియర్ నుండి తీసుకొచ్చే నంబర్‌లు ధృవీకరించబడిన తర్వాత అర్హత పొందుతాయి. ThunderPhone నంబర్‌లు మొదట
  ఇన్‌బౌండ్-మాత్రమే ఉంటాయి మరియు అవుట్‌బౌండ్ ఉపయోగం కోసం ఆమోదించబడవచ్చు: ఒక అడ్మిన్ ఫోన్ నంబర్‌ల పేజీ నుండి దానిని అభ్యర్థిస్తారు. చూడండి
  [ఫోన్ నంబర్ పొందండి](/te/guides/get-a-phone-number).
- ప్రతి నంబర్‌కు కాల్ చేయడానికి సమ్మతి కలిగి ఉండటం మరియు వర్తించే
  కాలింగ్ చట్టాలను అనుసరించడం మీ సంస్థ బాధ్యత. చూడండి
  [అవుట్‌బౌండ్ కాలింగ్ చట్టాలు](/te/guides/outbound-calling-laws).

## ఉదాహరణ వర్క్‌ఫ్లోలు

- **CRM కాంటాక్ట్‌లను క్యాంపెయిన్‌కు పంపండి.** CRM కాంటాక్ట్‌లను డ్రాఫ్ట్ ThunderPhone
  క్యాంపెయిన్‌కు జోడించండి, ఆపై ఎవరైనా జాబితాను ఆమోదించిన తర్వాత క్యాంపెయిన్‌ను ప్రారంభించండి.
- **పూర్తయిన కాల్‌ను కస్టమర్ రికార్డ్‌కు పంపండి.** కాల్ పూర్తయినప్పుడు, **కాల్ పొందండి**ను అమలు చేసి
  ట్రాన్స్‌క్రిప్ట్ మరియు రికార్డింగ్ లింక్‌ను సరిపోలే కస్టమర్ రికార్డ్‌కు సేవ్ చేయండి.
- **తక్కువ గ్రేడ్‌లను సమీక్షకు పంపండి.** కాల్ గ్రేడ్ చేయబడినప్పుడు,
  `{{ $json.data.grade.score }}`పై ఫిల్టర్ చేసి, తక్కువ స్కోర్ ఉన్న కాల్‌లను కాల్ ID మరియు గ్రేడ్ వివరాలతో
  సమీక్ష క్యూ‌కు పంపండి. ఒక కాల్‌ను ఒకటి కంటే ఎక్కువసార్లు గ్రేడ్ చేయవచ్చు,
  మరియు ప్రతి పూర్తైన గ్రేడింగ్ రన్ ట్రిగ్గర్‌ను ప్రారంభిస్తుంది, కాబట్టి ప్రతి కాల్ ID కోసం తాజా
  `graded_at`ను మాత్రమే ఉంచండి.

కాల్ ట్రాన్స్‌క్రిప్ట్‌లు, సారాంశాలు మరియు రికార్డింగ్‌లలో వ్యక్తిగత లేదా ఆరోగ్య
సమాచారం ఉండవచ్చు. ఆరోగ్య సమాచారం ఉన్నప్పుడు BAA కింద, మీ సంస్థకు ఆ డేటా కోసం ఉపయోగించడానికి అనుమతి ఉన్న యాప్‌లకే వాటిని పంపండి మరియు మీకు అవసరమైన ఫీల్డ్‌లను మాత్రమే ఉంచండి.

<Note>
  అదే కాల్ ఈవెంట్‌లను మీ స్వంత సర్వర్‌కు పంపుతున్నారా? చూడండి
  [Webhook ఎండ్‌పాయింట్‌లు](/te/webhooks/endpoints).
  [అవుట్‌బౌండ్ కాల్‌లు చేయండి](/te/guides/place-outbound-calls) అవుట్‌బౌండ్ కాల్ చేయండి వెనుక ఉన్న APIని వివరిస్తుంది.
</Note>