نود Google Contacts در N8N

نود Google Contacts در N8N

نود Google Contacts در N8N ابزاری کاربردی برای مدیریت مخاطبین گوگل در ورکفلوهای اتوماسیون است. با این نود می‌توانید مخاطب جدید بسازید، اطلاعات مخاطبین را دریافت کنید، مخاطب‌ها را به‌روزرسانی یا حذف کنید و حتی گروه‌های مخاطبین را مدیریت کنید. این نود برای اتصال سیستم‌های فروش، فرم‌های ثبت‌نام، CRM، ابزارهای پشتیبانی و کمپین‌های بازاریابی به Google Contacts بسیار مفید است.

معرفی نود در N8N

نود Google Contacts یک نود Integration و Action در N8N است که از طریق Google People API به حساب Google شما متصل می‌شود و امکان کار با مخاطبین و گروه‌های مخاطبین را فراهم می‌کند.

این نود معمولاً زمانی استفاده می‌شود که بخواهید اطلاعات تماس افراد را از منابع مختلف جمع‌آوری کرده و به‌صورت خودکار در Google Contacts ذخیره یا مدیریت کنید.

دسته‌بندی نود

  • نوع نود: Integration
  • رفتار نود: Action
  • سرویس متصل‌شونده: Google Contacts / Google People API
  • نیاز به احراز هویت: دارد، از طریق Google OAuth2

کاربرد اصلی نود

  • ایجاد خودکار مخاطب جدید در Google Contacts
  • دریافت اطلاعات یک مخاطب بر اساس شناسه
  • جستجو و دریافت لیست مخاطبین
  • به‌روزرسانی اطلاعات مخاطبین موجود
  • حذف مخاطبین تکراری یا غیرضروری
  • ایجاد و مدیریت گروه‌های مخاطبین
  • اتصال فرم‌ها، CRMها، فروشگاه‌ها و ابزارهای پشتیبانی به Google Contacts

موارد استفاده

نود Google Contacts زمانی ارزشمند می‌شود که بخواهید اطلاعات تماس کاربران، مشتریان، لیدها یا اعضای تیم را بدون ورود دستی اطلاعات مدیریت کنید. در ادامه چند سناریوی کاربردی آورده شده است.

ثبت خودکار مخاطب از فرم سایت

فرض کنید در سایت خود یک فرم تماس یا فرم ثبت‌نام دارید. با استفاده از Webhook یا نودهای فرم‌ساز مانند Typeform، Tally، Google Forms یا Gravity Forms می‌توانید اطلاعات کاربر را دریافت کرده و با نود Google Contacts یک مخاطب جدید بسازید.

  • Webhook: دریافت داده فرم
  • Set: مرتب‌سازی فیلدها مانند نام، ایمیل و شماره تماس
  • Google Contacts: ایجاد مخاطب جدید

همگام‌سازی CRM با Google Contacts

اگر از ابزارهایی مانند HubSpot، Pipedrive، Airtable، Notion یا یک CRM اختصاصی استفاده می‌کنید، می‌توانید اطلاعات مشتریان را به Google Contacts منتقل کنید تا تیم فروش و پشتیبانی همیشه به شماره تماس و ایمیل مشتریان دسترسی داشته باشد.

  • CRM Node: دریافت لید یا مشتری جدید
  • IF: بررسی وجود ایمیل یا شماره تماس
  • Google Contacts: ایجاد یا به‌روزرسانی مخاطب

پاک‌سازی مخاطبین قدیمی

می‌توانید مخاطبینی را که از یک منبع خاص وارد شده‌اند یا مدت زیادی استفاده نشده‌اند شناسایی کرده و حذف کنید. برای این کار معمولاً از نود Google Contacts در کنار IF، Code و Split In Batches استفاده می‌شود.

ساخت گروه مخاطبین برای کمپین‌ها

اگر مخاطبین شما بر اساس منبع ورود، نوع مشتری یا کمپین دسته‌بندی می‌شوند، می‌توانید با Resource مربوط به Contact Group گروه بسازید و مخاطبین را بهتر مدیریت کنید.

