استقبال رموز SMS من Truecaller برمجيًا

كيف تبدو سلسلة استدعاءات API لـ Truecaller؟

معرّف خدمة Truecaller هو truecaller، وكل استدعاء أدناه يُنفَّذ على https://otproute.com/api/v1 بمفتاح Bearer بادئته or_live_.

1. يعطيك GET /api/v1/countries معرّفات الدول؛ خزّنها مؤقتًا.
2. يعيد GET /api/v1/prices?country=<id>&service=truecaller السعر الحي وما إذا كان هناك مسار مفتوح الآن.
3. يحجز POST /api/v1/activations مع {"service": "truecaller", "country": "in"} (أو أي معرّف دولة آخر) الرقم ويعيد معرّف التفعيل.
4. أدخل ذلك الرقم في تطبيق Truecaller على جهاز الاختبار واطلب التحقق.
5. يصل الرمز كحدث webhook من النوع activation.sms_received، أو تستعلم دوريًا عن GET /api/v1/activations/{id}.
6. إذا أُلغي الاختبار، فإن POST /api/v1/activations/{id}/cancel يرد المبلغ فورًا.

يدعم الحساب 10 مفاتيح API و5 نقاط نهاية webhook و300 طلب في الدقيقة. يغطي دليل تكامل API إعادة المحاولة ومهل الانتظار.

كيف ينبغي أن يتعامل معالج webhook مع أحداث Truecaller؟

يحمل كل تسليم الترويسة X-OTPRoute-Signature: t=<unix>,v1=<hex>. أعد حساب HMAC-SHA256 على الطابع الزمني ثم نقطة ثم جسم الطلب الخام بسر نقطة النهاية، وقارن بمقارنة زمنها ثابت، وارفض الطوابع الزمنية القديمة جدًا.

اربط كل المعالجة بمعرّف التفعيل. يمكن إعادة محاولة webhook، لذا فالمعالج الذي يخزّن الرمز مرتين أو يقدّم الاختبار خطوتين سينتج نتائج غير مستقرة؛ تحقق مما إذا كان التفعيل مُعلَّمًا بأنه مكتمل قبل التصرف. وعامل activation.expired وactivation.cancelled كحالتين نهائيتين تخبران مشغّل الاختبار بالتوقف عن الانتظار. ويصلح الاستعلام الدوري كخيار احتياطي للتطوير المحلي حيث لا توجد نقطة نهاية عامة.

لماذا تطلب Truecaller رقم هاتف أصلًا؟

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

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

أي الدول تحمل مسارات Truecaller؟

تُدرج اللقطة الحية مسارات Truecaller في 198 دولة، منها الهند وباكستان وبنغلاديش ونيجيريا وكينيا ومصر وإندونيسيا وسريلانكا ونيبال والسعودية والإمارات العربية المتحدة والبرازيل والمكسيك وجنوب أفريقيا والمملكة المتحدة والولايات المتحدة.

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

هل يستطيع غير المطورين فعل ذلك من لوحة التحكم؟

نعم. سجّل الدخول، وافتح OTP Gateway، واختر Truecaller ودولة، وأكّد السعر المعروض، فيظهر الرقم على بطاقة التفعيل. أدخله في Truecaller، واطلب الرمز، فيظهر على البطاقة نفسها عند وصول الرسالة. نافذة الـ 20 دقيقة ظاهرة على البطاقة. وإذا لم يصل رمز، أو ألغيت، يعود المبلغ كاملًا إلى محفظتك تلقائيًا. يمكن شحن المحفظة بالبطاقة أو بـ USDT/USDC، مع فاتورة PDF بالبريد لكل عملية؛ راجع الأسعار.

لماذا قد يفشل وصول رمز Truecaller؟

أسباب شائعة:

• رفضت Truecaller الرقم لأنها تعدّه افتراضيًا. بعض الخدمات تفعل ذلك؛ ولهذا يُرد لك المبلغ.
• اختار التطبيق التحقق عبر مكالمة بدل SMS.
• ازدحم المسار لوقت قصير. جرّب لاحقًا أو بدولة أخرى تناسب اختبارك.
• أُدخل الرقم دون رمز الدولة، أو بصفر بادئة زائد.

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

متى يكون الرقم المخصص أنسب لـ Truecaller؟

الرقم لمرة واحدة يزول بعد التفعيل. إذا كان على ملف Truecaller أن يُعاد التحقق منه لاحقًا، مثلًا جهاز عمل لفريق الدعم تمت إعادة ضبطه، فاستخدم رقمًا مخصصًا بدلًا منه. هذه الأرقام متاحة فورًا في الولايات المتحدة وكندا بسعر يبدأ من $1.95/month، وتستقبل SMS في لوحة التحكم وعبر webhook الحدث number.sms_received، وتتجدد من المحفظة حتى تفرج عنها. راجع الأرقام الافتراضية.

استخدم OTP Route لحساباتك ومنتجاتك المشروعة فقط: حساب واحد لكل شخص حقيقي أو نشاط تجاري، ودون بلاغات أو تغيير وسوم ضد أرقام الآخرين، مع الاحترام الكامل لشروط Truecaller وسياسة الاستخدام المقبول في OTP Route. Truecaller علامة تجارية لمالكها، وOTP Route غير تابعة لها.

الأسئلة الشائعة

ما معرّف الخدمة لـ Truecaller في API؟

هو truecaller. اقرنه بمعرّف دولة في GET /api/v1/prices وفي جسم POST /api/v1/activations.

هل يمكنني استقبال OTP من Truecaller على رقم افتراضي؟

غالبًا، لكن ليس دائمًا؛ فقد ترفض Truecaller أرقامًا تصنّفها افتراضية. وإذا لم يصل رمز خلال 20 دقيقة يُرد المبلغ تلقائيًا.

لماذا اتصلت Truecaller بدل إرسال رسالة SMS؟

يمكن للتطبيق اختيار التحقق عبر مكالمة على بعض الأجهزة. أرقام OTP Gateway تلتقط SMS فقط، فاطلب خيار الرسالة النصية إن عرضه التطبيق.

أي دولة أختار لاختبار التحقق عبر SMS من Truecaller؟

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

هل يمكنني الاحتفاظ برقم هاتف Truecaller نفسه لتسجيلات الدخول اللاحقة؟

نعم، برقم مخصص في الولايات المتحدة أو كندا بسعر يبدأ من $1.95/month. أما أرقام Gateway لمرة واحدة فلا يمكن إعادة استخدامها.

كيف أمنع تسليمات webhook المكررة من إفساد اختباراتي؟

اجعل المعالج idempotent بالارتباط بمعرّف التفعيل، وتحقق من التوقيع قبل فعل أي شيء بالحمولة.

هل OTP Route تابعة لـ Truecaller؟

لا. Truecaller علامة تجارية لمالكها؛ وتوفر OTP Route أرقامًا لاختبار وتشغيل حساباتك المشروعة.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.