
سيجنال هاوس هو واجهة برمجة تطبيقات الرسائل النصية القصيرة والصوت للمطورين الذين يبنون AI وكلاء يتواصلون خارج نطاق نافذة الدردشة. تتضمن حزمة تطوير البرامج (SDK) الخاصة بها، وخطافات الويب الواردة، وسجلات التسليم، ومساعدي مواعيد دعم المكالمات القابلة للبرمجة، ووكلاء خدمة العملاء، وتحديثات الحساب.
يجب أن يقوم الوكيل الفعال بأكثر من مجرد كتابة رد مقنع. يحتاج برنامجك إلى إرسال هذا الرد، واستلام الإجابة، والتعرف على حالات فشل التسليم، ومعرفة متى يجب على شخص ما التدخل.
توفر سيجنال هاوس بنية تحتية للمراسلة والمكالمات، بينما يتحكم تطبيقك في اختيار النموذج والذاكرة وقواعد العمل. مسار التكامل الخاص بها مناسب. AI أدوات البرمجة، بحيث يمكنك البناء حول المحادثات بدلاً من التعامل مع إعداد الاتصالات كمشروع هندسي منفصل.
تقييم سريع من AIMOJO
اعتمد على Signal House عندما يحتاج وكيلك إلى مراسلة ثنائية الاتجاه ومكالمات قابلة للبرمجة إلى جانب منطق التطبيق الذي تتحكم فيه. تتمثل أقوى ميزة للمطورين في الجمع بين حزمة تطوير البرامج (SDK) ومهارات الوكيل وخطافات الويب وحالات التسليم المرئية. ابدأ بسير عمل معتمد للدعم أو تحديد المواعيد، وأثبت محادثة كاملة، ثم أضف القنوات. لا يزال نقل الصوت يتطلب حزمة معالجة صوتية مناسبة قبل أن يصبح وكيلًا صوتيًا تفاعليًا مباشرًا.
AI يبدأ التشغيل الأصلي داخل سير عمل البرمجة الخاص بك

في وقت سابق سير عمل واجهة برمجة تطبيقات الاتصالات عادةً ما تبدأ العملية بصفحات مرجعية، وتوصيل نقاط النهاية يدويًا، وتكوين ردود الاتصال. تتبع Signal House نهج التكامل من خلال AI التطوير المدعوم، بما في ذلك مسار إعداد لـ Cursor و Lovable. يمكن للمطورين طلب مساعدة برمجية لفحص حزمة تطوير البرامج (SDK) الخاصة بهم وتنفيذ ميزة المراسلة بناءً على توقيعات الدوال الفعلية.
لا يكمن الفرق في أن منصات الاتصالات القائمة لا تدعم الوكلاء، بل السؤال الأهم هو: ما مقدار سياق التكامل الذي تتلقاه أداة البرمجة الخاصة بك قبل إنتاج الكود؟
تتضمن حزمة تطوير البرمجيات (SDK) من Signal House مدخلًا لمهارات الوكلاء وتعليمات مُجمّعة تغطي الإعداد، والرسائل النصية القصيرة، وخطافات الويب، والأرقام، و10DLC. هذه هي اللبنات الأساسية التي يقوم عليها النظام. AI البنية التحتية للاتصالات المحليةليس مجرد شعار.
| مهمة المطور | مكون غرفة الإشارة | مسؤولية طلبك |
|---|---|---|
| إرسال رسائل للعملاء | مجموعة أدوات تطوير برامج المراسلة | الموافقة على المستلمين والمحتوى |
| الرد على الردود | روابط الويب الواردة | استرجاع سياق المحادثة |
| مشاريع العملاء المنفصلة | المجموعات الفرعية | تطبيق صلاحيات المستأجرين |
| إضافة التفاعلات الهاتفية | صوت API | اختر منطق المحادثة والتسليم |
تُصنّف المجموعات الفرعية الأرقام والعلامات التجارية والحملات حسب العميل أو حالة الاستخدام. لا تُعامل المجموعة التنظيمية كبديل عن ترخيص التطبيق. احتفظ بفحوصات الملكية بجانب كل أداة مراسلة يمكن لنموذجك استدعاؤها.
إنشاء وكيل رسائل نصية قصيرة من Signal House خطوة بخطوة
استخدم مساعد المواعيد كمشروعك الأول. يطلب العميل تغيير موعد الحجز، فيتحقق وكيلك من التوافر، ويعرض عليه موعدًا متاحًا، ويرسل تأكيدًا فقط بعد إتمام الحجز بنجاح.
يختبر هذا السيناريو أتمتة الرسائل النصية القصيرة ثنائية الاتجاه دون ابتكار مسار مبيعات معقد.
الخطوة: تسجيل حالة استخدام مسموح بها للمراسلة
أنشئ حسابك وجهّز بيانات هوية شركتك، ومعلومات موقعك الإلكتروني، ونماذج الرسائل، ومسار موافقة واضح. تتطلب خدمة مراسلة الشركات المحلية في الولايات المتحدة علامة تجارية مسجلة وحملة معتمدة وفقًا لمعايير 10DLC . كما يتطلب Signal House إجراء مكالمة للتحقق من هوية العميل (KYC) أثناء عملية التسجيل.