ذخیره اطلاعات مشتریان فروشگاه آنلاین

در فروشگاه‌های اینترنتی، پس از ثبت سفارش جدید می‌توان نام، ایمیل و شماره تماس خریدار را در Google Contacts ذخیره کرد.

  • WooCommerce / Shopify: دریافت سفارش جدید
  • Set: استخراج نام، ایمیل، موبایل و آدرس
  • Google Contacts: ایجاد مخاطب جدید

پارامترها و تنظیمات

تنظیمات نود Google Contacts ممکن است بسته به نسخه N8N کمی متفاوت باشد، اما ساختار کلی آن معمولاً شامل احراز هویت، انتخاب Resource، انتخاب Operation و تکمیل فیلدهای مرتبط با مخاطب یا گروه مخاطبین است.

Credentials یا احراز هویت

  • نام پارامتر: Google OAuth2 API
  • نوع داده: Credential
  • توضیح: برای اتصال N8N به حساب Google و دسترسی به مخاطبین استفاده می‌شود.
  • مثال عملی: اتصال حساب Gmail یا Google Workspace برای مدیریت مخاطبین سازمانی.
  • نکته مهم: در Google Cloud Console باید API مرتبط با People API فعال باشد و Redirect URL مربوط به N8N در OAuth Client تنظیم شود.

Resource

  • نام پارامتر: Resource
  • نوع داده: Options
  • توضیح: مشخص می‌کند نود روی چه نوع داده‌ای کار کند.
  • گزینه‌های رایج: Contact و Contact Group
  • مثال عملی: اگر می‌خواهید مخاطب جدید بسازید، Resource را روی Contact قرار دهید. اگر می‌خواهید گروهی مانند Customers یا Leads بسازید، Resource را روی Contact Group قرار دهید.

Operation برای Contact

وقتی Resource روی Contact تنظیم شود، عملیات‌های رایج زیر در دسترس هستند.

  • Operation: Create
  • نوع داده: Options
  • توضیح: ایجاد مخاطب جدید در Google Contacts.
  • مثال عملی: بعد از ثبت فرم مشاوره، نام، ایمیل و موبایل کاربر به‌عنوان مخاطب جدید ذخیره شود.
  • Operation: Delete
  • نوع داده: Options
  • توضیح: حذف یک مخاطب با استفاده از شناسه مخاطب.
  • مثال عملی: حذف مخاطبینی که از لیست لغو عضویت خارج شده‌اند.
  • Operation: Get
  • نوع داده: Options
  • توضیح: دریافت اطلاعات یک مخاطب مشخص.
  • مثال عملی: دریافت جزئیات مخاطب قبل از به‌روزرسانی اطلاعات آن.
  • Operation: Get Many
  • نوع داده: Options
  • توضیح: دریافت لیستی از مخاطبین.
  • مثال عملی: دریافت همه مخاطبین و ارسال آن‌ها به Airtable برای گزارش‌گیری.
  • Operation: Update
  • نوع داده: Options
  • توضیح: به‌روزرسانی اطلاعات یک مخاطب موجود.
  • مثال عملی: تغییر شماره تماس مشتری بعد از ثبت اطلاعات جدید در CRM.

Operation برای Contact Group

