استخدم ThunderPhone مع Zapier

اربط تطبيق ThunderPhone على Zapier بمؤسستك وأنشئ Zap يعمل في كل مرة تنتهي فيها مكالمة.

Zapier يربط التطبيقات بسير عمل مؤتمت يُسمى Zaps. يضيف تطبيق ThunderPhone على Zapier ما يلي:

• المشغلات: يتم تشغيل اكتمال المكالمة عند انتهاء مكالمة هاتفية أو عبر الويب أو تجريبية. ويتم تشغيل تقييم المكالمة عند توفر تقييم مكالمة مكتملة.
• الإجراءات: إجراء مكالمة صادرة وإضافة جهات اتصال إلى حملة و بدء حملة.
• البحث: يبحث العثور على مكالمة عن مكالمة حسب المعرّف ويعرضها مع النص المفرغ الخاص بها وعنوان URL موقّع للتسجيل عند توفره.

اعثر عليه في ThunderPhone على Zapier. للحصول على نظرة عامة على طريقتَي استخدام Zapier مع ThunderPhone، راجع صفحة تكامل Zapier.

ربط مؤسستك#

يتصل التطبيق عبر OAuth. سجّل الدخول إلى ThunderPhone ووافق على الوصول إلى مؤسسة واحدة، ولن يتم نسخ أي مفتاح API إلى Zapier.

1. أضف خطوة ThunderPhone

   في محرر Zap، ابحث عن ThunderPhone (المعروض مع تسمية تجريبية) واختر مشغّلًا أو إجراءً. عندما يطلب Zapier حسابًا، اربط حسابًا جديدًا. سيفتح Zapier نافذة لتسجيل الدخول إلى ThunderPhone.

2. سجّل الدخول واختر المؤسسة

   سجّل الدخول، وراجع الأذونات المطلوبة، واختر المؤسسة، ثم حدد موافقة. يطلب التطبيق الإذن بقراءة وكلائك وأرقام الهواتف، وقراءة المكالمات والحملات وكتابتها، وإدارة عمليات التكامل مثل نقاط نهاية webhook، وعرض البريد الإلكتروني لحسابك.

3. تحقق من اسم الاتصال

   يُسمّي Zapier الاتصال باسم المؤسسة التي وافقت عليها، بحيث يمكنك التمييز بين الاتصالات عندما تنتمي إلى أكثر من مؤسسة واحدة.

اتصل باستخدام حساب لديه دور المسؤول أو المالك في تلك المؤسسة. يتطلب تشغيل Zap المشغّل أو إيقافه، وكذلك كل إجراء، هذا الدور. يستمر Zap المشغّل المفعّل بالفعل في تلقي أحداث المكالمات بعد تغيير الدور أو إلغاء الاتصال. أوقفه لإيقافها. يعمل العثور على مكالمة لأي عضو.

لا يفرض التطبيق أي رسوم مستقلة من ThunderPhone. تُحتسب المكالمات التي يجريها أو يبدأها بأسعار ThunderPhone المعتادة، ويحتسب Zapier المهام ضمن باقة Zapier الخاصة بك.

أنشئ أول Zap#

يضيف هذا الـ Zap صفًا إلى Google Sheet كلما انتهت مكالمة.

1. أجرِ مكالمة لاستخدامها كبيانات نموذجية

   افتح وكيلاً في أداة الإنشاء، وانقر تحدّث، ثم أنهِ المكالمة. تُطلق مكالمات الاختبار في أداة الإنشاء حدث اكتمال المكالمة، لذا يوفّر ذلك للمشغّل مكالمة حديثة لتحميلها.

2. أضف المشغّل

   اختر ThunderPhone كتطبيق المشغّل، واضبط الحدث على اكتمال المكالمة، ثم اختر اتصال ThunderPhone الخاص بك. اختبر المشغّل. يحمّل Zapier أحدث مكالماتك المكتملة كنماذج، بالبنية نفسها لحدث مباشر.

3. أضف Google Sheets

   أضف إجراءً في Google Sheets ينشئ صفًا في جدول بيانات. اختر ورقة تتضمن صف عناوين، ثم اربط كل عمود بحقل من المشغّل (راجع الجدول أدناه).

4. انشر الـ Zap

   انشر الـ Zap وشغّله. يؤدي تشغيله إلى إنشاء نقطة نهاية لـ webhook في مؤسسة ThunderPhone الخاصة بك باسم Zapier: اكتمال المكالمة. يؤدي إيقاف الـ Zap إلى حذف نقطة النهاية هذه.

5. اختبره

   أجرِ مكالمة اختبار أخرى من أداة الإنشاء. عند انتهائها، يعمل الـ Zap ويظهر صف.

