نموذج طلب معاودة الاتصال لموقعك

ما الذي ستنجزه

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

لا يُجري الزر ولا النموذج أي مكالمة بنفسيهما. كل شيء يحدث على خادم Phynxa: الصفحة ترسل فقط ما كتبه الزائر.

المتطلبات

• وكيل يستطيع إجراء مكالمات صادرة (اتجاه المكالمات فيه Outbound أو Both). لا يصلح وكيل يستقبل المكالمات فقط. يُضبط الاتجاه من تبويب Assistant في الوكيل.
• أن يكون الوكيل منشوراً.
• رقم للاتصال منه ومزوّد هاتف متصل (Twilio أو Exotel)، كما في أي مكالمة صادرة. راجع المكالمات الصادرة.
• رصيد في مساحة عملك، أو دقائق مجانية متبقية في خطة Free. راجع كيف يؤثر على رصيدك أدناه.
• موقع يمكنك إضافة سطر من الشيفرة إليه، ويعمل عبر https.

إذا نقص أحد هذه الأمور، تذكر بطاقة Website form بالضبط ما يجب إصلاحه ولا يمكن تشغيل النموذج. لا يُعرض على الزائر أي إعداد أبداً، بل فقط "This form cannot take callback requests right now".

أنشئ نموذجاً

1. افتح الوكيل واختر تبويب Website.
2. اختر بطاقة Website Form. (بطاقة Voice Widget بجانبها هي زر الصوت للموقع وتعمل كما كانت. اضغط تبويب Website مرة أخرى في أي وقت للعودة إلى البطاقتين.)
3. في تبويب Configuration وتحت Add a website اكتب عنوان موقعك (مثلاً example.com) ثم اضغط Enter أو Add.
4. شغّل Enable Website Form.
5. انتظر ظهور Form settings saved أعلى يمين Live Preview.

الإعدادات في تبويبات، وبجانبها Live Preview: Configuration (الوكيل وتوقيت المكالمة والحد اليومي والمواقع المسموح بها والحقول)، وAppearance (السمة والألوان وموضع الزر ونصه)، وContent (النصوص)، وEmbed Code (الكود، وتحته Installation الذي يبيّن هل ظهر النموذج على موقعك) وCallbacks. لا يوجد زر حفظ. يُحفظ كل تغيير تلقائياً بعد لحظة من توقفك عن الكتابة، وبمجرد حفظه والمفتاح مفعّل يصبح النموذج متاحاً للزوار فوراً. إذا تعذّر الحفظ بعد، يظهر إشعار قابل للإغلاق أعلى الإعدادات يذكر السبب. وتعرض الزاوية Saving مع نقاط متحركة ثم Form settings saved.

يستطيع أعضاء مساحة عملك رؤية التبويب، لكن المالك أو المشرف فقط يستطيع تغييره.

اختر الوكيل

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

إذا غيّرت الوكيل لاحقاً إلى وكيل للمكالمات الواردة فقط، أو أوقفته، أو حذفته، أو أزلت مزوّد هاتفه، يتوقف النموذج عن قبول الطلبات وتذكر البطاقة السبب.

اختر الحقول

يطلب النموذج دائماً:

• البلد، بأسماء وأعلام ورموز اتصال.
• رقم الهاتف، يُكتب بدون رمز البلد. يتحقق Phynxa منه مقابل البلد المختار ويحفظه بالصيغة الدولية (مثل +447700900123).
• الموافقة على تلقي المكالمة. يجب أن يضع الزائر علامتها.

يمكنك إظهار الحقول الأخرى وإخفاءها وجعلها إلزامية: First name (إلزامي افتراضياً) وLast name وWhat are you interested in? وAdditional details. الحقل المخفي لا يُطلب ولا يُحفظ. لحقل الاهتمام يمكنك إضافة قائمة خيارات؛ وبدون خيارات يكتب الزائر إجابة قصيرة.