هناك حدٌّ واحدٌ مهمٌّ للغاية، خاصةً بالنسبة لقراء AIMojo الذين يقومون ببناء أنظمة أتمتة تجارية. يحظر Signal House توليد العملاء المحتملين و التسويق بالعمولة الحملات. لا تفترض AI تُعتبر عملية التأهيل أو تسلسل البحث عن العملاء مؤهلة لمجرد أن الرسائل تبدو شخصية. احصل على موافقة صريحة على سير عمل المبيعات المقترح قبل تخصيص وقت هندسي.
قم بتضمين نظام تخزين الموافقات في قاعدة بياناتك الخاصة. سجّل الغرض والمصدر والطابع الزمني وأي عملية سحب. يجب على وكيلك مراجعة هذه السجلات قبل كل إجراء صادر.
الخطوة: ربط رقم بحملته

اشترِ رقمًا أو انقله، وخصص مجموعة فرعية، واربط العلامة التجارية والحملة المناسبتين. أكمل التفعيل قبل اختبار حركة المرور الصادرة. ضمن قسم الأرقام، افتح "أرقامك" ثم "تكوين" للاطلاع على الإمكانيات والتخصيصات وإعدادات Webhook الواردة.
استخدم سجلات تطبيق منفصلة لمعرف المستأجر، ورقم الإرسال المخصص، ومعرف الحملة. قم بحل هذه البيانات من جانب الخادم بدلاً من قبول أي مرسل يقدمه النموذج.
الخطوة: امنح مساعد البرمجة الخاص بك سياق SDK حقيقي
استرجع بيانات الاعتماد من أدوات المطورين ← مفاتيح واجهة برمجة التطبيقات. احتفظ بالسر في بيئة الواجهة الخلفية أو مخزن الأسرار، ولا تضعه أبدًا في كود المتصفح أو في نافذة الدردشة.

