ملاحظات المستخدمين

التثبيت Blipit.showFeedback() or one POST

بعد خطأ، اسأل المستخدم عما كان يفعله. يفتح SDK المتصفح مربع حوار أصليًا صغيرًا؛ ويرسل أي عميل آخر إلى نقطة نهاية الملاحظات. تُربط الملاحظات بمشكلة الحدث وتُعرض في صفحة المشكلة وفي صفحة الملاحظات.

الصقها في Claude Code أو Cursor أو أي مساعد برمجة بالذكاء الاصطناعي. تحتوي على الخطوات والشيفرة. في app.blipit.io ضمن مفاتيح API تجد التعليمات نفسها مع مفتاحك مكتوباً فيها.

1مربع حوار المتصفح

يفتح نموذجًا موسومًا (الاسم والبريد الإلكتروني والرسالة) يرتبط افتراضيًا بآخر حدث ملتقط. يغلقه Escape، ويعرض تسمية انشغال أثناء الإرسال.

js
window.addEventListener("error", () => {
  Blipit.showFeedback({ title: "Something went wrong. What were you doing?" });
});

2API مباشرة

sh
curl https://in.blipit.io/api/v1/feedback \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
  -d '{"message":"The pay button did nothing","email":"ana@example.com","event_id":"9f1c4b6d8e2a47f0b3c5d7e9a1b2c3d4","url":"https://shop.example.com/checkout"}'

3أبقِ المُبلِّغ على اطلاع

يحصل كل بلاغ على رقم مرجعي لكل مشروع (BR-1 وBR-2 وهكذا) تعرضه الأداة بعد الإرسال. عندما يترك المُبلِّغ بريده، يرسل Blipit إيصالًا بلغته مع رابط لمتابعة البلاغ. في صفحة البلاغ، يُرسل «الرد على المُبلِّغ» رسالتك بالبريد بينما تبقى «الملاحظة الداخلية» داخل فريقك، ونقل البلاغ إلى «قيد العمل» أو «تم» أو «لن يتم الإصلاح» يقترح بريدًا يمكنك تعديله أو تخطيه. اختر الإيصالات والحالات واسم المُرسِل وعنوان الرد من إعدادات المشروع، أداة بلاغات الأخطاء. كل رسالة فيها رابط إلغاء اشتراك بنقرة واحدة، ولا يتلقى أي عنوان أكثر من 10 رسائل في الساعة، ولا يتلقى المُبلِّغون بلا بريد أي رسالة. يرى مستخدمو Odoo بلاغاتهم في Blipit، بلاغاتي. في الملاحظة الداخلية، اكتب @ للإشارة إلى زميل يمكنه فتح البلاغ: يصله بريد بالملاحظة ويظهر البلاغ له كغير مقروء. لا تصل الإشارات إلى المُبلِّغ أبدًا.

4مشاركة بلاغ مع أشخاص من خارج مساحة العمل

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

5مكتب الخدمة

تعمل بلاغات الأخطاء كمكتب خدمة: يعلم المُبلِّغون بكل خطوة مع رقمهم المرجعي، ويحصل فريقك على أهداف وتنبيهات وتقرير عن أدائه. أعدّه من بلاغات الأخطاء، إعدادات مكتب الخدمة.

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