تحت Visitors can ask for a call اختر هل يستطيع الزوار اختيار الآن أو وقت محدد، أم في أقرب وقت فقط، أم وقت محدد فقط.

لا يطلب النموذج شيئاً غير ذلك. لا بريد إلكتروني ولا أي بيانات شخصية أخرى.

اختر مظهره

• Button position: الزاوية السفلية اليمنى أو اليسرى، وFloating button label (الافتراضي Request a Callback؛ وإذا أفرغته يصبح الزر دائرياً يعرض أيقونة الهاتف فقط). يأخذ الزر لون الزر الذي تختاره أدناه.
• Theme: فاتح أو داكن.
• ألوان الخلفية والنص والأساسي والزر. يحفظ Phynxa الألوان التي تختارها كما هي، فراجع المعاينة للتأكد من أن النص مقروء. ويختار نص الزر الأسود أو الأبيض تلقائياً.
• الخط: يستخدم النموذج نفس خط النظام الواضح الذي تستخدمه أداة الصوت، أياً كان خط موقعك. لا شيء تضبطه.
• Form title وShort description وSend button label (الافتراضي Request My AI Callback، وهو زر النموذج الذي يرسله) وThank-you message.
• Consent line: العبارة التي يوافق عليها الزائر. يُحفظ النص الدقيق المعروض مع كل طلب.
• Brand name وLogo address (اختياريان، صورة بعنوان https).

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

اللغة. كلمات النموذج نفسه (أسماء الحقول والنصوص المساعدة وجدولة الاتصال ورسائل الخطأ وجمل التأكيد) بالإنجليزية أو الإسبانية أو العربية، وهي لغة الوكيل الذي يُجري المكالمات. تُعرض العربية من اليمين إلى اليسار، مع زر الإغلاق في الزاوية العلوية اليسرى. ولفرض لغة معيّنة في صفحة، أضف data-lang="ar" (أو en أو es) إلى الشيفرة. أما العنوان والوصف والزر وعبارة الموافقة ورسالة الشكر فهي من كلماتك أنت وتُعرض دائماً كما كتبتها؛ وإذا تركت أحدها بنصه الإنجليزي الأصلي فسيُعرض بلغة النموذج. وتستخدم المعاينة لغة الوكيل أيضاً. اكتبها بلغة زوارك.

اختر المواقع المسموح بها

يظهر النموذج فقط في المواقع التي تدرجها، بنفس قواعد ودجت الصوت:

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

للاختبار على حاسوبك، يستطيع من يدير خادم Phynxa لديك السماح بـ localhost (راجع لمن يدير الخادم). وهو معطّل افتراضياً.

ثبّت النموذج في موقعك

التثبيت يعني لصق مقطع قصير من الشيفرة في موقعك. يُرسم الزر في زاوية النافذة، فلا يهم أين تقع الشيفرة في الصفحة: ضعها في كل صفحة تريد ظهور الزر فيها.

الخطوة 1. احصل على الشيفرة

افتح تبويب Embed Code واضغط Copy. تبدو الشيفرة هكذا، مع معرّف النموذج الخاص بك. تحتوي فقط على معرّف النموذج العام: لا مفاتيح ولا كلمات مرور ولا رموز، ولا يتيح المعرّف وحده إجراء أي مكالمة.

<script
  src="https://your-phynxa-address/form.js"
  data-form-id="frm_..."
  async
></script>

الخطوة 2. الصقها في صفحاتك

أفضل مكان هو قبل وسم الإغلاق </body> مباشرة، أو في تذييل أو قالب تشترك فيه كل الصفحات، ليظهر الزر في جميعها. وإذا وقع الزر حيث يوجد إشعار ملفات تعريف الارتباط أو شريط دردشة فأضف data-offset-x="80" وdata-offset-y="80" (مسافة من الزاوية بالبكسل، من 0 إلى 200) إلى الشيفرة، وdata-z-index="..." إذا غطّى شيء في صفحتك الزر. ويحدّد data-lang="en" أو "es" أو "ar" لغة النموذج (راجع اختر مظهره).

