ايركال

لاستخدام هاتف Aircall في Mavibot، تحتاج إلى إنشاء زوج من مفاتيح API في حساب Aircall الخاص بك وإدخالها في إعدادات التكامل.

Aircall هو نظام هاتف قائم على السحابة لفرق المبيعات والدعم، ويوفر أرقام هواتف في أكثر من 100 دولة. وهو مصمم للشركات التي يستخدم موظفوها بالفعل تطبيق Aircall: يقوم الروبوت بإجراء المكالمات نيابة عن الموظف، وليس من رقم روبوت منفصل.

يمكن للروبوت ربط الموظف بالعميل، واسترداد تسجيلات المكالمات، وإرسال أحداث المكالمات إلى المحادثة.

الحصول على البيانات المطلوبة

1. سجّل في aircall.io، واشترِ رقم هاتف في البلد المطلوب، وأنشئ مستخدمي Aircall لموظفيك.
2. افتح Dashboard ← Settings ← Integrations & API ← API Keys وأنشئ زوجًا من المفاتيح:
   • API ID
   • API Token
3. ابحث عن Number ID للرقم الذي سيُستخدم للمكالمات الصادرة و User IDs لموظفيك. تظهر هذه المعرّفات في شريط العناوين عند فتح الصفحات المقابلة في لوحة تحكم Aircall.

API Token يُعرض مرة واحدة فقط عند إنشائه. إذا فقدته، أنشئ زوجًا جديدًا من مفاتيح API وألغِ المفتاح القديم.

الاتصال

في إعدادات الهاتف، اختر Aircall وأدخل:

• API ID — معرّف مفتاح API.
• API Token — رمز API السري.
• Number ID — المعرّف الرقمي لخط Aircall الذي سيُستخدم للمكالمات الصادرة.

تم الآن ربط التكامل.

لفصل التكامل، امسح حقل API ID واحفظ الإعدادات.

الموظفون

في إعدادات الموظف، املأ حقل Aircall User ID بالمعرّف الرقمي لحساب Aircall الخاص بالموظف.

أدخل معرّف المستخدم، وليس رقم هاتف الموظف. بدون هذا المعرّف، لن يعمل زر الاتصال في بطاقة العميل لهذا الموظف.

الاتصال من بطاقة العميل

سيظهر زر اتصال بجوار رقم هاتف العميل في بطاقة المحادثة.

يبدأ Aircall المكالمة أولاً في تطبيق Aircall الخاص بالموظف — على سطح المكتب أو الجوال. بمجرد أن يرد الموظف، يتصل Aircall بالعميل ويربط الطرفين.

لن تتم المكالمة إذا كان الموظف غير متصل، أو في مكالمة أخرى، أو غير معيّن إلى الرقم المحدد في Aircall. هذا قيد من Aircall: لا يمكن إجراء المكالمات إلا من خلال مستخدم متاح.

وظائف الحاسبة

مكالمة من موظف إلى عميل

aircall_employee_call(client_phone, employee_user_id, number_id)

المعلمات:

• client_phone — رقم هاتف العميل بتنسيق E.164 الدولي. مطلوب.
• employee_user_id — معرّف مستخدم Aircall للموظف الذي سيستلم المكالمة في تطبيق Aircall الخاص به. مطلوب.
• number_id — معرّف رقم Aircall المستخدم لإجراء المكالمة. اختياري. إذا تم حذفه، يُستخدم الرقم المكوّن في إعدادات التكامل.

الحصول على رابط تسجيل المكالمة

aircall_get_record_link(call_id)

يطلب رابطًا جديدًا لتسجيل المكالمة.

المعلمات:

• call_id — معرّف مكالمة Aircall. اختياري. إذا تم حذفه، تُستخدم أحدث مكالمة للعميل.

الاستدعاءات أثناء المكالمة

مع تقدم المكالمة، تُرسل الاستدعاءات إلى المحادثة بالتنسيق التالي:

aircall_call_event call.answered

الأحداث الممكنة:

الحدث	متى يتم تشغيله
call.created	تم إنشاء المكالمة
call.ringing_on_agent	الموظف يستلم المكالمة
call.answered	تم الرد على المكالمة
call.hungup	أحد الطرفين أنهى المكالمة
call.ended	انتهت المكالمة بالكامل
call.voicemail_left	ترك العميل بريدًا صوتيًا

يمكن تشغيل سيناريو نموذجي "لا رد ← إرسال رسالة في المراسل" بواسطة call.ended والتحقق من متغير aircall_missed_reason.

متغيرات العميل بعد المكالمة

بعد المكالمة، تتوفر المتغيرات التالية للعميل:

المتغير	القيمة
aircall_call_id	معرّف مكالمة Aircall
aircall_call_direction	اتجاه المكالمة: inbound أو outbound
aircall_call_status	حالة المكالمة: initial أو answered أو done
aircall_call_duration	مدة المكالمة بالثواني
aircall_missed_reason	سبب عدم اكتمال المكالمة
aircall_record_link	رابط تسجيل المكالمة

تسجيلات المكالمات

يجب تمكين تسجيل المكالمات في إعدادات Aircall الخاصة بك. يتم تخزين التسجيلات في حساب Aircall الخاص بك.

⏳ روابط تسجيلات Aircall متاحة لفترة محدودة — عادةً فقط لعدة ساعات بعد المكالمة. بعد ذلك، تتوقف الروابط عن العمل. هذه هي طريقة عمل Aircall وليست قيدًا من Mavibot.

ماذا يعني هذا:

• في سيناريو يرسل تسجيل مكالمة، استدعِ aircall_get_record_link() في لحظة إرسال التسجيل بدلاً من استخدام رابط محفوظ مسبقًا.
• إذا كنت بحاجة إلى الاحتفاظ بالتسجيل بشكل دائم، احفظ الملف في التخزين الخاص بك مباشرة بعد المكالمة.
• يبقى أرشيف التسجيلات متاحًا في لوحة تحكم Aircall، حيث يمكن تشغيل التسجيلات وتنزيلها لاحقًا.

تسجيل المكالمات منظم بالقانون. في ألمانيا وفرنسا وإسبانيا والعديد من الولايات الأمريكية، قد يكون موافقة الطرفين مطلوبة، وفي بعض الولايات القضائية قد يكون الإشعار اللفظي في بداية المكالمة ضروريًا أيضًا. مالك حساب Aircall مسؤول عن الامتثال للقوانين واللوائح المعمول بها.

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

الخطأ	السبب / الحل
خطأ في التفويض عند إجراء مكالمة	زوج API ID / API Token غير صحيح. يُعرض الرمز مرة واحدة فقط عند إنشائه. إذا فُقد، أنشئ زوجًا جديدًا تحت API Keys وألغِ القديم.
لا يتم إنشاء المكالمة أو لا يستلم الموظف المكالمة	الموظف غير متصل في تطبيق Aircall، أو في مكالمة أخرى، أو غير معيّن إلى الرقم المحدد في إعدادات Aircall.
"Aircall User ID غير محدد"	حقل Aircall User ID في إعدادات الموظف فارغ، أو تم إدخال رقم هاتف بدلاً من معرّف المستخدم الرقمي.
المكالمات تعمل، لكن لا تظهر الاستدعاءات في المحادثة	لم يتم تسجيل webhook. احفظ إعدادات تكامل Aircall مرة أخرى لتسجيله.
رابط التسجيل لا يفتح	انتهت صلاحية الرابط. اطلب رابطًا جديدًا باستخدام aircall_get_record_link() أو افتح التسجيل مباشرة في لوحة تحكم Aircall.