استيراد الوكلاء من منصة أخرى
انقل الوكلاء والأدوات وقواعد المعرفة من Vapi أو Retell أو ElevenLabs Agents أو Bland باستخدام مفتاح API أو تصدير JSON، ثم راجع التعيين واستوردها.
إذا كانت وكلاؤك موجودة على Vapi أو Retell أو ElevenLabs Agents أو Bland، فإن أداة الاستيراد تجلبها، وتعيّن كل حقل بما يقابله في ThunderPhone، وتعرض لك النتيجة قبل إنشاء أي شيء.
ابدأ عملية استيراد
- افتح الوكلاء واختر استيراد (أو استيراد من Vapi أو Retell أو ElevenLabs أو Bland في صفحة الوكلاء الفارغة).
- اختر المنصة.
- اتبع الخطوات المرقمة في مربع الحوار لإنشاء مفتاح على تلك المنصة (ستفتح لك صفحة الإعدادات الصحيحة)، ثم الصقه، أو انتقل إلى لصق JSON المُصدَّر والصق كائناً واحداً أو أكثر من كائنات الوكلاء من لوحة تحكم تلك المنصة أو واجهة API الخاصة بها.
- اختر جلب وكلائي. يستغرق الجلب والتعيين عادةً أقل من دقيقة؛ يمكنك مغادرة الصفحة والعودة عبر لوحة المهام.
راجع الخطة
يعرض كل وكيل الاسم، والصوت المطابق (مع مستوى الثقة في المطابقة)، ومستوى الذكاء، والأدوات وقواعد المعرفة التي يجلبها، وملاحظات حول أي شيء تغيّر أثناء التحويل. وسّع صفاً لقراءة الموجّه:
- مُعاد صياغته — موجّه واحد متماسك بأسلوب دليل الموجّهات، مع الحفاظ على كل رقم هاتف وعنوان URL واسم أداة وعنصر نائب من المصدر.
- منظّم — إعدادات المصدر مرتبة تحت عناوين، تماماً كما استُخرجت. يُستخدم تلقائياً عندما يتعذر التحقق من إعادة الصياغة.
أزل تحديد الوكلاء الذين لا تريدهم (تكون النسخ التجريبية غير محددة افتراضياً)، وعدّل الأسماء أو الأصوات أو المستويات أو اختيار الموجّه، ثم اختر استيراد. تُفتح الوكلاء المنشأة في أداة الإنشاء مع اتصالات API والمعرفة المرفقة بها.
ما يتم استيراده
الحصول على مفتاح
- افتح dashboard.vapi.ai/org/api-keys (إعدادات المؤسسة → مفاتيح API).
- أنشئ مفتاحًا واختر خاص — لا يمكن للمفاتيح العامة عرض المساعدين.
- انسخه إلى مربع الحوار. مفاتيح Vapi غير مقيّدة النطاق؛ احذف المفتاح من Vapi بعد الاستيراد إذا أنشأته لهذا الغرض فقط.
| حقل Vapi | ThunderPhone |
|---|---|
model.messages[system] | الموجّه |
firstMessage, firstMessageMode | الجملة الافتتاحية في الموجّه؛ من يتحدث أولًا |
voice.provider + voiceId | أقرب صوت في الكتالوج (تظهر درجة ثقة المطابقة) |
transcriber.language | اللغة الأساسية |
model.model | مستوى الذكاء |
model.tools / toolIds (function, apiRequest) | اتصالات API |
وجهات transferCall | قسم الإحالة في الموجّه (تحويل مضمّن) |
endCall, dtmf | وظائف مضمّنة |
أدوات query (knowledgeBases[].fileIds) وknowledgeBaseId القديم | قاعدة معرفة تحتوي على الملفات المرفوعة كمستندات |
endCallMessage, endCallPhrases, voicemailMessage, messagePlan.idleMessages | أقسام الموجّه؛ إعداد رسالة البريد الصوتي |
silenceTimeoutSeconds | إنهاء المكالمة عند الصمت |
maxDurationSeconds, server.url, squads, workflows, أدوات sms/ghl/make/code/mcp | يُبلّغ عنها، ولا تُستورد |
الحصول على مفتاح
- افتح dashboard.retellai.com/apiKeys (إعدادات النظام → مفاتيح API) واختر إنشاء مفتاح.
- فعّل تقييد الأذونات واضبط الوكيل وقاعدة المعرفة والهاتف على قراءة. اترك كل مجموعة أخرى دون تحديد؛ لا يكتب المستورد أبدًا إلى Retell.
- انسخ المفتاح إلى مربع الحوار.
| حقل Retell | ThunderPhone |
|---|---|
Retell LLM general_prompt, begin_message, start_speaker | الموجّه؛ الجملة الافتتاحية؛ من يتحدث أولًا |
states + starting_state | إجراء المكالمة المتسلسل في الموجّه |
global_prompt + عُقد تدفق المحادثة | إجراء المكالمة المتسلسل؛ تتحول عُقد التحويل أيضًا إلى قواعد إحالة |
general_tools المخصصة | اتصالات API |
transfer_call, end_call, press_digit | إحالة في الموجّه + وظائف مضمّنة |
voice_id (11labs-, openai-, cartesia-, …) | أقرب صوت في الكتالوج |
language | اللغات الأساسية والإضافية |
model / s2s_model | مستوى الذكاء |
knowledge_base_ids (مصادر url وdocument وtext) | قاعدة معرفة تحتوي على مستندات |
voicemail_option, end_call_after_silence_ms, boosted_keywords | إعداد البريد الصوتي؛ إنهاء المكالمة عند الصمت؛ مصطلحات الموجّه |
webhook_url, max_call_duration_ms (عندما تكون أقل من القيمة الافتراضية البالغة 60 دقيقة)، محركات LLM المخصصة، send_sms, MCP | يُبلّغ عنها، ولا تُستورد |
الحصول على مفتاح
- افتح elevenlabs.io/app/settings/api-keys واختر إنشاء مفتاح API.
- ضمن الأذونات، امنحه منصة الوكلاء: قراءة (وقاعدة المعرفة: قراءة إذا ظهرت)؛ لا يحتاج المستورد إلى أي شيء آخر.
- انسخ المفتاح إلى مربع الحوار.
| حقل ElevenLabs | ThunderPhone |
|---|---|
conversation_config.agent.prompt.prompt | الموجّه |
first_message, language | الجملة الافتتاحية؛ اللغة الأساسية |
prompt.llm | مستوى الذكاء |
tts.voice_id | أقرب صوت في الكتالوج |
tools / tool_ids من نوع webhook | اتصالات API (مخطط الاستعلام أو جسم الطلب) |
أدوات النظام end_call, transfer_to_number, لوحة المفاتيح | وظائف مضمّنة + إحالة في الموجّه |
إدخالات url/text/file في knowledge_base | قاعدة المعرفة: تتحول إدخالات URL إلى مستندات URL؛ وتُجلب إدخالات النص والملفات حسب المعرّف وتُستورد كنصها المستخرج |
turn.silence_end_call_timeout | إنهاء المكالمة عند الصمت |
conversation.max_duration_seconds, أدوات العميل، MCP | يُبلّغ عنها، ولا تُستورد |
الحصول على مفتاح
- افتح app.bland.ai/dashboard/settings.
- انسخ مفتاح API الظاهر هناك (يوفر Bland مفتاحًا واحدًا لكل حساب؛ وهو غير مقيّد النطاق، لذا بدّله لاحقًا إذا رغبت).
- ألصقه في مربع الحوار.
لا تحمل وكلاء الويب اسمًا في Bland، لذا يسمّيها المستورد استنادًا إلى التحية ("مرحبًا، معك Nova…") أو الموجّه ("أنت Nova…").
| حقل Bland | ThunderPhone |
|---|---|
وكيل الويب prompt, first_sentence, language, model, voice | الموجّه؛ الجملة الافتتاحية؛ اللغة؛ المستوى؛ أقرب صوت |
tools المخصصة (الاسم، url، الطريقة، input_schema، الرؤوس) | اتصالات API |
prompt أو pathway_id لرقم وارد | وكيل واحد لكل رقم وارد |
| كل مسار، سواء كان مرتبطًا برقم أم لا | وكيل واحد لكل مسار |
| عُقد المسار وحوافه (الافتراضي، قاعدة المعرفة، تحويل المكالمة، إنهاء المكالمة، خطاف الويب) | إجراء المكالمة المتسلسل؛ يتحول نص عقدة قاعدة المعرفة إلى مستند؛ وتتحول التحويلات وخطافات الويب إلى وظائف مضمّنة واتصالات API |
transfer_phone_number | قسم الإحالة |
max_duration, webhook | يُبلّغ عنها، ولا تُستورد |
| الأرقام المملوكة لـ Bland | يُبلّغ عنها باعتبارها غير قابلة للنقل |
ما الذي يحتاج إلى إجراء على ThunderPhone
يسرد التقرير الموجود أسفل صفحة المراجعة كل ما لم يتم نقله وسبب ذلك:
- أرقام الهاتف. يمكن ربط الأرقام التي تملكها لدى شركة اتصالات بصفتها أرقام VoIP. لا يمكن نقل الأرقام المملوكة للمنصة؛ احصل على رقم جديد واربطه بالوكيل المستورَد.
- خطافات الويب لكل وكيل. يرسل ThunderPhone خطافات ويب موقعة لكل مؤسسة؛ أعدّ واحدًا ضمن خطافات الويب.
- بيانات الاعتماد المخزنة لدى المورّد. تُنسخ ترويسات الأدوات التي كانت مرئية. تُعلَّم بيانات الاعتماد التي خزنتها المنصة القديمة حسب المعرّف؛ أضفها إلى ترويسات اتصال API.
- الأدوات التي ليس لها مكافئ (إرسال الرسائل النصية القصيرة، وعمليات الأتمتة الخاصة بالمنصة) مدرجة حتى لا يُسقَط أي شيء بصمت.
- حدود مدة المكالمة. لا يفرض ThunderPhone حدًا أقصى لطول المكالمة لكل وكيل؛ استخدم إعداد إنهاء المكالمة عند الصمت وقواعد الإنهاء في موجّهك بدلًا من ذلك.
الاستيراد من دون مفتاح
اختر لصق JSON المُصدَّر والصق الكائن أو الكائنات التي تصدّرها واجهة API أو لوحة التحكم في منصتك، إما ككائن واحد أو قائمة JSON:
- Vapi — كائن المساعد (
GET /assistant/{id}). تتطلب الأدوات المرفقة عبرtoolIdsوملفات المعرفة مفتاحًا لحلّها. - Retell — كائن الوكيل (
GET /get-agent/{id}) مع نموذج Retell LLM الخاص به (GET /get-retell-llm/{id}) أو كائن تدفق المحادثة في القائمة نفسها؛ يربط المستورد بينها حسب المعرّف. يُستورد نموذج LLM أو تدفق مُلصق بمفرده تحت اسم مُنشأ. - ElevenLabs — كائن الوكيل (
GET /v1/convai/agents/{id})؛ تُضمَّن أدوات خطاف الويب الخاصة به ضمنيًا، لذلك لا يبقى شيء دون حل. - Bland — وكيل ويب، أو استجابة
/v1/agents، أو كائن مسار.
يُدرج في الملاحظات أي شيء يُشار إليه بالمعرّف فقط وغير موجود في المحتوى الملصق.
بعد الاستيراد
- افتح كل وكيل واقرأ ملاحظاته.
- أجرِ مكالمة اختبارية من أداة الإنشاء.
- اربط رقم هاتف.
- اختبر كل اتصال API باستخدام مختبر الطلبات.
- تحقق من انتهاء فهرسة مستندات المعرفة.
- عيّن خطاف ويب للمؤسسة إذا كانت الوكلاء القديمة تستخدم واحدًا.
يتوفر المستورد أيضًا عبر واجهة REST API.