• HTML عادي: الصقها في ملف الصفحة فوق </body> مباشرة وارفع الملف.
• WordPress: استخدم إضافة شيفرة مثل WPCode والصق الشيفرة في خانة Footer فيها، أو أضف كتلة HTML مخصص إلى صفحة.
• Next.js وReact: أضف Script (أو مكوّناً صغيراً يضيف وسم script) مرة واحدة في القالب العام. أبقِ السمة data-form-id. يوفّر تبويب Embed Code نسخاً جاهزة للنسخ بصيغ HTML وReact وNext.js: اختر ما يناسبك فوق الكود.
• Shopify وWix وSquarespace وWebflow: استخدم إعداد الشيفرة المخصصة أو شيفرة التذييل في المنشئ والصق الشيفرة.
• Google Tag Manager: يصلح وسم Custom HTML على All Pages.

تتغير أسماء القوائم من وقت لآخر. ابحث عن الكلمات نفسها قريباً منها.

يُرسم الزر والنافذة داخل حاوية معزولة، بالطريقة نفسها التي يعمل بها ودجت الصوت، فلا تستطيع أنماط موقعك إفسادهما ولا يضيفان أنماطاً إلى صفحتك. تحميل الشيفرة مرتين، أو لصقها مرتين لنموذج واحد، يُظهر زراً واحداً. أما نموذجان مختلفان في صفحة واحدة فيُظهران زرين، فأعطِ أحدهما إزاحة. ويوضع زر أداة الصوت على الجانب نفسه فوق زر النموذج تلقائياً: راجع مع أداة الصوت.

الخطوة 3. انشر وتحقق

انشر موقعك، وامسح أي ذاكرة تخزين مؤقت، وافتح الصفحة على أحد المواقع التي أدرجتها. في تبويب Embed Code، ضمن لوحة Installation أسفل الكود، يتحول Not seen yet إلى Installed مع عنوان الموقع. اضغط Check again إن لم يتغير. نسخ الشيفرة لا يُحتسب: لا يتغير إلا بعد أن يحمّل متصفح زائر صفحتك وفيها الشيفرة.

إذا كان لموقعك Content Security Policy، فاسمح بعنوان Phynxa للسكربتات (script-src) والاتصالات (connect-src)، وبصور https إن استخدمت شعاراً (img-src).

ماذا يرى الزائر وماذا يحدث بعد ذلك

1. يضغط الزائر على الزر العائم. يُفتح النموذج في نافذة في منتصف الصفحة مع تعتيم الصفحة خلفه. يملؤه ويضع علامة الموافقة. تظهر الأخطاء بجانب الحقل.
2. إن سمحت بذلك يختار As soon as possible أو Schedule a call. للمكالمة المجدولة يختار تاريخاً (خلال 30 يوماً القادمة) ووقتاً. يعرض النموذج منطقته الزمنية المأخوذة من جهازه ويكرر اختياره بالكلمات ("We will call you on ...").
3. يرسل الضغط على الزر الطلب. الضغط مرة ثانية أثناء الإرسال، أو إرسال النموذج نفسه مرتين بعد انقطاع الاتصال، هو طلب واحد.
4. يرى رسالة الشكر داخل النافذة، وفي المكالمة المجدولة يرى التاريخ والوقت المؤكدين بمنطقته الزمنية. وعند إغلاق النافذة بعد ذلك يُفتح في المرة التالية نموذج جديد.

تُغلق النافذة بزر × فيها، أو بالضغط على المنطقة المعتمة حولها، أو بمفتاح Escape. ويُحتفظ بما كتبه الزائر إذا أغلقها دون إرسال ثم فتحها مجدداً. وعلى الهاتف تناسب الشاشة، وعندما يكون النموذج أطول من النافذة يتمرر داخلها مع بقاء زر الإغلاق ظاهراً.