قم بتثبيت الحزمة:
npm install @signalhousellc/sdk
ثم أعطِ مساعدك البرمجي مهمة محددة:
افحص حزمة تطوير البرامج (SDK) الخاصة بـ Signal House المثبتة وتعليمات الرسائل النصية القصيرة (SMS). أنشئ نقطة نهاية خادم لتأكيد المواعيد باستخدام طرق SDK الموثقة . اقرأ بيانات الاعتماد من متغيرات البيئة. تحقق من ملكية المرسل وموافقة العميل قبل الإرسال. أعد مُعرّف رسالة المزوّد، وأضف اختبارات للمستلمين المرفوضين وبيانات الاعتماد غير المتاحة.
احتفظ بإصدار SDK في ملف القفل الخاص بك، وراجع التغييرات قبل الترقية. دع مساعد البرمجة يقرأ الحزمة المثبتة بدلاً من افتراض واجهة محفوظة. مجموعة تبعيات قابلة للتكرار تجعل التحقيق في الطلبات الفاشلة أسهل من التحقق من تحديث حزمة غير مُتتبَّع.
سيجنال هاوس AI يتبع إعداد التطبيق هذا النهج القائم على الفحص أولاً. راجع عمليات الاستيراد المُنشأة، ومعاملات الدوال، ومسارات الأخطاء قبل النشر؛ فاسم الدالة المناسب ليس عقدًا لواجهة برمجة التطبيقات.
الخطوة: إثبات التسليم قبل إضافة نموذج
افتح خيار "إرسال رسالة" ثم "إرسال رسالة نصية قصيرة". اختر رقمًا نشطًا مرتبطًا بحملة نشطة، وأدخل اسم المستلم التجريبي بصيغة E.164، ثم أضف رابطًا لحالة الاتصال. أبقِ خيار "المراسلة الجماعية" مُعطّلاً لإجراء محادثة فردية.
أرسل رسالة قصيرة إلى جهاز اختبار معتمد. تقوم لوحة التحكم بإنشاء طلب cURL، مما يمنحك طلبًا محددًا لإعادة إنتاجه من خادمك دون الحاجة إلى تخمين أسماء نقاط النهاية أو حقول البيانات.
راجع سجلات الرسائل، ثم أجب من ذلك الهاتف. نجاح الرسائل الصادرة وحده لا يثبت سوى نصف نجاح التكامل.
لا تُضِفْ مُحوِّلَةِ LLM إلا إذا كان بالإمكان نقل الرسالة العادية في كلا الاتجاهين. وإلا، سيتحوّل تصحيح الأخطاء إلى لعبة تخمين بين سلوك النموذج، وشفرة التطبيق، وطريقة تسليم الرسالة عبر الناقل.
الخطوة: معالجة روابط الويب دون حظر الذكاء الاصطناعي
أنشئ اشتراكات الأحداث ضمن أدوات المطورين ← Webhooks، وحدد وجهة HTTPS، وفعّل الأحداث ذات الصلة. راقب نشاط Webhook للتحقق من الاستجابات الناجحة والفاشلة. يعتبر Signal House استجابة HTTP 200 استجابة ناجحة.

استخدم تصميم التطبيق هذا:
قم بتخصيص مفتاح لإزالة التكرارات لأحداث الرسائل الواردة بناءً على معرّفاتها الفعلية. يجب ألا ينتج عن معاودة الاتصال المتكررة ردّ آخر من العميل. في المقابل، يجب أن تُحدِّث حالات التسليم المتعددة لرسالة واحدة السجل نفسه، لا أن تختفي كنسخ مكررة.
خزّن حالة المحادثة حسب رقم العميل ورقم الشركة، وليس رقم الهاتف فقط. وإلا، فقد يحصل شخص واحد يتصل بحسابي عميلين على معلومات متضاربة. تتبّع وقت الحدث، ومعرّف المزوّد، وحالة المعالجة، والإجراء التالي المُختار. رتّب العمل داخل كل محادثة بحيث لا يؤدي ردّان سريعان إلى حجوزات متضاربة.
هذه إجراءات وقائية للتطبيق، وليست ضمانات مفترضة بشأن جدول إعادة المحاولة أو ترتيب الأحداث في Signal House.
الخطوة: تقييد إجراءات الوكيل قبل إرسال الردود
قم بتوفير أداة داخلية محدودة مثل send_appointment_reply. دع النموذج يقترح نصًا، ولكن قم بتحديد المستلم والمرسل وصلاحيات الحجز في كود الخادم.

