التكاملات›احجز الأعمال من وكيل صوتي

احجز الأعمال من وكيل صوتي

دع وكيل هاتف بالذكاء الاصطناعي على ElevenLabs Agents أو Vapi أو Retell يتعرّف على المتصل ويحجز الزيارة وهو لا يزال على الخط.

لا شيء لتثبيته. تتصل المنصّات الثلاث جميعها بـ خادم MCP الخاص بـ Crisphive مع مجموعة أدوات صغيرة وسريعة مصمّمة للمكالمات الهاتفية — ملف التعريف voice.

قبل الربط

  • امنح كل نوع عمل مدة افتراضية (الإعدادات ← أنواع العمل). لا يستطيع الوكيل معرفة المدة التي يستغرقها إصلاح ما. نوع العمل الافتراضي، “General”، له مدة مسبقًا ويُستخدم عندما لا يحدّد الوكيل أي نوع.
  • أنشئ مفتاح API — chsk_test_… لتجربته، وchsk_live_… للمكالمات الحقيقية. لا يحتاج إلا إلى customers_view وcustomers_manage وjob_view وjob_create وjob_manage.

اربط الوكيل

Server URL:  https://api.crisphive.com/mcp?profile=voice
Header:      Authorization: Bearer chsk_live_…   (chsk_test_… for sandbox)
المنصّةأين تضيفهملاحظات
ElevenLabs AgentsMCP server integrations ← Add Custom MCP Server؛ أضف ترويسة Authorization، ثم اربط الخادم بوكيلك.اضبط موافقة الأدوات على Fine-Grained (مع الموافقة التلقائية على أدوات الصوت) أو No Approval — فخيار «Always Ask» يوقف المكالمة مؤقتًا. لا يتوفر MCP في مساحات العمل Zero Retention أو HIPAA.
VapiTools ← Create Tool → MCP، ثم اختر الأداة في مساعدك.أبقِ ?profile=voice: يستورد Vapi كل أداة يقدّمها الخادم. استخدم نقل HTTP الافتراضي، لا SSE.
RetellAgent ← MCPs → Add MCP (العنوان + الترويسات)، ثم أضف الأدوات.المصادقة عبر الترويسات فقط؛ ولا يعيد Retell محاولة استدعاء أداة فاشل.

أدوات الصوت

الأداةمتى يستخدمها الوكيل
listCustomers مع phoneأولًا، في كل مكالمة: ابحث عن المتصل برقمه بصيغة E.164 (+16135550142). مطابقة تامة.
listJobTypesربط ما يصفه المتصل بنوع عمل.
bookAndConfirmJobRequestالحجز — إنشاء وجدولة وتأكيد في استدعاء واحد.
listJobRequestBookingWindowsعندما يريد المتصل معرفة الأيام المتاحة.
getJobRequestقراءة حجز مرة أخرى («ما موعدي؟»).

قالب موجّه النظام

You are the booking assistant for [Business name], a [trade] company in
[city]. Times are in [Business timezone].

On every call:
1. Look the caller up with listCustomers using their phone number in
   E.164 (+1 then 10 digits). If exactly one customer comes back, greet
   them by name and use its id. Never guess between several matches.
2. Ask what is wrong and pick the job type from listJobTypes.
3. Agree a start time. Send it as the business's local time, e.g.
   2026-10-06T10:00:00, with no timezone offset.
4. Call bookAndConfirmJobRequest once, with an idempotency_key you generate
   for this call. If you retry, reuse the SAME key.
5. If confirmed is true, read back the date, time and short_code. If it
   is false, tell the caller the office will call to confirm a time.
   Never promise a time the tool did not confirm.

Rules:
- Only set sms_opt_in to true if the caller explicitly agrees to texts.
- Never quote a price.
- A new caller needs a full name and the service address.

ما يُقال عندما لا ينجح الأمر

النتيجةما تعنيهما يقوله الوكيل
confirmed: trueمحجوز ومُجدول.«تم حجز موعدك يوم الثلاثاء الساعة 10 صباحًا، ورقمك المرجعي هو …»
confirmed: falseمحفوظ، لكن لا أحد متاح في ذلك الوقت.«لقد حفظت طلبك — سيتصل بك المكتب لتأكيد موعد.»
400 JOB_REQUEST_INVALID_INPUT مع data.means_locallyحمل الوقت إزاحة منطقة زمنية خاطئة.لا شيء — أعد إرسال الوقت نفسه دون إزاحة.
400 PHONE_INVALIDرقم الهاتف ليس بصيغة E.164.اطلب الرقم مرة أخرى.
العميل الذي يُنشأ خلال مكالمة لا يتلقى رسائل نصية إلا إذا وافق المتصل وأرسل الوكيل sms_opt_in: true؛ وإلا تُرسَل التأكيدات عبر البريد الإلكتروني. اختبر بمفتاح chsk_test_ وقِس زمن استجابة الحجز على نشاطك التجاري قبل الانتقال إلى الإنتاج.