أجب عن كل قناة من صندوق وارد واحد

المهمة: مكان واحد تصل إليه كل رسالة من عميل، من أي تطبيق كتب، واستدعاء واحد يجيبه هناك. خمس خطوات، كل واحدة طلب واحد.

‏1. أنشئ حساب صندوق الوارد

curl -X POST https://makehybrid.com/inbox/v1/account \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

مرة واحدة لكل مؤسسة. واستدعاؤه مجدداً يعيد الحساب نفسه، فلا ضرر في تشغيله مع كل نشر.

‏2. أضف القنوات

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'

تردّ دردشة الموقع بمقطع شيفرة تلصقه قبل ‎</body>‎؛ ويُحمَّل من نطاقك أنت. وتُضاف Instagram وTikTok برابط تسجيل دخول، وFacebook Messenger برابط يفتحه مدير الصفحة، وLINE وSMS وWhatsApp ببيانات اعتماد المنصة نفسها — وفي المرجع شرح كل واحدة.

‏3. اسمع الرسائل الجديدة

curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'

احتفظ بالسرّ الذي يعيده: فكل تسليم يُوقَّع به في ترويسة x-mh-signature، وتكرار الحدث نفسه أمر عادي.

‏4. ردّ حيث كتبوا

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'

يخرج الردّ على قناة المحادثة نفسها. وأضف ‎"private": true‎ فيصبح ملاحظة لا يراها إلا فريقك.

‏5. احلّها

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"status":"resolved"}'

تُفتح المحادثة المحلولة من جديد من تلقاء نفسها حين يكتب العميل.

أسئلة شائعة