أبقِ عناصر التحكم الخاصة باستدعاء أداة إدارة دورة حياة التطبيق خارج نافذة المطالبة. ارفض الإجراءات غير المدعومة، واحجب الرسائل بعد سحب الموافقة، واشترط إتمام عملية تقويم ناجحة قبل تأكيد الموعد.
يجب أن يؤدي إلغاء الاشتراك إلى إلغاء عمليات الإرسال المعلقة، وليس فقط منع عمليات الإرسال الجديدة. تحقق من الموافقة مرة أخرى عندما تصل مهمة في قائمة الانتظار إلى مرحلة الإرسال. وإلا، فقد تستمر رسالة تمت الموافقة عليها سابقًا في المغادرة حتى بعد سحب العميل لإذنه. اجعل عملية التحقق النهائية من الموافقة حتمية، بمعزل عن أي منطق مُولّد من النموذج.
تعامل مع محتوى الرسائل النصية القصيرة الواردة كبيانات للعملاء، وليس كإذن لتغيير تعليمات النظام أو الاتصال برقم آخر.
اختبر ثلاث رحلات كاملة قبل الإصدار: حجز ناجح، موعد غير متاح، وطلب مساعدة بشرية. أضف أحداثًا مكررة وأعطالًا من جانب مزود الخدمة في كل مجموعة اختبار.
الهدف العملي ليس "AI تم إرسال رسالة نصية. هدفك هو "أنهى العميل مهمة مسموح بها، ويمكن تتبع كل تغيير في الحالة".
أضف ميزة الصوت القابل للبرمجة دون الخلط بين المكالمات والمحادثة
يدعم نظام Signal House المكالمات التي يبدأها الخادم، والمكالمات عبر المتصفح، والتحكم في المكالمات باستخدام SHML. يستخدم SHML استجابات XML لتوجيه المتصل لنطق نص، أو تشغيل صوت، أو جمع مدخلات لوحة المفاتيح، أو تسجيل الصوت، أو ربط رقم آخر.

لإجراء مكالمة خلفية، ثبّت حزمة تطوير البرامج (SDK) المذكورة أعلاه واستخدم وحدة ES. اضبط متغيرات البيئة الأربعة المشار إليها أدناه. يجب أن يكون المرسل هو رقم هاتفك المُفعّل صوتيًا؛ ويجب أن يكون ANSWER_URL نقطة نهاية HTTPS تُعيد تعليمات مكالمتك.
import { SignalHouseSDK } from "@signalhousellc/sdk";
const required = ["SH_API_KEY", "CALL_FROM", "CALL_TO", "ANSWER_URL"];
for (const name of required) {
if (!process.env[name]) throw new Error(`Missing ${name}`);
}
const client = new SignalHouseSDK({
apiKey: process.env.SH_API_KEY,
baseUrl: "https://v2.signalhouse.io",
});
try {
const { data } = await client.voice.calls.create({
callData: {
from: process.env.CALL_FROM,
to: process.env.CALL_TO,
answer_url: process.env.ANSWER_URL,
},
});
console.log({ callId: data.call_id, status: data.status });
} catch (error) {
console.error("Call request failed", {
status: error?.response?.status ?? "unknown",
});
process.exitCode = 1;
}
يبدأ هذا المثال مكالمة؛ ولا يُفعّل وكيلًا صوتيًا مباشرًا. أضف ترخيص الوجهة قبل عرضها عبر نقطة نهاية التطبيق.
تتطلب المكالمات الواردة ملف تعريف صوتي قابل للبرمجة . اضبط routeAction على CALL_CONTROL، ووجّه webhookUrl إلى معالج المكالمات، ثم خصص الرقم. تتضمن ردود الاتصال CallSid وFrom وTo وCallStatus. احفظ مُعرّف المكالمة بجانب سجل المحادثة بحيث ينتمي تأكيد SMS اللاحق إلى مهمة العميل نفسها.
لإجراء المكالمات عبر المتصفح، ثبّت مكتبة jssip مع حزمة تطوير البرامج (SDK). سيصدر خادمك رمزًا صوتيًا مؤقتًا، وسيستخدم المتصفح الجهاز من @signalhousellc/sdk/voice-browser للتسجيل والاتصال. وثّق نقطة نهاية الرمز واحتفظ ببيانات الاعتماد الدائمة على الخادم.
تتطلب المحادثة المباشرة أكثر من مجرد بدء المكالمة. تأكد من توافق اتصال الصوت، والتعرف على الكلام ، وصوت الاستجابة، ومعالجة المقاطعات قبل اختيار حزمة نماذج الصوت. لا يُعدّ جمع بيانات لوحة مفاتيح SHML دليلاً على بث الصوت ثنائي الاتجاه. يجب أن يُحسم هذا القرار من خلال تكامل موثق للوسائط.
ابدأ بتذكير محدود أو تحويل بشري. أضف المحادثة الصوتية المباشرة فقط بعد التحقق من هذا الاتصال.
ينبغي أن تكون إيصالات التسليم هي المحرك الأساسي لخطوة وكيلك التالية
تكشف سجلات رسائل Signal House عن مُعرّفات الرسائل، وعدد المقاطع، والتكلفة، واستجابات شركات الاتصالات، وتقدم عملية التسليم. استخدم هذه السجلات لفصل قبول واجهة برمجة التطبيقات عن تسليم الهاتف.
| حالة الرسالة | معنى | إجراء التطبيق المقترح |
|---|---|---|
| تم إنشاؤها | تم قبوله في دار الإشارة | احفظ مُعرّف الرسالة |
| تم إدراجه في قائمة الانتظار | في انتظار الشحن | يرجى إبقاء التسليم معلقاً |
| تم إخراجه من قائمة الانتظار | تمت إزالته من قائمة الانتظار | استمر في انتظار تقدم شركة النقل |
| أرسلت | تمت إحالته للتسليم | لا تقم بتحديد المنتج على أنه تم تسليمه |
| تسليم | تم استلام إيصال التسليم | تحديث نتيجة النقل |
| فشل | تم تسجيل خطأ | قم بالتصنيف قبل إعادة المحاولة |
لا يُعدّ تسليم الرسالة دليلاً على أن العميل قد قرأ محتواها أو فهمه. لذا، يجب فصل نتائج العمل، مثل "تم قبول الموعد"، عن حالات النقل.
لا ينبغي أن يؤدي عدم استلام الإيصال إلى إرسال رسالة نصية ثانية أو إجراء مكالمة هاتفية تلقائياً. حدد سياسة انتظار واضحة وآلية تصعيد في تطبيقك.
محادثات وكيل التسعير حسب القطاعات، وليس الردود