إذا كان للرقم نفسه طلب منتظر في هذا النموذج فلا يُنشأ طلب جديد ويُخبَر الزائر بوجود طلب.

المكالمات الفورية

يُحفظ الطلب الفوري وتُوقَظ فوراً العملية التي تُجري المكالمات المجدولة، فتنطلق المكالمة عادةً خلال ثوانٍ. وإذا كان خادم آخر لديك هو من يمسك بها فتنطلق خلال نصف دقيقة. وتعتمد قدرتها على الانطلاق أيضاً على رصيدك وحدود خطتك للمكالمات المتزامنة.

المكالمات المجدولة والمناطق الزمنية

يُحوَّل وقت الزائر ومنطقته الزمنية إلى لحظة دقيقة (UTC) على الخادم ويُحفظان مع اسم المنطقة. يرفض الخادم وقتاً في الماضي، أو أقل من 10 دقائق من الآن، أو بعد أكثر من 30 يوماً، أو وقتاً غير موجود في تلك المنطقة (الساعة التي تُتخطى عند تغيير التوقيت). لا تُجرى المكالمة قبل تلك اللحظة. وإذا كان الخادم متوقفاً عندها تنطلق المكالمة عند عودته، بتأخير يصل إلى ساعتين. بعد ذلك يُعلَّم الطلب Failed مع السبب not placed in time بدلاً من الاتصال في ساعة لم يطلبها أحد. ويمكنك عندها استخدام Retry.

ليس لدى Phynxa ساعات اتصال لمساحة العمل كلها، فيستطيع الزائر اختيار أي وقت. إذا كانت بعض الساعات غير مناسبة فألغِ تلك الطلبات أو أعد جدولتها من تبويب Callbacks.

الموافقة ومعلومات الزائر

• يجب أن يضع الزائر علامة الموافقة. الإرسال بدونها يرفضه الخادم مهما أرسلت الصفحة.
• يحفظ كل طلب وقت موافقته والنص الدقيق الذي وافق عليه، لتتمكن من إثبات ما وافق عليه.
• يحفظ Phynxa ما كتبه الزائر (الاسم والبلد والهاتف والاهتمام والتفاصيل) واختيار التوقيت والموقع الذي جاء منه الطلب وحالة المكالمة. ولا يحفظ عنوانه (IP) ولا بريده الإلكتروني ولا بيانات جهازه.
• يُعامل كل ما يُكتب كنص عادي. ويُقال للوكيل إنه معلومات عن الشخص وليس تعليمات، فلا يستطيع الزائر تغيير سلوك الوكيل بما يكتبه.
• يرى عضو مساحة العمل الطلب مع إخفاء جزء من رقم الهاتف. ويرى المالكون والمشرفون الرقم كاملاً.
• حذف الوكيل يحذف نموذجه وطلباته، وحذف حسابك يحذفها جميعاً.
• الرقم الموجود في قائمة عدم الاتصال لديك (جهة اتصال في Contacts بحالة blocked) لا يُتصل به أبداً.

أنت المسؤول عن وجود أساس قانوني للاتصال بالناس، وعن مضمون عبارة الموافقة، وعن القواعد المتعلقة بالمكالمات الآلية حيث يعيش زوارك. يحفظ Phynxa الموافقة ولا يقرر ما يجب أن تطلبه.

الوكيل أثناء المكالمة

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

تظهر المكالمة في History كمكالمة صادرة بعلامة Website form، مع نصها وملخصها وتكلفتها كأي مكالمة أخرى.

أدِر معاودات الاتصال

افتح تبويب Callbacks في لوحة النموذج. اختر This agent أو All agents وصفِّ حسب الحالة. يعرض كل صف الزائر والهاتف والاهتمام ووقت المكالمة ومنطقتها والحالة والنتيجة. اختر صفاً لرؤية التفاصيل كاملة، بما كتبه الزائر ورابط إلى سجل المكالمة.