وقتی Resource روی Contact Group تنظیم شود، می‌توانید با گروه‌های مخاطبین کار کنید.

  • Operation: Create
  • نوع داده: Options
  • توضیح: ایجاد گروه جدید برای دسته‌بندی مخاطبین.
  • مثال عملی: ساخت گروهی با نام Webinar Leads برای مخاطبین ثبت‌نام‌کننده در وبینار.
  • Operation: Delete
  • نوع داده: Options
  • توضیح: حذف یک گروه مخاطبین.
  • مثال عملی: حذف گروه‌های قدیمی مربوط به کمپین‌های تمام‌شده.
  • Operation: Get
  • نوع داده: Options
  • توضیح: دریافت اطلاعات یک گروه مشخص.
  • مثال عملی: بررسی نام و شناسه گروه قبل از استفاده در ورکفلو.
  • Operation: Get Many
  • نوع داده: Options
  • توضیح: دریافت لیست گروه‌های مخاطبین.
  • مثال عملی: نمایش همه گروه‌های موجود برای انتخاب گروه هدف در یک فرآیند اتوماسیون.
  • Operation: Update
  • نوع داده: Options
  • توضیح: تغییر نام یا اطلاعات یک گروه مخاطبین.
  • مثال عملی: تغییر نام گروه Leads 2024 به Qualified Leads.

فیلدهای رایج در ایجاد یا به‌روزرسانی Contact

  • First Name / Given Name – نوع داده: String – توضیح: نام مخاطب – مثال: علی
  • Last Name / Family Name – نوع داده: String – توضیح: نام خانوادگی مخاطب – مثال: رضایی
  • Email – نوع داده: String – توضیح: آدرس ایمیل مخاطب – مثال: ali@example.com
  • Phone Number – نوع داده: String – توضیح: شماره تماس مخاطب – مثال: +989121234567
  • Company – نوع داده: String – توضیح: نام شرکت یا سازمان مخاطب – مثال: شرکت نوآوران
  • Job Title – نوع داده: String – توضیح: سمت شغلی مخاطب – مثال: مدیر فروش
  • Notes / Biography – نوع داده: String – توضیح: توضیحات تکمیلی درباره مخاطب – مثال: ثبت‌نام از کمپین زمستانه
  • URL – نوع داده: String – توضیح: آدرس وب‌سایت یا پروفایل مخاطب – مثال: https://example.com
  • Address – نوع داده: String یا Object – توضیح: آدرس پستی یا محل کار مخاطب – مثال: تهران، خیابان ولیعصر

Contact ID یا Resource Name

  • نام پارامتر: Contact ID / Resource Name
  • نوع داده: String
  • توضیح: شناسه یکتای مخاطب در Google Contacts که معمولاً در خروجی عملیات Get Many یا Create دریافت می‌شود.
  • مثال عملی: people/c1234567890
  • نکته مهم: برای عملیات‌هایی مانند Get، Update و Delete معمولاً به این شناسه نیاز دارید.

Contact Group ID

  • نام پارامتر: Contact Group ID
  • نوع داده: String
  • توضیح: شناسه یکتای گروه مخاطبین.
  • مثال عملی: contactGroups/abc123
  • نکته مهم: شناسه گروه را می‌توانید با Operation برابر Get Many برای Contact Group دریافت کنید.

Return All

  • نام پارامتر: Return All
  • نوع داده: Boolean
  • توضیح: اگر فعال باشد، نود تلاش می‌کند همه نتایج قابل دریافت را برگرداند.
  • مثال عملی: دریافت تمام مخاطبین برای بررسی تکراری بودن ایمیل‌ها.
  • نکته مهم: در حساب‌هایی با تعداد مخاطبین زیاد، فعال کردن این گزینه ممکن است باعث افزایش زمان اجرای ورکفلو یا رسیدن به محدودیت API شود.

Limit

  • نام پارامتر: Limit
  • نوع داده: Number
  • توضیح: تعداد نتایجی که باید از API دریافت شود.
  • مثال عملی: دریافت فقط 100 مخاطب آخر برای پردازش سریع‌تر.
  • نکته مهم: اگر Return All غیرفعال باشد، Limit مشخص می‌کند حداکثر چند آیتم خروجی داده شود.

Additional Fields

  • نام پارامتر: Additional Fields
  • نوع داده: Collection
  • توضیح: مجموعه‌ای از فیلدهای اختیاری برای کامل‌تر کردن اطلاعات مخاطب.
  • مثال عملی: افزودن شرکت، عنوان شغلی، یادداشت، آدرس یا آدرس وب‌سایت به مخاطب.
  • نکته مهم: بهتر است فقط فیلدهایی را ارسال کنید که واقعاً مقدار دارند، چون ارسال مقدار خالی ممکن است باعث خطا یا ثبت اطلاعات ناقص شود.