من المفيد معرفته

  • الحقول: message من 1 إلى 5,000 حرف (مطلوب)، وname حتى 128، وemail صالح، وevent_id من 32 حرف hex، وعنوان صفحة يُحفظ بدون سلسلة الاستعلام.
  • تعرض صفحة الملاحظات كل شيء الأحدث أولًا. يُعرض النص دائمًا كنص، ولا يُعرض أبدًا كـ HTML أو روابط.
  • الحد: 60 رسالة ملاحظات في الدقيقة لكل مفتاح.
  • يعرض عنصر «تقارير الأخطاء» في الشريط الجانبي للوحة التحكم عدد البلاغات الجديدة بالنسبة إليك، ويعرضه تبويب المتصفح أيضًا، مثل (3) Blipit. يتوقف احتساب البلاغ بمجرد فتحه أو خروجه من حالة «جديد»، ويمسح زر «تعليم الكل كمقروء» في صفحة تقارير الأخطاء العدد.
  • يفتح رابط «تابع هذا البلاغ» في كل رسالة صفحة خاصة بلغة المُبلِّغ فيها الرقم المرجعي وسجل الحالة وردودك ولقطة الشاشة التي أرسلها. يمكنه هناك إضافة رسالة وصورة واحدة (PNG أو JPEG أو WebP حتى 3 ميغابايت، و5 صور كحد أقصى لكل بلاغ و10 رسائل في اليوم). تظهر رسالته في نشاط البلاغ بعلامة «من المُبلِّغ» ويُبلَّغ بها المسؤول عن البلاغ، أو من يتلقون رسائل بلاغات الأخطاء وSlack وTeams وwebhooks (النوع bug_report.reply). لا تفهرس محركات البحث الصفحة، ولا تفتح إلا البلاغ الذي أُنشئ رابطها له. قبل عرض أي شيء، ترسل الصفحة رمزًا من 6 أرقام إلى بريد المُبلِّغ (صالح 10 دقائق، و5 محاولات)؛ وبعد إدخاله يستطيع ذلك المتصفح فتح البلاغ لمدة 7 أيام ويختفي الرابط من شريط العنوان. البلاغات المرسلة بدون بريد إلكتروني لا يمكن متابعتها إلا في التطبيق الذي أُرسلت منه. في Odoo يتابع المُبلِّغون بلاغاتهم ويردّون عليها في محادثة البلاغ ضمن Blipit، بلاغاتي.
  • يمكن للمُبلِّغين أيضًا الرد ببساطة على أي من هذه الرسائل. يذهب الرد إلى عنوان مخصص لذلك البلاغ، ويحذف Blipit الرسائل السابقة المقتبسة والتواقيع، ويتجاهل الردود التلقائية مثل «خارج المكتب» والرسائل من أي عنوان غير عنوان المُبلِّغ، ويضيف الباقي إلى البلاغ كرسالة من المُبلِّغ، مع الإشعارات نفسها والحد نفسه البالغ 10 رسائل في اليوم.
  • يقبل «الرد على المُبلِّغ» و«ملاحظة داخلية» المرفقات: انقر «إرفاق» أو أفلت الملفات في المربع أو الصق صورة. الصور (PNG وJPEG وWebP) وملفات PDF حتى 3 ميغابايت، ومقاطع الفيديو WebM أو MP4 حتى 60 ميغابايت، بحد أقصى 10 ملفات لكل رسالة و30 لكل بلاغ، مع تقدّم الرفع وزر لإزالة كل ملف. تظهر ملفات الرد على المُبلِّغ في صفحة المتابعة الخاصة به، وكصور مصغّرة وروابط في رسالة الرد، وفي Odoo؛ أما ملفات الملاحظة الداخلية فلا تغادر فريقك أبدًا.
  • في Odoo، يفتح Blipit ثم «بلاغاتي» كل بلاغ في شاشة واحدة: الحالة، ووقت الإبلاغ وآخر تحديث، وآخر رد من فريقك مع ملفاته، وما أبلغ عنه المستخدم (الوصف والصفحة والمتصفح والنظام)، ومعرضًا يضم لقطات الشاشة وتسجيلات الشاشة وإعادة الجلسة بجانب كل ملف أرسله فريقك. يُفتح كل شيء بملء الشاشة مع مفاتيح الأسهم والسحب والتكبير والتنزيل، وتبقى المحادثة في الدردشة بجانبه. تنتهي روابط الملفات بعد 15 دقيقة ورابط الإعادة بعد 10، ولا يفتح كل رابط إلا ملف ذلك البلاغ لذلك المستخدم.

هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.