ربط Vapi بـ Bitcall (trunk SIP صادر)

💡 تنبيه: إن Bitcall اليوم للمكالمات الصادرة فقط — وهي مثالية لوكلاء Vapi الذين يُجرون المكالمات (مبيعات، تذكيرات، استبيانات، إشعارات). أما الأرقام الواردة (DIDs) فهي قادمة قريبًا، وسنضيف خطوات الوارد هنا عند توفّرها.

وكيل Vapi لديك يتولّى الحديث، وBitcall تضمن وصول المكالمة فعلًا إلى هاتف. لنربط بينهما — بالطريقة الصادرة.

• حساب Vapi مع إمكانية الوصول إلى لوحة التحكم ومفتاح API خاص
• حساب Bitcall مع حساب SIP (اسم مستخدم + كلمة مرور) — راجع إعداد حساب SIP الأول
• هوية متصل صادرة (CLI) يُسمح لك بعرضها (تعتمد قواعد الأرقام على دولة الوجهة والمشغّل)
• بعض رصيد Bitcall (مسبق الدفع — اشحن بالبطاقة أو PayPal أو العملات المشفّرة)

من حساب SIP في Bitcall، ستستخدم:

⚠️ استخدم المصادقة باسم المستخدم/كلمة المرور، لا مصادقة IP. تشير وثائق Vapi إلى أن المصادقة المعتمدة على IP قد تسيء التوجيه على خوادم SIP المشتركة ولا تكون موثوقة إلا عندما يوفّر المزوّد خادم SIP مخصّصًا أو عنوان إنهاء (URI) فريدًا. واسم المستخدم/كلمة المرور هو المسار النظيف مع Bitcall.

تتصل Vapi بالمشغّلين الخارجيين باستخدام بيانات اعتماد من نوع byo-sip-trunk. أنشئها ببيانات Bitcall (طريقة الـ API موضّحة أدناه — وهناك أيضًا قسم SIP Trunk في لوحة تحكم Vapi):

curl -X POST "https://api.vapi.ai/credential" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "provider": "byo-sip-trunk",
    "name": "Bitcall Outbound Trunk",
    "gateways": [{
      "ip": "gateway.bitcall.io",
      "inboundEnabled": false
    }],
    "outboundLeadingPlusEnabled": true,
    "outboundAuthenticationPlan": {
      "authUsername": "YOUR_BITCALL_SIP_USERNAME",
      "authPassword": "YOUR_BITCALL_SIP_PASSWORD"
    }
  }'

📋 احفظ Credential ID المُعاد — ستحتاجه في الخطوة التالية.

ملاحظة: ضُبط inboundEnabled على false لأن Bitcall تتولّى الصادر اليوم. ويبقي outboundLeadingPlusEnabled الأرقام بصيغة +E.164 عند الخروج.

تحتاج Vapi إلى مورد «phone number» لاستخدامه كـ هوية المتصل (رقم المُرسِل) على المكالمات الصادرة. وبما أن Bitcall للصادر فقط، فهذا هو الـ CLI الذي تريد عرضه — لا رقم DID من Bitcall.

curl -X POST "https://api.vapi.ai/phone-number" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "provider": "byo-phone-number",
    "name": "Bitcall Outbound CLI",
    "number": "YOUR_OUTBOUND_CALLER_ID",
    "numberE164CheckEnabled": false,
    "credentialId": "YOUR_CREDENTIAL_ID"
  }'

📋 احفظ Phone Number ID المُعاد من أجل مكالمتك التجريبية.

تعتمد هوية المتصل على المكالمات الصادرة على قواعد دولة الوجهة والمشغّل — فبعض المسارات تمرّر الـ CLI الخاص بك، وبعضها يستبدله أو ينقّيه. اضبط الـ CLI وأدِره من هنا: تغيير أو إدارة هوية المتصل.

🎲 هل تريد تدوير هويات المتصل عبر الحملة؟ يمكنك عرض CLI مختلف لكل مكالمة من منطق وكيلك.

من لوحة تحكم Vapi، أو عبر الـ API:

curl -X POST "https://api.vapi.ai/call/phone" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_VAPI_PRIVATE_KEY" \
  -d '{
    "assistantId": "YOUR_ASSISTANT_ID",
    "customer": { "number": "NUMBER_YOU_ARE_CALLING", "numberE164CheckEnabled": false },
    "phoneNumberId": "YOUR_PHONE_NUMBER_ID"
  }'

📞 رنين… رنين… يطلب الآن وكيل Vapi لديك عبر Bitcall. 🎉