يبلغ سعر الرسائل النصية القصيرة المحلية (SMS) من سيجنال هاوس، ضمن باقة 10DLC لعام 2026، 0.0065 دولار أمريكي لكل رسالة صادرة، قبل إضافة رسوم شركات الاتصالات. وتضيف AT&T مبلغ 0.0035 دولار أمريكي، بينما تضيف كل من فيريزون وتي موبايل مبلغ 0.0045 دولار أمريكي. وتؤدي الباقات ذات الأحجام الأكبر إلى خفض أسعار المنصة.
| مكون التكلفة | رسوم الدخول |
|---|---|
| رسائل نصية محلية صادرة | 0.0065 دولار لكل مقطع |
| رسائل نصية صادرة مجانية | 0.0079 دولار لكل مقطع |
| التحقق من العلامة التجارية | 4.50 دولار لكل محاولة تحقق |
| تسجيل الحملة | 15 مرة واحدة |
| حملة تسويقية منخفضة الحجم | $ 1.50 شهريا |
| حملة قياسية | $ 10 شهريا |
رسوم شركة الاتصالات، ورسوم الرقم، وأي خدمات إضافية لا تدخل ضمن أسعار الرسائل الأساسية. تأكد من رسوم خدمة الرسائل متعددة الوسائط (MMS) وتجديد الرقم والمكالمات الصوتية الخاصة بحسابك قبل تمويل حركة البيانات الإنتاجية.
لنفترض وجود 10,000 رسالة محلية صادرة من شريحة واحدة، تُفرض عليها رسوم شركة اتصالات قدرها 0.0045 دولار. تبلغ رسوم المنصة 65 دولارًا، ورسوم شركة الاتصالات 45 دولارًا، ليصبح المجموع 110 دولارات قبل احتساب تكاليف الأرقام والتسجيل وحركة البيانات الواردة والمكالمات الصوتية والنموذج. هذا مثال توضيحي، وليس عرض سعر نهائي.
والآن، أضف مستوى تفصيل النموذج. تتسع رسائل GSM 7 لـ 160 وحدة ترميز في مقطع واحد، أو 153 وحدة لكل جزء بعد دمجه. بينما تسمح رسائل UCS 2 بـ 70 وحدة في مقطع واحد و67 وحدة لكل جزء مدمج. وبالتالي، يمكن أن يؤثر محتوى Unicode بشكل كبير على التكاليف.
قم بقياس أسعار الرسائل النصية القصيرة بناءً على شرائحها قبل الإرسال، باستخدام عداد يدعم ترميز البيانات. حدد لوكيلك مدة زمنية محددة، وأرسل مواد تفصيلية عبر رابط معتمد عند الاقتضاء.
إنّ الردّ المختصر ليس مجرّد نسخة أنظف، بل على نطاق واسع، يمكنه تقليل كلٍّ من الشرائح المدفوعة والضغط على بدلات الإرسال.
الحفاظ على معدل الإنتاجية وتسليم المهام البشرية تحت السيطرة
يؤثر اختيار الحملة على السعة. يسمح خيار الحجم المنخفض المختلط من سيجنال هاوس بما يصل إلى 6,000 مقطع يوميًا، بما في ذلك حد 2,000 مقطع يوميًا لشركة تي-موبايل. لا يمكن تحويل حملة الحجم المنخفض إلى حملة عادية، بل يتطلب ذلك تسجيلًا جديدًا.
أنشئ قوائم انتظار بناءً على حدود مُعتمدة لشركات الاتصالات والعلامات التجارية والحملات، بدلاً من الاعتماد على حدٍّ عامٍّ مُفترضٍ لعدد الطلبات في الثانية. ينبغي أن يؤدي تدفق استجابات النماذج إلى إنشاء مهام مُرتبة في قائمة الانتظار، وليس إلى محاولات إرسال عشوائية.