بصفتك مالكاً أو مشرفاً يمكنك:

• إلغاء معاودة اتصال حالتها Pending أو Scheduled. لن يُتصل بها بعد ذلك أبداً.
• إعادة جدولة Pending أو Scheduled إلى تاريخ ووقت آخر. إنه الطلب نفسه، فلا تكون هناك مكالمة ثانية أبداً.
• إعادة المحاولة لطلب Failed. يعود إلى Pending ويُتصل به في أقرب وقت. تُرفض إذا كان الوكيل لا يستطيع الاتصال الآن أو كان للرقم نفسه طلب آخر منتظر.

لا يمكن إلغاء Processing أو Calling ولا نقلهما: فهما على الهاتف.

إذا لم يُجب الزائر، يحاول Phynxa مرة أخرى بعد نحو 30 دقيقة، ثم يعلّمها Failed (not answered). وإذا تعذّر الوصول إلى مزوّد الهاتف يحاول مرة أخرى لاحقاً أيضاً. أما الإخفاقات الأخرى فلا تُعاد تلقائياً. تُجرى كل محاولة مرة واحدة مهما أُعيد تشغيل الخادم: إذا توقف الخادم لحظة إجراء مكالمة يُعلَّم الطلب Failed (not retried, to avoid calling twice) وتقرر أنت هل تستخدم Retry.

إيقاف النموذج يوقف الطلبات الجديدة لكنه لا يلغي الطلبات المقبولة سابقاً. ألغِها من تبويب Callbacks إن لم تُرد الاتصال بها.

كيف يؤثر على رصيدك

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

• قبل قبول طلب الزائر يتحقق Phynxa من أن مساحة العمل تستطيع استقبال المكالمات. وإلا يرى الزائر "This form cannot take callback requests right now" ولا يُحفظ شيء.
• قبل كل مكالمة يُحجز رصيد لمرحلتها الأولى، كما في أي مكالمة صادرة. وعند انتهاء المكالمة تُحاسَب بالتكلفة الحقيقية ويُفرج عن الباقي. وإذا لم يُجب أحد يُفرج عن الرصيد ولا يُحاسَب شيء. ولا تُحاسَب المكالمة إلا مرة واحدة.
• إذا نفد رصيدك عند موعد المكالمة، يُعلَّم الطلب Failed (not enough credit). أضف رصيداً واضغط Retry.
• في خطة Free تُحتسب المكالمة ضمن الدقائق الفعلية.
• يُطبَّق حد خطتك للمكالمات المتزامنة. ويبقى الطلب Pending بينما تكون كل المكالمات التي تسمح بها خطتك مفتوحة (بما فيها مكالمات الصوت من أداة الموقع)، ثم يُتصل به بمجرد انتهاء إحداها.

يُحسب كل ذلك على الخادم. لا شيء يرسله المتصفح يستطيع تغيير سعر أو تجاوز فحص.

الحماية من إساءة الاستخدام

عدة طبقات تمنع سكربتاً من استنزاف رصيدك، لأن الموقع ليس الدفاع الوحيد:

• تطلب الصفحة رمزاً قصير العمر عند تحميلها، ويُرفض أي إرسال بدون رمز صالح. ولا يستطيع شخص ملء النموذج في أقل من ثلاث ثوانٍ.
• حقل مخفي لا يراه الناس يوقع السكربتات التي تملأ كل الحقول.
• يمكن لكل اتصال إنترنت (عنوان) أن يُقبل له طلبان فقط في الساعة لدى نموذج واحد، ولكل رقم هاتف ثلاثة طلبات في اليوم؛ ويقبل النموذج 60 في الساعة كحد أقصى ومساحة العمل 300، ولا يقبل النموذج أكثر من الحد اليومي الذي تحدده. لا يُحتسب إلا الطلب الذي يُحفظ فعلاً: فخطأ الكتابة أو إعادة إرسال طلب أُرسل سابقاً أو الرفض لسبب آخر لا يستهلك مكاناً. ويُقال للزائر الذي تجاوز الحد أن يعاود المحاولة بعد نحو ساعة. وإذا كان خادمك خلف أكثر من وسيط (مثل شبكة CDN أمام Caddy) فاضبط TRUST_PROXY_HOPS ليرى الحد عنوان الزائر نفسه، وإلا شاركه جميع الزوار عنواناً واحداً.
• يستطيع الرقم طلب معاودة اتصال ثلاث مرات كحد أقصى كل 24 ساعة.
• لكل نموذج Daily limit (الافتراضي 200 طلب كل 24 ساعة، في تبويب Configuration).
• يقرر الخادم الوكيل ومساحة العمل والحالة. ولا يستطيع المتصفح اختيارها.

مع أداة الصوت

يمكن أن يكون النموذج وأداة الصوت على الموقع نفسه معاً، لكل منهما مفتاحه وإعداداته ومواقعه المسموح بها. وإذا كان الزران على الجانب نفسه من النافذة فإنهما يترتبان فوق بعضهما بدل أن يتراكبا؛ أضف data-stack="off" إلى شيفرة سكربت إذا وضعت الزر بنفسك. فتح النموذج لا يغلق لوحة الصوت ولا ينهي مكالمة، وتنتظر معاودة الاتصال بحالة Pending ما دامت مكالمات خطتك كلها قيد الاستخدام. التفاصيل الكاملة في استخدامها مع نموذج معاودة الاتصال ضمن دليل أداة الصوت.

استكشاف الأخطاء

الزر لا يظهر. تحقق بالترتيب: المفتاح مفعّل ويظهر Form settings saved؛ وعنوان الصفحة موجود في Allowed websites تماماً (www. يُحتسب؛ وhttp لا)؛ والشيفرة موجودة في الصفحة (ابحث عن form.js في مصدر الصفحة)؛ وContent Security Policy لا تحجبها. وإذا كان الوكيل لا يستطيع إجراء مكالمة الآن (موقوف أو للواردة فقط أو بلا رقم أو مزوّد) يظهر الزر مع ذلك، لكن إرسال النموذج يعرض "cannot take callback requests right now" ولا يُحفظ شيء.

"Not seen yet" بعد التثبيت. تأكد أنك نشرت موقعك، وافتح صفحة من موقع مسموح فيها الشيفرة، ثم اضغط Check again.

يرى الزائر "cannot take callback requests right now". الوكيل لا يستطيع إجراء مكالمة (موقوف أو للواردة فقط أو بلا رقم أو مزوّد) أو لا رصيد في مساحة العمل. وتذكر بطاقة Website form في لوحة التحكم أيهما.

طلب Failed. افتحه: يظهر السبب. Not enough credit: أضف رصيداً وRetry. The agent was deleted, paused or can no longer make outbound calls: أصلح الوكيل وRetry. On your do-not-call list: الرقم محظور في Contacts. Not answered: لم يرد الشخص بعد محاولتين. Not placed in time: لم يستطع الخادم الاتصال خلال ساعتين من الوقت المختار. وتُعرض رسالة المزوّد كما وصلت.

طلب Failed يقول إن Twilio لم تؤكد المكالمة. لم يردّ مزوّد الهاتف في الوقت المناسب، فلا تستطيع Phynxa معرفة هل خرجت المكالمة. لا يُعاد المحاولة تلقائياً، حتى لا يُتصل بالشخص مرتين. راجع سجل مكالمات مزوّدك لذلك الرقم: إذا لم تُجرَ أي مكالمة فاضغط Retry.

طلب يبقى Calling طويلاً. المكالمة التي تم الاتصال بها ولم تتصل أبداً تنتقل إلى Failed (not answered) بعد بضع دقائق.