أعمدة مفيدة:

يفتح رابط المكالمة المكالمة في لوحة تحكم ThunderPhone لأعضاء مؤسستك، مع نصها المفرغ وتسجيلها، لذلك لا تحتاج الورقة إلى الاحتفاظ بأي منهما.

يمكن أن يحمل الحدث أيضًا النص المفرغ، على شكل قائمة بالأدوار، ورابط التسجيل، وهو رابط موقّع تنتهي صلاحيته. أضفهما فقط إذا كانت الورقة تحتاج إليهما. قد تحتوي النصوص المفرغة للمكالمات والملخصات والتسجيلات على معلومات شخصية أو صحية. أرسلها فقط إلى التطبيقات التي يُسمح لمؤسستك باستخدامها لهذه البيانات، بموجب BAA عند وجود معلومات صحية، واحتفظ بالحقول التي تحتاج إليها فقط. راجع telephony.complete / web.complete للاطلاع على كل حقل.

المُشغّلات والإجراءات والبحث#

يوفّر تم تقييم المكالمة معرّف المكالمة، ومعرّف الوكيل، واسم الوكيل، والتقييم: معرّف التقييم، والنتيجة، ونتيجة المكالمة، والملخص، ونموذج التقييم، ووقت التقييم. يؤدي تشغيل Zap إلى إنشاء نقطة نهاية باسم Zapier: تم تقييم المكالمة. يمكن تقييم المكالمة أكثر من مرة، ويُفعّل كل تشغيل تقييم مكتمل المُشغّل. راجع call.graded.

يأخذ العثور على مكالمة معرّف مكالمة، مع قائمة منسدلة بالمكالمات الأخيرة. ويُرجع وكيل المكالمة، واتجاهها، وأرقامها، ووقتَي البدء والانتهاء، والحالة، وسبب الانتهاء، ونتيجة التقييم ونتيجة المكالمة، والنص المفرغ، ورابط URL موقّع للتسجيل عند توفره. لا يُرجع معرّف مكالمة غير معروف أي نتيجة بدلًا من حدوث خطأ.

يأخذ إجراء مكالمة صادرة ما يلي:

ويُرجع معرّف المكالمة، والحالة، وإعادة الاستجابة المتطابقة.

تضيف إضافة جهات اتصال إلى حملة جهات اتصال إلى حملة مسودة. لجهة اتصال واحدة، املأ رقم الهاتف بتنسيق E.164، واملأ اختياريًا متغيرات جهة الاتصال، وهو كائن JSON تصبح خصائصه متغيرات للحملة. ولدفعة، املأ JSON جهات الاتصال بمصفوفة تضم ما يصل إلى 5,000 كائن. يحتاج كل كائن إلى phone_number، وتصبح خصائصه الأخرى متغيرات. تفشل الخطوة عندما تُرفض جميع جهات الاتصال، وتضبط نجاح جزئي عندما يُقبل بعضها فقط.

يبدأ بدء الحملة حملةً تحتوي على جهة اتصال واحدة على الأقل أو يستأنفها. ويتطلب الموافقة على الفوترة. راجع الحملات الصادرة.

قبل أن يُجري Zap مكالمات#

يتصل إجراء مكالمة صادرة وبدء الحملة بأرقام هاتف حقيقية ويبدآن مكالمات قابلة للفوترة.

• إذا طلب ThunderPhone من مؤسستك تأكيد أن مكالماتها الصادرة تتبع قانون TCPA وقوانين الاتصال الأخرى، فيجب أن يسجل مسؤول هذا التأكيد في لوحة التحكم قبل أن يتمكن Zap من بدء المكالمات.
• يجب تفعيل رقم ابتداءً من للمكالمات الصادرة. تصبح الأرقام التي تجلبها من شركة الاتصالات الخاصة بك مؤهلة بعد التحقق منها. تبدأ الأرقام التي يوفرها ThunderPhone كمكالمات واردة فقط، ويمكنك طلب وصول للمكالمات الصادرة لها من لوحة التحكم. راجع الحصول على رقم هاتف.
• يتطلب إجراء مكالمة صادرة مفتاح عدم التكرار. عيّن معرّفًا ثابتًا من المُشغّل أو سجل المصدر، مثل معرّف حدث ThunderPhone أو معرّف سجل CRM. إذا أعاد Zapier محاولة الخطوة، يتعرف ThunderPhone على المفتاح ويُرجع المكالمة الأصلية بدلًا من إجراء مكالمة ثانية. تجنب الطوابع الزمنية أو القيم العشوائية أو معرّف Zap وحده.
• يتطلب بدء الحملة الموافقة على الفوترة، التي تؤكد أن Zap يمكنه بدء مكالمات صادرة قابلة للفوترة في حسابك.
• تقع على عاتق مؤسستك مسؤولية الحصول على الموافقة للاتصال بكل رقم واتباع قوانين الاتصال السارية. راجع قوانين الاتصال الصادر.

