خودکارسازی تماس‌های خروجی Typeform با Vapi در n8n

خودکارسازی تماس‌های خروجی برای ارسال‌های جدید Typeform با دستیار صوتی Vapi

این گردش کار، تماس‌های تلفنی خروجی را با استفاده از دستیار صوتی Vapi، که با ارسال‌های جدید Typeform حاوی شماره تلفن فعال می‌شود، خودکار می‌کند. این گردش کار برای سناریوهایی ایده‌آل است که نیاز به ارتباط صوتی فوری یا زمان‌بندی شده بر اساس ورودی کاربر از فرم‌های Typeform دارند. گردش کار، ارسال‌های جدید را دریافت می‌کند، برای ثبات داده‌ها کمی صبر می‌کند، اعتبارنامه‌های API Vapi را پیکربندی می‌کند و سپس یک تماس خروجی را از طریق API Vapi آغاز می‌کند.

این و سایر گردش کارهای اتوماسیون قدرتمند را در کاتالوگ Axeto n8n کاوش کنید.

تشریح گردش کار

این گردش کار به چهار بلوک منطقی تقسیم شده است:

1. دریافت ورودی: دریافت ارسال‌های جدید فرم Typeform حاوی شماره تلفن.

2. مدیریت تأخیر: یک دوره انتظار کوتاه برای اطمینان از آمادگی داده‌ها یا برای تنظیم سرعت تماس‌های خروجی.

3. تنظیم پیکربندی Vapi: تخصیص اعتبارنامه‌های API Vapi و پارامترهای لازم برای تماس.

4. اجرای تماس خروجی: ارسال یک درخواست HTTP به API Vapi برای آغاز تماس صوتی.

---

۱. دریافت ورودی: Typeform Trigger

• هدف: این نود به پاسخ‌های جدید ارسال شده به یک فرم Typeform خاص گوش می‌دهد و به عنوان نقطه ورود گردش کار عمل می‌کند.
• نوع نود: Typeform Trigger
• پیکربندی:

* Form ID: FW7LOAGB (شناسه فرم Typeform خاص خود را جایگزین کنید).

* Credentials: نیاز به یک توکن دسترسی شخصی Typeform پیکربندی شده دارد.

• مدیریت داده: داده‌های ارسال شده را استخراج می‌کند، به طور خاص شماره تلفن را از فیلد Phone.
• خروجی: داده‌های ارسال شده را به نود بعدی منتقل می‌کند.
• مشکلات احتمالی: خطاهای احراز هویت به دلیل اعتبارنامه‌های منقضی شده یا لغو شده؛ خرابی ثبت وب‌هوک در صورت نامعتبر بودن شناسه فرم یا به دلیل مشکلات شبکه.
• نکته: اطمینان حاصل کنید که فرم Typeform شما شامل فیلدی برای دریافت شماره تلفن است.

---

۲. مدیریت تأخیر: Wait 2min

• هدف: پس از دریافت ارسال Typeform، یک تأخیر ثابت ۲ دقیقه‌ای ایجاد می‌کند. این می‌تواند به اطمینان از ثبات داده‌ها در سیستم‌ها یا جلوگیری از تماس‌های سریع و متوالی کمک کند.
• نوع نود: Wait
• پیکربندی:

* Unit: Minutes

* Amount: 2

• مدیریت داده: داده‌های دریافتی را بدون تغییر به نود بعدی منتقل می‌کند.
• مشکلات احتمالی: اتمام زمان اجرای گردش کار در صورت تجاوز از محدودیت‌های زمانی اجرای کلی.

---

۳. تنظیم پیکربندی Vapi: Set fields

• هدف: این نود اعتبارنامه‌های API Vapi و شناسه‌های لازم برای تماس خروجی را متمرکز و تنظیم می‌کند.
• نوع نود: Set
• پیکربندی: فیلدهای رشته‌ای ثابت را تعریف می‌کند:

* vapiPhoneNumberId: شناسه شماره تلفن ثبت شده Vapi برای استفاده در تماس.

* vapiAssistantId: شناسه دستیار صوتی Vapi برای فعال‌سازی.

* vapiApi: کلید API Vapi شما برای احراز هویت.

* نکته: مقادیر جایگزین (مانند "insert-id"، "insert-api") هستند و باید با اطلاعات واقعی حساب Vapi شما جایگزین شوند.

