إرسال الصوت عبر الرابط وواجهة API
كيفية استيراد الصوت عبر رابط مباشر في الواجهة، وكيفية إرسال التفريغات برمجيًا عبر API: الخطط المؤهلة، المفاتيح، المصادقة، الحدود، وخطافات الويب.
بالإضافة إلى رفع الملفات، هناك طريقتان «بدون ملف بين يديك»: لصق رابط وسائط في الواجهة (لأي مستخدم)، والإرسال عبر واجهة API (للخطط الاحترافية وما فوق) — مثالي لدمج التفريغ مع الأنظمة وPABX والأتمتة.
1. الاستيراد عبر رابط في الواجهة
في شاشة تفريغ جديد، نفس الخيار الذي يقبل YouTube يقبل روابط مباشرة لملفات الصوت/الفيديو (https). يقوم الخادم بتنزيل الوسائط ثم يكمل المسار المعتاد: اختيار اللغة (أو الكشف التلقائي)، محرك الخطة، والتكلفة بالدورات حسب المدة. وتنطبق حدود المدة والحجم في خطتك بنفس الطريقة.
2. واجهة API للتفريغ
من يمكنه الاستخدام
تتوفر واجهة API ابتداءً من خطة Profissional (R$ 39,90 شهريًا) — بما في ذلك Premium والخطط المؤسسية والخطط القديمة المكافئة. في الخطط الأخرى، تُرجع عملية إنشاء المفتاح أن الخطة غير مؤهلة.
مفاتيح API
- تنسيق الرمز:
vpt_live_...; - يُعرض السر مرة واحدة فقط عند الإنشاء — فاحفظه في خزنة. نحن لا نخزّن السر، بل نخزّن بصمة رقمية منه فقط;
- حتى 20 مفتاحًا نشطًا لكل حساب؛ يمكنك إبطال أي منها في أي وقت;
- منطقة إدارة المفاتيح الشخصية في الواجهة قيد التطوير — إذا لم تجد الخيار في حسابك، افتح تذكرة وسنفعّله لك.
كيف يعمل الاستدعاء
المصادقة عبر الترويسة Authorization: Bearer vpt_live_.... في متن الطلب، تُرسل رابط الصوت (audio_url، https فقط)، ورابط webhook الخاص بك لاستلام النتيجة، واختياريًا المحرك واللغة وصيغ التصدير ومفتاح التماثل (idempotency).
- حد المعدل: 60 طلبًا في الدقيقة لكل مفتاح;
- الحجم: صوت عبر رابط يصل إلى 500 MB للتنزيل على الخادم؛ ومع محرك Premium، يمكن قراءة روابط حتى 5 GB مباشرة بواسطة المحرك دون تنزيل وسيط;
- التكلفة: نفس دورات الموقع، حسب المدة والمحرك.
استلام النتيجة (webhooks)
تصل النتيجة عبر webhook موقّع بـ HMAC-SHA256 (الترويسات X-VPT-Signature و X-VPT-Event) — تحقق من التوقيع قبل الوثوق بالحمولة. إذا كان عنوانك (endpoint) معطلاً، نعيد الإرسال بتراجع تدريجي: حتى 6 محاولات على مدى ~24 ساعة.
نقبل فقط روابط https ونحظر العناوين الداخلية/الخاصة لأسباب أمنية. إذا كان صوتك خلف مصادقة، فأنشئ رابطًا مؤقتًا موقّعًا في التخزين الخاص بك قبل استدعاء API.
ليس لديك رابط عام للملف (مثل تسجيلات PABX)؟ توفر واجهة API للمراجعة المؤسسية نقطة نهاية رفع تعيد رابط إرسال مؤقت (صالح لمدة ساعة واحدة) — تحدث مع المبيعات إذا كانت حالتك مراجعة مكالمات بكميات كبيرة.
الأسئلة الشائعة
فقدت سر المفتاح. كيف أستعيده؟
لا يمكن استعادته — ألغِ المفتاح وأنشئ آخر. السر موجود فقط لحظة الإنشاء.
هل لدى API توثيق؟
يتم توفير المرجع الكامل للتكامل مع تفعيل الوصول. افتح تذكرة ذاكرًا حالة الاستخدام الخاصة بك.
هل يمكنني اختيار المحرك واللغة في الاستدعاء؟
نعم، كلاهما معلمتان اختياريتان — بدونه