يكون مفتاح عدم التكرار فريدًا على مستوى مؤسستك ويمكن أن يتكون من 128 حرفًا كحد أقصى. تؤدي إعادة استخدام مفتاح مع وكيل أو رقم أو متغيرات مختلفة إلى الفشل بسبب تعارض، لذا إذا كان بإمكان Zapين الاتصال بشأن السجل نفسه، فأعطِ كل Zap بادئة ثابتة خاصة به قبل معرّف السجل. تغطي إجراء مكالمات صادرة واجهة API وراء هذا الإجراء.

أمثلة على عمليات Zap#

• مكالمة مكتملة إلى نظام CRM. سجّل نشاطًا لكل مكالمة مكتملة مع حالتها وسبب انتهائها والنص المفرغ.
• مكالمة تم تقييمها للمتابعة. صفِّ النتائج حسب مآل المكالمة أو درجتها ووجّه المكالمة إلى سير عمل المتابعة المناسب.
• عميل محتمل جديد إلى حملة. أضف العميل المحتمل إلى حملة مسودة باستخدام إضافة جهات اتصال إلى حملة، ثم شغّل بدء الحملة بعد أن يوافق شخص ما على القائمة.

قد تحتوي النصوص المفرغة للمكالمات وملخصاتها وتسجيلاتها على معلومات شخصية أو صحية. أرسلها فقط إلى التطبيقات المسموح لمؤسستك باستخدامها لهذه البيانات، بموجب اتفاقية BAA عند وجود معلومات صحية، واحتفظ فقط بالحقول التي تحتاج إليها.

استكشاف الأخطاء وإصلاحها#

تفشل خطوة بسبب خطأ في التفويض. أعد ربط اتصال ThunderPhone في Zapier ووافق عليه مجددًا. يتوقف الاتصال عن العمل عندما يلغي الشخص الذي ربطه تفويضه في ThunderPhone ضمن المؤسسة → المفاتيح → التطبيقات المعتمدة، أو عندما يغادر ذلك الشخص المؤسسة، أو عندما تمر 30 يومًا دون تحديث ناجح للرمز المميز. راجع الاتصال باستخدام OAuth.

يفشل تشغيل عملية Zap أو إيقافها، أو يُرفض إجراء. يحتاج الشخص الذي ربط الاتصال إلى دور المسؤول أو المالك في المؤسسة. أعد الربط بحساب يملك هذا الدور. تستمر عملية Zap المشغِّلة التي تم تشغيلها بالفعل في تلقي أحداث المكالمات بعد تغيير الدور أو إلغاء الاتصال. أوقفها لإيقاف ذلك.

تريد قطع اتصال التطبيق. أوقف عمليات Zap الخاصة بـ ThunderPhone قبل إلغاء الاتصال، لأن إيقاف عملية Zap يحذف نقطة نهايتها ويتطلب اتصالًا يعمل. إذا ألغيت الاتصال أولًا، فاحذف نقطة النهاية المتبقية Zapier: … باستخدام DELETE /v1/developer/webhook-endpoints/{id} ومفتاح API للمسؤول. راجع نقاط نهاية Webhook.

يجب أن تستخدم عملية Zap مؤسسة مختلفة. يغطي كل اتصال مؤسسة واحدة. أوقف عملية Zap أولًا لكي تُحذف نقطة نهاية Webhook الخاصة بها من المؤسسة الحالية. ثم اربط حساب ThunderPhone جديدًا في Zapier، واختر المؤسسة الأخرى عند الموافقة، وحدد ذلك الاتصال في كل خطوة من خطوات ThunderPhone. تختلف المساعدات والأرقام والحملات بين المؤسسات، لذا اختر المساعد ورقم الاتصال والحملة مجددًا في كل خطوة تتضمنها. ثم شغّل عملية Zap مجددًا.

توقف المشغِّل عن العمل. تمتلك كل عملية Zap تستخدم مشغِّل ThunderPhone نقطة نهاية Webhook واحدة في مؤسستك، باسم Zapier: مكالمة مكتملة أو Zapier: مكالمة تم تقييمها. تُنشأ عند تشغيل عملية Zap وتُحذف عند إيقافها. اتركها كما هي. إذا عُدّلت أو حُذفت في ThunderPhone، فأوقف عملية Zap ثم شغّلها مجددًا لإنشاء واحدة جديدة. باستخدام مفتاح API للمسؤول، GET /v1/developer/webhook-deliveries يعرض محاولات التسليم الأخيرة.