• مدیریت داده: فیلدهای Vapi تعریف شده را به داده‌های گردش کار اضافه می‌کند.
• مشکلات احتمالی: خرابی تماس API در مراحل بعدی در صورت مفقود بودن یا نادرست بودن شناسه‌ها یا کلید API.

---

۴. اجرای تماس خروجی: Start outbound Vapi call

• هدف: با ارسال یک درخواست HTTP POST به API Vapi، یک تماس صوتی خروجی را آغاز می‌کند.
• نوع نود: HTTP Request
• پیکربندی:

* URL: https://api.vapi.ai/call

* Method: POST

* Headers:

* Authorization: Bearer {{ $json.vapiApi }} (از کلید API تنظیم شده در نود قبلی استفاده می‌کند).

* Body Content Type: JSON

* Body:

```json

{

"assistantId": "{{ $json.vapiAssistantId }}",

"phoneNumberId": "{{ $json.vapiPhoneNumberId }}",

"customer": {

"number": "{{ $('Typeform Trigger').item.json.Phone }}"

}

}

```

* این JSON به طور پویا درخواست را با استفاده از اعتبارنامه‌های Vapi و شماره تلفن از ارسال Typeform می‌سازد.

• مدیریت داده: درخواست را به Vapi ارسال می‌کند و پاسخ API را برمی‌گرداند.
• مشکلات احتمالی:

* خرابی احراز هویت در صورت نامعتبر یا منقضی شدن کلید API.

* خرابی شروع تماس به دلیل شماره تلفن‌های نادرست یا با فرمت نادرست.

* اتمام زمان شبکه یا محدودیت‌های نرخ API Vapi.

* خطاها در صورت مفقود بودن یا نادرست بودن شناسه‌های دستیار یا شماره تلفن Vapi.

• نکته: اطمینان حاصل کنید که فیلدهای Vapi به درستی پیکربندی شده‌اند و ارسال Typeform شامل یک شماره تلفن معتبر است.

---

جدول خلاصه

---

بازسازی گردش کار

برای ساخت این گردش کار از ابتدا، مراحل زیر را دنبال کنید:

1. افزودن نود Typeform Trigger:

* نوع: Typeform Trigger

* Form ID: FW7LOAGB (یا شناسه فرم شما).

* Credentials: توکن دسترسی شخصی Typeform خود را پیکربندی کنید.

2. افزودن نود Wait:

* نوع: Wait

* Unit: Minutes

* Amount: 2

* خروجی Typeform Trigger را به این نود متصل کنید.

3. افزودن نود Set:

* نوع: Set

* سه فیلد اضافه کنید:

* vapiPhoneNumberId: شناسه شماره تلفن Vapi خود را وارد کنید.

* vapiAssistantId: شناسه دستیار Vapi خود را وارد کنید.

* vapiApi: کلید API Vapi خود را وارد کنید.

* خروجی نود Wait را به این نود متصل کنید.

* بسیار مهم: مقادیر جایگزین را با اعتبارنامه‌های واقعی Vapi خود جایگزین کنید.

4. افزودن نود HTTP Request:

* نوع: HTTP Request

* URL: https://api.vapi.ai/call

* Method: POST

* Headers: Authorization را با مقدار Bearer {{ $json.vapiApi }} اضافه کنید.

* Body Content Type: JSON

* Body: ساختار JSON ارائه شده در بخش "اجرای تماس خروجی" در بالا را جای‌گذاری کنید و اطمینان حاصل کنید که ارجاعات متغیر صحیح هستند.

* خروجی نود Set را به این نود متصل کنید.

5. فعال‌سازی گردش کار:

* اطمینان حاصل کنید که تمام اعتبارنامه‌ها معتبر هستند و فرم Typeform به درستی با فیلد شماره تلفن راه‌اندازی شده است.

* گردش کار را فعال کنید.

---

منابع

• مستندات API Vapi: https://docs.vapi.ai/api-reference/calls/create
• اعتبارنامه‌های Typeform n8n: https://docs.n8n.io/integrations/builtin/credentials/typeform/
• حساب Vapi: https://vapi.ai/

---

سلب مسئولیت: این گردش کار به طور خودکار توسط n8n تولید شده است. تمام محتوا با خط‌مشی‌های استفاده مطابقت دارد و داده‌های قانونی و عمومی را مدیریت می‌کند.