نکات مهم هنگام پیکربندی

  • برای استفاده از این نود باید Google People API در پروژه Google Cloud فعال باشد.
  • حساب Google باید اجازه دسترسی به مخاطبین را به N8N بدهد.
  • برای عملیات خواندن، دسترسی read کافی است، اما برای ایجاد، حذف یا ویرایش مخاطب باید دسترسی write نیز وجود داشته باشد.
  • شماره تماس بهتر است با فرمت بین‌المللی ذخیره شود، مانند +989121234567.
  • ایمیل باید فرمت معتبر داشته باشد، مانند user@example.com.
  • قبل از ایجاد مخاطب جدید، بهتر است با ایمیل یا شماره تماس بررسی کنید که مخاطب تکراری ثبت نشود.
  • در عملیات Update و Delete باید از شناسه دقیق مخاطب استفاده شود.

ورودی‌ها و خروجی‌ها

نود Google Contacts ورودی خود را از نود قبلی دریافت می‌کند و بر اساس Operation انتخاب‌شده، داده‌ها را به Google Contacts ارسال کرده یا از آن دریافت می‌کند. خروجی نود معمولاً به‌صورت JSON است و می‌تواند در نودهای بعدی استفاده شود.

ورودی نود

ورودی می‌تواند شامل اطلاعات خام مخاطب از فرم، CRM، فایل CSV، فروشگاه آنلاین یا هر منبع دیگری باشد.

{  "firstName": "علی",  "lastName": "رضایی",  "email": "ali.rezaei@example.com",  "phone": "+989121234567",  "company": "شرکت نوآوران",  "jobTitle": "مدیر فروش"}

در نود Google Contacts می‌توانید این مقادیر را با Expression به فیلدهای مربوطه وصل کنید.

{{ $json.firstName }}{{ $json.lastName }}{{ $json.email }}{{ $json.phone }}

خروجی عملیات Create

پس از ایجاد مخاطب، خروجی معمولاً شامل شناسه مخاطب، etag و اطلاعات ثبت‌شده است.

{  "resourceName": "people/c1234567890",  "etag": "%EgUBAj03LhoBAQIFByIMR2F...",  "names": [    {      "metadata": {        "primary": true      },      "displayName": "علی رضایی",      "givenName": "علی",      "familyName": "رضایی"    }  ],  "emailAddresses": [    {      "value": "ali.rezaei@example.com"    }  ],  "phoneNumbers": [    {      "value": "+989121234567"    }  ],  "organizations": [    {      "name": "شرکت نوآوران",      "title": "مدیر فروش"    }  ]}

خروجی عملیات Get Many

در عملیات Get Many خروجی معمولاً شامل آرایه‌ای از مخاطبین است. هر آیتم خروجی می‌تواند یک مخاطب جداگانه باشد.

[  {    "resourceName": "people/c111",    "names": [      {        "displayName": "سارا محمدی",        "givenName": "سارا",        "familyName": "محمدی"      }    ],    "emailAddresses": [      {        "value": "sara@example.com"      }    ]  },  {    "resourceName": "people/c222",    "names": [      {        "displayName": "مهدی احمدی",        "givenName": "مهدی",        "familyName": "احمدی"      }    ],    "phoneNumbers": [      {        "value": "+989351112233"      }    ]  }]

خروجی Contact Group

اگر با گروه مخاطبین کار کنید، خروجی می‌تواند شامل نام گروه، شناسه گروه و تعداد اعضا باشد.

{  "resourceName": "contactGroups/customers",  "etag": "%EgkBAj0...",  "metadata": {    "updateTime": "2024-05-20T10:30:00Z"  },  "groupType": "USER_CONTACT_GROUP",  "name": "Customers",  "formattedName": "Customers",  "memberCount": 124}

نکات پیشرفته و ترفندها

جلوگیری از ایجاد مخاطب تکراری

یکی از مهم‌ترین نکات در کار با Google Contacts، جلوگیری از ثبت مخاطبین تکراری است. قبل از اجرای Operation برابر Create، بهتر است ابتدا با Get Many یا جستجو بر اساس ایمیل، بررسی کنید که مخاطب قبلاً وجود دارد یا نه.

  • مرحله 1: دریافت ایمیل از فرم یا CRM
  • مرحله 2: جستجو در مخاطبین
  • مرحله 3: استفاده از IF برای بررسی وجود مخاطب
  • مرحله 4: اگر وجود نداشت Create، اگر وجود داشت Update

استفاده از Expression برای نگاشت داینامیک فیلدها

در N8N می‌توانید فیلدهای Google Contacts را به‌صورت داینامیک از خروجی نودهای قبلی پر کنید.

{{ $json.customer.name }}{{ $json.customer.email }}{{ $json.billing.phone }}

این روش برای اتصال فروشگاه‌ها، فرم‌ها و CRMها بسیار کاربردی است.

نرمال‌سازی شماره تماس قبل از ذخیره

شماره‌هایی که از فرم‌ها دریافت می‌شوند ممکن است با فرمت‌های مختلفی وارد شده باشند. بهتر است قبل از ارسال به Google Contacts با نود Code یا Set شماره را یکسان‌سازی کنید.

{  "phone": "+989121234567"}
  • حذف فاصله‌ها و خط تیره‌ها
  • تبدیل 09 به +989 برای شماره‌های ایران
  • بررسی حداقل و حداکثر طول شماره

پردازش مخاطبین زیاد با Split In Batches

اگر می‌خواهید تعداد زیادی مخاطب را وارد یا به‌روزرسانی کنید، بهتر است از نود Split In Batches استفاده کنید تا درخواست‌ها به‌صورت دسته‌ای ارسال شوند و احتمال خطای Rate Limit کاهش پیدا کند.

  • Read CSV: خواندن فایل مخاطبین
  • Split In Batches: تقسیم مخاطبین به دسته‌های کوچک
  • Google Contacts: ایجاد یا به‌روزرسانی هر مخاطب
  • Wait: ایجاد فاصله بین درخواست‌ها در صورت نیاز

ترکیب با نود IF برای تصمیم‌گیری هوشمند

با نود IF می‌توانید مشخص کنید اگر ایمیل وجود داشت مخاطب ساخته شود، اگر شماره تماس خالی بود پردازش متوقف شود، یا اگر مخاطب متعلق به یک منبع خاص بود در گروه خاصی ذخیره شود.

ثبت منبع ورود مخاطب در Notes

برای ردیابی بهتر، می‌توانید منبع ورود مخاطب را در بخش Notes یا Biography ذخیره کنید.

ثبت‌شده از فرم لندینگ کمپین نوروزمنبع: Google Adsتاریخ ثبت: 2024-03-18

اتصال Google Contacts به ابزارهای بازاریابی

می‌توانید پس از ثبت مخاطب در Google Contacts، اطلاعات او را به ابزارهایی مانند Mailchimp، Brevo، ActiveCampaign یا Telegram ارسال کنید تا فرآیندهای بازاریابی و اطلاع‌رسانی نیز اجرا شوند.

محدودیت‌ها و خطاها

محدودیت‌های نود

  • این نود معمولاً Trigger نیست و به‌تنهایی با تغییرات مخاطبین فعال نمی‌شود؛ برای اجرای خودکار باید از Cron، Webhook یا Triggerهای دیگر استفاده شود.
  • دسترسی به مخاطبین وابسته به مجوزهای OAuth حساب Google است.
  • برخی فیلدهای پیچیده Google People API ممکن است در رابط ساده نود قابل تنظیم مستقیم نباشند.
  • در حساب‌هایی با تعداد مخاطبین زیاد، دریافت همه مخاطبین ممکن است زمان‌بر باشد.
  • Google API محدودیت تعداد درخواست دارد و ارسال تعداد زیاد درخواست در زمان کوتاه می‌تواند باعث خطای Rate Limit شود.
  • حذف مخاطب معمولاً برگشت‌پذیر نیست یا بازیابی آن به تنظیمات Google Contacts وابسته است.