يقول زائر إنه لم يتلق مكالمة. ابحث عن طلبه في Callbacks: حالته وسببه يخبرانك بما حدث. وإذا قالت Completed فقد أُجيبت المكالمة ولها سجل في History.

لمن يدير الخادم

• لا خدمة ولا طابور ولا عامل جديد. تُجري معاودات الاتصال عملية المكالمات المجدولة التي تعمل أصلاً داخل الخادم الخلفي (كل 30 ثانية، وفوراً للطلب الفوري). ومع عدة نسخ، لا تُجري المكالمات إلا النسخة التي تمسك القفل، كما كان.
• ترحيلان إضافيان، 0012_website_forms (جدولان جديدان وعمود جديد في calls) و0013_form_popup_button (عمودان جديدان في جدول النماذج: زاوية الزر ونصه). لا يتغير أي شيء موجود، فالرجوع إلى الإصدار السابق آمن.
• لا متغيرات بيئة جديدة. تنطبق الموجودة: PUBLIC_URL (العنوان الذي يستدعيه مزوّد الهاتف)، وWIDGET_ALLOW_LOCALHOST=1 (للتطوير فقط، يسمح لنموذج بإدراج localhost)، وSERVER_SECRET (نفسه في كل النسخ لتُتحقق الرموز في كلها)، وREDIS_URL (عند تشغيل أكثر من نسخة لتُشارك الحدود)، وTRUST_PROXY=1 خلف وكيل، لتحسب الحدود كل زائر وليس الوكيل.
• يخدم الواجهة الأمامية الملف form.js بذاكرة تخزين مؤقت قصيرة ووصول مفتوح عبر الأصول، مثل سكربتات الودجت. ويستدعي متصفح الزائر /api/form/... على العنوان نفسه؛ وإعداد الوكيل يمرر /api/* أصلاً.
• تُجرى المكالمات عبر Twilio أو Exotel تماماً كالمكالمات الصادرة الأخرى. ولا تُستخدم مزودات أخرى للمكالمات الصادرة، فلا يستطيع النموذج استخدامها.

حدود معروفة

• لم يُجرِ Phynxa مكالمة حقيقية عبر هذا النموذج في الاختبار: في الاختبارات الآلية يُستبدل مزوّد الاتصال ببديل. أرسل أنت طلباً تجريبياً قبل الاعتماد عليه (راجع الخطوات أدناه).
• كلمات النموذج الثابتة متوفرة بالإنجليزية والإسبانية والعربية فقط. والوكيل الذي يتحدث لغة أخرى يعرض النموذج بالإنجليزية ما لم تضبط data-lang.
• يتأكد فحص الهاتف من أن الرقم يبدو صحيحاً للبلد ويحفظه بالصيغة الدولية؛ ولا يستطيع معرفة هل رقم سليم الشكل يخص أحداً.
• لا توجد ساعات اتصال. يستطيع الزائر اختيار أي وقت خلال 30 يوماً.
• لم يُفحص الزر والنافذة في كل المتصفحات ومنشئي المواقع والهواتف.
• لم يراجع الترجمة العربية ناطق أصلي.

جرّبه من البداية إلى النهاية

1. افتح وكيلاً للمكالمات الصادرة، واختر Website ثم Website Form، وأضف موقعك وشغّل النموذج.
2. الصق الشيفرة في صفحة تجريبية على ذلك الموقع وافتحها. انتظر Installed.
3. اضغط الزر العائم، واملأ النموذج برقمك أنت، وضع علامة الموافقة، واختر As soon as possible وأرسله.
4. افتح تبويب Callbacks: ينتقل الطلب من Pending إلى Calling. يرن هاتفك ويقول الوكيل إنه يعاود الاتصال بناءً على طلبك.
5. بعد المكالمة يصبح الطلب Completed وتظهر المكالمة في History بعلامة Website form.
6. كرر مع Schedule a call بعد بضع دقائق للتحقق من الوقت والمنطقة.