قبل الإصدار على نطاق أوسع، يجب إجراء ثلاثة فحوصات قابلة للملاحظة:
خطط لعملية تسليم المحادثة بعناية فائقة، تمامًا كما لو كنت تحجزها. عيّن مسؤول المحادثة لشخص قبل بدء عملية التحويل، وألغِ الرسائل الآلية المُخزّنة، واعرض سياق الرسائل النصية القصيرة السابقة في واجهة المشغل. لا تُفصح عن مسؤولية المحادثة إلا من خلال إجراء صريح.
احتفظ بسجل محادثات مشترك عبر الرسائل النصية والمكالمات الصوتية. يتضمن ذلك المواعيد المعلقة، ومحاولات الاتصال السابقة، والملكية الحالية، ولكن قصر الوصول إلى المحتوى الحساس على الأدوار التي تحتاج إليه.
قم بقياس إنجاز مهام العملاء جنبًا إلى جنب مع تكلفة كل محادثة. عدد الرسائل المرسلة وحده يكافئ النشاط، وليس النتائج المفيدة.
قم ببناء طبقة الاتصالات التي يمكن لوكيلك استخدامها فعليًا
يحتاج نظام التواصل مع العملاء إلى أكثر من مجرد نموذج كفء. يوفر Signal House للمطورين مسارًا عمليًا لتحويل النصوص المُولّدة إلى رسائل نصية قصيرة ومكالمات قابلة للبرمجة، مدعومًا بسياق SDK، وخطافات الويب، وإمكانية رؤية التسليم.
ابدأ بسير عمل واحد معتمد. اربط رقمًا، وتحقق من صحة الردود، وقيد إجراءات النموذج، وتحقق من التكاليف قبل إضافة أي تعقيدات. دع النتائج العملية، لا الوعود المبهرة، هي التي تحدد متى يجب التوسع.
إذا كنت تقوم ببناء AI إذا كان العميل يحتاج إلى رسائل نصية أو مكالمات صوتية، فقم ببناء طبقة الاتصالات الخاصة به على منصة Signal House. حافظ على ذكاء تطبيقك واجعل كل تفاعل مع العميل قابلاً للمساءلة.
توصي AiMojo بـ:


