---
title: "n8n உடன் ThunderPhone பயன்படுத்தவும்"
description: "n8n-க்கான ThunderPhone node-ஐ நிறுவி, server API key-ஐ இணைத்து, ஒவ்வொரு அழைப்பும் முடியும் போதும் இயங்கும் ஒரு workflow-ஐ உருவாக்கவும்."
---

[n8n](https://n8n.io) என்பது ஒரு பணிப்பாய்வு தானியக்கக் கருவி. n8n-க்கான ThunderPhone தொகுப்பு
இரண்டு நோடுகளைச் சேர்க்கிறது:

- **ThunderPhone Trigger**, ஒரு அழைப்பு முடிவடையும்போது (**அழைப்பு
  முடிந்தது**) அல்லது அழைப்பு தரமதிப்பீட்டு இயக்கம் நிறைவடையும்போது (**அழைப்பு தரமதிப்பிடப்பட்டது**) பணிப்பாய்வைத் தொடங்கும்.
- **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 விசையை உருவாக்குக](/ta/guides/api-keys) பக்கம் மாற்றுதல் மற்றும் ரத்து செய்தலை விளக்குகிறது.

## n8n-இல் சான்றைச் சேர்க்கவும்

1. n8n-இல், **ThunderPhone API** வகையிலான சான்றை உருவாக்கவும்.
2. விசையை **API விசை** என்பதில் ஒட்டவும்.
3. அதைச் சேமித்து சான்றுச் சோதனையை இயக்கவும். இந்தச் சோதனை உங்கள்
   நிறுவனத்திலிருந்து ஒரு அழைப்பை `GET /v1/calls?limit=1` மூலம் படிக்கும்.

## உங்கள் முதல் workflow-ஐ உருவாக்குங்கள்

ஒவ்வொரு அழைப்பும் முடியும் போதும் இந்த workflow ஒரு Google Sheet-இல் ஒரு வரியைச் சேர்க்கும்.

<Steps>
  <Step title="trigger-ஐச் சேர்க்கவும்">
    **ThunderPhone Trigger**-ஐச் சேர்த்து, உங்கள் ThunderPhone API credential-ஐத் தேர்ந்தெடுத்து,
    **Event**-ஐ **அழைப்பு முடிந்தது** என அமைக்கவும்.
  </Step>
  <Step title="அழைப்பைப் பெறவும்">
    ஒரு **ThunderPhone** node-ஐச் சேர்க்கவும். **Resource**-ஐ **Call** ஆகவும், **Operation**-ஐ
    **Get** ஆகவும், **Call ID**-ஐ `{{ $json.data.call_id }}` expression ஆகவும் அமைக்கவும்.
    வெளியீட்டில் [அழைப்பு பதிவு](/api-reference/calls), `transcripts`,
    மற்றும் `recording_url` இருக்கும்; இது குறுகிய காலம் மட்டுமே செல்லுபடியாகும் இணைப்பு, அழைப்பில்
    பதிவு இல்லையெனில் இது `null` ஆக இருக்கும்.
  </Step>
  <Step title="ஒரு வரியைச் சேர்க்கவும்">
    ஒரு வரியைச் சேர்க்கும் Google Sheets node-ஐச் சேர்த்து, உங்களுக்குத் தேவையான நெடுவரிசைகளை
    Get Call வெளியீட்டிலிருந்து map செய்யவும் (கீழேயுள்ள அட்டவணையைப் பார்க்கவும்).
  </Step>
  <Step title="workflow-ஐச் செயல்படுத்தவும்">
    சேமித்து செயல்படுத்தவும். trigger, அதன் தயாரிப்பு URL-ஐ உங்கள் ThunderPhone organization-இல்
    webhook endpoint ஆகப் பதிவு செய்கிறது. workflow-ஐ செயலிழக்கச் செய்தால் அந்த endpoint நீக்கப்படும்.
  </Step>
  <Step title="சோதிக்கவும்">
    builder-இல் ஒரு ஏஜென்டைத் திறந்து, **பேசு** என்பதைக் கிளிக் செய்து, அழைப்பை முடிக்கவும். Builder
    சோதனை அழைப்புகள் `web.complete` ஆக அனுப்பப்படும்; இது Call Completed-க்குப் பின்னால் உள்ள இரண்டு
    நிகழ்வுகளில் ஒன்று. எனவே workflow இயங்கி ஒரு வரி தோன்றும்.
  </Step>