خطای رایج: 401 Unauthorized

علت: Credential معتبر نیست، توکن منقضی شده یا دسترسی لازم داده نشده است.

  • Credential را دوباره متصل کنید.
  • مطمئن شوید حساب Google درست انتخاب شده است.
  • مجوزهای لازم برای خواندن و نوشتن مخاطبین را بررسی کنید.

خطای رایج: 403 Forbidden

علت: دسترسی به Google People API محدود شده یا API در Google Cloud فعال نیست.

  • Google People API را در Google Cloud Console فعال کنید.
  • Scopeهای OAuth را بررسی کنید.
  • اگر از Google Workspace استفاده می‌کنید، محدودیت‌های Admin Console را بررسی کنید.

خطای رایج: 404 Not Found

علت: شناسه مخاطب یا گروه اشتباه است یا مخاطب حذف شده است.

  • Contact ID را از خروجی Get Many یا Create کپی کنید.
  • فرمت شناسه را بررسی کنید؛ معمولاً شبیه people/c123456 است.
  • برای گروه‌ها از شناسه‌ای شبیه contactGroups/groupId استفاده کنید.

خطای رایج: 400 Bad Request

علت: داده ارسالی فرمت درستی ندارد یا فیلدهای ضروری ناقص هستند.

  • فرمت ایمیل را بررسی کنید.
  • شماره تماس را استاندارد کنید.
  • فیلدهای خالی را ارسال نکنید.
  • اگر از Expression استفاده می‌کنید، خروجی آن را در Execution بررسی کنید.

خطای Rate Limit

علت: تعداد زیادی درخواست در بازه زمانی کوتاه به Google API ارسال شده است.

  • از Split In Batches استفاده کنید.
  • بین دسته‌ها از نود Wait استفاده کنید.
  • از دریافت غیرضروری همه مخاطبین جلوگیری کنید.
  • فقط فیلدهای موردنیاز را دریافت یا ارسال کنید.

مشکل ثبت مخاطب تکراری

علت: قبل از Create بررسی نشده که مخاطب با همان ایمیل یا شماره وجود دارد یا نه.

  • قبل از Create از Get Many یا جستجو استفاده کنید.
  • با نود IF بررسی کنید که مخاطب قبلاً وجود دارد یا نه.
  • در صورت وجود مخاطب، به‌جای Create از Update استفاده کنید.

ایده ها

  • دفترچه تلفن هوشمند مشتریان: هر مشتری جدید از سایت، فروشگاه یا CRM به‌صورت خودکار در Google Contacts ذخیره شود و منبع ورود او در Notes ثبت گردد.
  • سیستم پیگیری لیدهای فروش: لیدهای جدید از فرم تبلیغاتی وارد Google Contacts شوند، در گروه Leads قرار بگیرند و هم‌زمان به تیم فروش در Slack یا Telegram اطلاع داده شود.
  • پاک‌سازی مخاطبین تکراری: مخاطبین از Google Contacts دریافت شوند، ایمیل‌ها و شماره‌ها بررسی شوند و موارد تکراری برای بررسی یا حذف علامت‌گذاری شوند.
  • مدیریت مخاطبین رویدادها: ثبت‌نام‌کنندگان وبینار یا همایش به گروه مخصوص همان رویداد در Google Contacts اضافه شوند.
  • اتصال فروشگاه به دفترچه مخاطبین: پس از هر خرید جدید، اطلاعات خریدار در Google Contacts ذخیره شود و در صورت خرید مجدد، اطلاعات قبلی او به‌روزرسانی گردد.

منابع و مستندات اصلی

دسته بندی: N8N برچسب ها:

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

چهار × 4 =