</Steps>

பயனுள்ள நெடுவரிசைகள்:

| நெடுவரிசை | Expression |
|---|---|
| அழைப்பு 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 }}` |

அழைப்பு இணைப்பு, உங்கள் organization உறுப்பினர்களுக்காக அதன் transcript மற்றும் பதிவுடன்
ThunderPhone dashboard-இல் அழைப்பைத் திறக்கும்; எனவே sheet-இல் அவற்றில் எதையும்
வைத்திருக்க வேண்டியதில்லை.

இருப்பினும் transcript-ஐச் சேர்க்க,
`{{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}`-ஐ map செய்யவும்.
பதிவு URL காலாவதியாகும்; எனவே அழைப்பு ID-ஐச் சேமித்து, புதிய இணைப்பு தேவைப்படும்போது Get Call-ஐ மீண்டும் இயக்கவும். அழைப்பு transcripts, சுருக்கங்கள் மற்றும் பதிவுகளில்
தனிப்பட்ட அல்லது சுகாதாரத் தகவல்கள் இருக்கலாம். அந்தத் தரவைப் பயன்படுத்த உங்கள் organization-க்கு அனுமதிக்கப்பட்டுள்ள
apps-க்கு மட்டுமே அவற்றை அனுப்பவும்; சுகாதாரத் தகவல் தொடர்புடையதாக இருந்தால் BAA-இன் கீழ் அனுப்பவும்,
மேலும் உங்களுக்குத் தேவையான fields-ஐ மட்டுமே வைத்திருக்கவும்.

<Note>
  ThunderPhone, trigger-இன் **தயாரிப்பு
  URL**-க்கு `POST` மூலம் நிகழ்வுகளை அனுப்புகிறது; எனவே உங்கள் n8n instance இணையத்திலிருந்து HTTPS வழியாக அணுகக்கூடியதாக
  இருக்க வேண்டும், மேலும் workflow செயல்பாட்டில் இருக்க வேண்டும். trigger ஒவ்வொரு கோரிக்கையிலும்
  `X-ThunderPhone-Signature` HMAC-ஐச் சரிபார்த்து, கையொப்பமிடப்படாத அல்லது தவறான எதற்கும் `401` எனப்
  பதிலளிக்கும்.
</Note>

trigger முழுமையான நிகழ்வை வெளியிடுகிறது: `type`, `event_id` மற்றும் `data`. அனைத்து fields-க்கும்
[`telephony.complete` / `web.complete`](/ta/webhooks/call-complete) மற்றும்
[`call.graded`](/ta/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 கிரெடிட்களைச் செலவிடும் என்பதை உறுதிப்படுத்தும் தேர்வுப்பெட்டி **தொடங்கு** என்பதற்கு அவசியம். [வெளிச்செல்லும் பிரச்சாரங்கள்](/ta/guides/outbound-campaigns) என்பதைப் பார்க்கவும்.

ஒரு வொர்க்ஃப்ளோ அழைப்புகளைத் தொடங்குவதற்கு முன்:

- ThunderPhone உங்கள் நிறுவனத்தின் வெளிச்செல்லும் அழைப்புகள் TCPA மற்றும் பிற அழைப்பு சட்டங்களைப் பின்பற்றுகின்றன என்பதை உறுதிப்படுத்தக் கேட்டால், நிர்வாகி முதலில் டாஷ்போர்டில் அந்த உறுதிப்படுத்தலைப் பதிவுசெய்ய வேண்டும்.
- அனுப்புநர் எண் வெளிச்செல்லும் அழைப்புகளுக்காக இயக்கப்பட்டிருக்க வேண்டும். உங்கள் சொந்த கேரியரிடமிருந்து கொண்டுவரும் எண்கள் சரிபார்க்கப்பட்டதும் தகுதி பெறும். ThunderPhone எண்கள் முதலில் உள்வரும் அழைப்புகளுக்கு மட்டும் இருக்கும்; வெளிச்செல்லும் பயன்பாட்டிற்காக ஒப்புதல் பெறலாம்: ஒரு நிர்வாகி அதை தொலைபேசி எண்கள் பக்கத்திலிருந்து கோர வேண்டும். [தொலைபேசி எண்ணைப் பெறுங்கள்](/ta/guides/get-a-phone-number) என்பதைப் பார்க்கவும்.
- ஒவ்வொரு எண்ணுக்கும் அழைப்பதற்கான ஒப்புதல் உங்களிடம் இருப்பதையும் பொருந்தும் அழைப்பு சட்டங்களைப் பின்பற்றுவதையும் உங்கள் நிறுவனம் உறுதிசெய்ய வேண்டும். [வெளிச்செல்லும் அழைப்பு சட்டங்கள்](/ta/guides/outbound-calling-laws) என்பதைப் பார்க்கவும்.

## எடுத்துக்காட்டு வொர்க்ஃப்ளோக்கள்

- **CRM தொடர்புகளைப் பிரச்சாரத்தில் சேர்த்தல்.** CRM தொடர்புகளை ஒரு வரைவு ThunderPhone பிரச்சாரத்தில் சேர்த்து, யாராவது பட்டியலை அங்கீகரித்ததும் பிரச்சாரத்தைத் தொடங்குங்கள்.
- **முடிக்கப்பட்ட அழைப்பை வாடிக்கையாளர் பதிவில் சேர்த்தல்.** அழைப்பு முடிந்ததும், அழைப்பைப் பெறு என்பதை இயக்கி, உரையாடல் பதிவு மற்றும் பதிவு இணைப்பை பொருந்தும் வாடிக்கையாளர் பதிவில் சேமியுங்கள்.
- **குறைந்த மதிப்பெண்களை மதிப்பாய்வுக்கு அனுப்புதல்.** அழைப்பு தரப்படுத்தப்பட்டதும்,
  `{{ $json.data.grade.score }}` அடிப்படையில் வடிகட்டி, குறைந்த மதிப்பெண் பெற்ற அழைப்புகளை அழைப்பு ID மற்றும் தர விவரங்களுடன் மதிப்பாய்வு வரிசைக்கு அனுப்புங்கள். ஒரு அழைப்பு ஒன்றுக்கு மேற்பட்ட முறை தரப்படுத்தப்படலாம்; ஒவ்வொரு முடிக்கப்பட்ட தரப்படுத்தல் இயக்கமும் டிரிகரை இயக்கும், எனவே ஒவ்வொரு அழைப்பு ID-க்கும் சமீபத்திய `graded_at` மட்டும் வைத்திருங்கள்.

அழைப்பு உரையாடல் பதிவுகள், சுருக்கங்கள் மற்றும் பதிவுகளில் தனிப்பட்ட அல்லது சுகாதாரத் தகவல்கள் இருக்கலாம். அந்தத் தரவைப் பயன்படுத்த உங்கள் நிறுவனத்திற்கு அனுமதிக்கப்பட்டுள்ள செயலிகளுக்கு மட்டுமே அவற்றை அனுப்புங்கள்; சுகாதாரத் தகவல் தொடர்புடைய இடங்களில் BAA-இன் கீழ் அனுப்புங்கள், மேலும் உங்களுக்குத் தேவையான புலங்களை மட்டுமே வைத்திருங்கள்.

<Note>
  அதே அழைப்பு நிகழ்வுகளை உங்கள் சொந்த சர்வருக்கு அனுப்புகிறீர்களா? [Webhook எண்ட்பாயிண்ட்கள்](/ta/webhooks/endpoints) என்பதைப் பார்க்கவும்.
  [வெளிச்செல்லும் அழைப்புகளை மேற்கொள்ளுங்கள்](/ta/guides/place-outbound-calls) என்பது வெளிச்செல்லும் அழைப்பை மேற்கொள் என்பதற்குப் பின்னுள்ள API-ஐ விளக்குகிறது.
</Note>