أرسل الرسائل القصيرة وواتساب عبر حساب Twilio الخاص بك
اربط Twilio لإرسال دعوات الاستطلاعات بالرسائل القصيرة وواتساب من أرقامك الخاصة، واستقبال الردود في المحادثات، ورؤية حالة تسليم كل رسالة.
في هذه الصفحة
اربط حساب Twilio، وسيرسل Polzy الرسائل القصيرة ورسائل واتساب الخاصة بمساحة العمل هذه — دعوات الحملات وتذكيراتها، ورسائل سير العمل، والردود في المحادثات — من أرقام Twilio الخاصة بك. ويستطيع الناس الرد: تصل الردود إلى المحادثة في Polzy، ويُظهر سجل كل رسالة ما إذا كانت قد سُلّمت.
الرسائل القصيرة وواتساب متاحة في خطة أعمال وما فوقها، ولا يربط المزوّد إلا المسؤولون. اربط Twilio من صفحة التكاملات، أو من الرسائل ← التكاملات.
قبل أن تبدأ
تحتاج إلى:
- مساحة عمل في خطة أعمال أو أعلى، ودور المسؤول فيها.
- حساب Twilio مدفوع (وليس تجريبيًا)، فيه رقم قادر على إرسال الرسائل القصيرة، أو Messaging Service.
- لواتساب: مرسل واتساب مسجّل في Twilio (راجع واتساب).
- أرقام الهواتف المحمولة للمشاركين في سجلاتهم. يحفظها Polzy بالصيغة الدولية، مثل
+971 50 123 4567؛ ويُقرأ الرقم المكتوب دون رمز الدولة في بلد مؤسستك، البلد المذكور في بيانات الفوترة.
كيف يستخدم Polzy خدمة Twilio
- الرسائل القصيرة وواتساب. بمجرد اختيار Twilio للرسائل القصيرة أو واتساب أو كليهما، تمرّ كل رسالة ترسلها مساحة العمل على تلك القناة عبر حسابك.
- الردود. عندما يرد شخص ما، يُضاف رده إلى محادثته المفتوحة في Polzy (راجع المحادثات).
- التسليم. يُظهر سجل كل رسالة في الرسائل حالة تم التسليم أو فشل، مع السبب الذي يذكره Twilio.
- التكلفة. يحاسبك Twilio على هذه الرسائل. ولا تُحتسب ضمن الرسائل الشهرية لمؤسستك في Polzy، التي تخص مرسل Polzy وحده.
الخطوة 1: إعداد Twilio
- في Twilio Console، اشترِ رقمًا قادرًا على إرسال الرسائل القصيرة إلى الدول التي تحتاجها، أو أنشئ Messaging Service من Messaging → Services وأضف أرقامك إلى الـ sender pool الخاص به. يختار الـ Messaging Service الرقم المناسب لكل رسالة.
- انسخ Account SID وAuth Token من Account Info في الصفحة الرئيسية للـ Console.
- إذا كنت ترسل إلى دول أخرى، فتأكد من أنها مسموح بها في الأذونات الجغرافية للرسائل القصيرة (geo permissions) في حسابك.
راجع Twilio: Messaging Services.
الخطوة 2: اربط Twilio في Polzy
- افتح التكاملات في الشريط الجانبي، ثم تبويب متاحة، وانقر على ربط في صف Twilio. أو افتح الرسائل ثم تبويب التكاملات، وانقر على إعداد في Twilio.
- في لوحة ربط Twilio، املأ الحقول:
| الحقل | ما تُدخله |
|---|---|
| Account SID | يبدأ بـ AC. مطلوب. |
| Auth Token | مطلوب. يستخدمه Polzy أيضًا للتأكد من أن إيصالات التسليم والردود تأتي من Twilio. |
| Messaging Service SID | يبدأ بـ MG. موصى به للرسائل القصيرة. |
| رقم هاتف المرسل | رقم من Twilio بالصيغة الدولية، إذا لم تكن تستخدم Messaging Service. |
| رقم WhatsApp الخاص بالمرسل | رقم مرسل واتساب، مثل +15550000000، لواتساب. |
أدخل Messaging Service SID أو رقم هاتف المرسل: يحتاج Polzy إلى أحدهما، حتى لو كنت ترسل واتساب فقط. وإذا مُلئ الاثنان، يُستخدم الـ Messaging Service للرسائل القصيرة.
- انقر على اختبار الاتصال. يجب أن ترى Connected to Twilio account: متبوعًا باسم حسابك (تظهر هذه الرسالة بالإنجليزية).
- انقر على ربط.
الخطوة 3: اختر Twilio للرسائل القصيرة وواتساب
- افتح الإعدادات ثم تبويب الإشعارات، وانتقل إلى القنوات.
- في صف الرسائل النصية القصيرة، غيّر Polzy · حساب مشترك إلى Twilio، وتأكد أن مفتاح التبديل مفعّل.
- لإرسال واتساب أيضًا، افعل الشيء نفسه في صف واتساب.
بعدها ترسل الحملة عبر Twilio عندما تختار الرسائل النصية القصيرة أو واتساب قناةً لها في تبويب الإرسال. تستخدم الحملة قناة واحدة.
الخطوة 4: استقبل الردود
لا تحتاج إيصالات التسليم إلى شيء آخر: يطلب Polzy من Twilio رد حالة (status callback) مع كل رسالة يرسلها. أما الردود فتحتاج إعدادًا واحدًا في Twilio.
- في Polzy، افتح صفحة Twilio من التكاملات وابحث عن الاستقبال. انسخ العنوان الظاهر هناك.
- في Twilio Console، افتح إعدادات الرسائل لرقمك واضبط ويب هوك الرسائل الواردة ("a message comes in") على ذلك العنوان، بطريقة HTTP POST. وإذا كنت تستخدم Messaging Service، فاضبطه في إعدادات التكامل الخاصة بالخدمة بدلًا من ذلك. ولواتساب، اضبطه على مرسل واتساب.
- الصق العنوان كما يظهر تمامًا: يوقّع Twilio كل طلب مع العنوان، فيفشل التحقق إذا تغيّر العنوان.
يُضاف رد الشخص الذي لديه محادثة مفتوحة على تلك القناة إليها، ويُبلَّغ من فتح المحادثة. أما رسالة أي شخص آخر فلا تظهر في Polzy. راجع Twilio: Messaging webhooks.
واتساب
تمرّ رسائل واتساب عبر مرسل واتساب تسجّله في Twilio Console من Messaging → Senders → WhatsApp senders: تربط حساب WhatsApp Business عبر Meta، وتتحقق من الرقم، وتُكمل التحقق التجاري لدى Meta قبل الانتقال إلى الإنتاج. أدخل الرقم في Polzy في حقل رقم WhatsApp الخاص بالمرسل. راجع Twilio: Register WhatsApp senders using Self Sign-up.
لا يسمح واتساب للشركة بالكتابة بحرية إلا خلال 24 ساعة من آخر رسالة من الشخص. وخارج هذه النافذة لا يقبل إلا قالبًا اعتمدته Meta، ويرفض Twilio أي شيء آخر بالخطأ 63016. ما يعنيه ذلك في Polzy:
- دعوات الحملات تُرسل كرسائل عادية، لذا لا يسلّمها واتساب إلا لمن راسل رقم واتساب الخاص بك خلال آخر 24 ساعة. أما للآخرين فتفشل الرسالة بالخطأ 63016. للتواصل الأول، أرسل عبر الرسائل القصيرة أو البريد الإلكتروني.
- المحادثات. خلال 24 ساعة من آخر رسالة من الشخص، ردّ بحرية. وبعدها يعرض Polzy يسمح واتساب بالردود الحرة فقط خلال 24 ساعة من آخر رسالة لهم. أرسل قالبًا معتمدًا لإعادة فتحها.
- القوالب. لا يرسل Twilio القالب المعتمد إلا بمعرّف المحتوى الخاص به، وهو ما لا يرسله Polzy: القالب الذي تختاره عبر إرسال القالب يخرج من Twilio كنص عادي، فيرفضه Twilio خارج النافذة. مع Twilio تستمر المحادثة عندما يكتب الشخص مجددًا.
راجع Twilio: Send WhatsApp notification messages with templates وTwilio: Error 63016.
الحدود والتكاليف
- أجزاء الرسالة القصيرة. تتسع الرسالة القصيرة لـ 160 حرفًا، أو 70 إذا احتوى النص على حرف خارج أبجدية GSM القياسية — رمز تعبيري، أو كتابة مثل العربية. تُرسل الرسالة الأطول على أجزاء، ويحاسب Twilio على كل جزء.
- ساعات الهدوء. عند تفعيل احترام ساعات الهدوء في الإعدادات ← الإشعارات، تنتظر رسائل الحملات حتى الساعة 08:00 بتوقيت المستلم بدلًا من الخروج بين 20:00 و08:00.
- حدود حسابك. تنطبق حدود الإرسال وقواعد الدول الخاصة بـ Twilio.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب، وما العمل |
|---|---|
| Authenticate | رفض Twilio Account SID وAuth Token. انسخهما مجددًا؛ وإذا تغيّر الرمز في Twilio فاستخدم الجديد. |
| Either Messaging Service SID or From Number is required | أدخل Messaging Service SID أو رقم هاتف المرسل. |
| تفشل الرسائل مع Permission to send an SMS has not been enabled for the region | اسمح بتلك الدولة في الأذونات الجغرافية للرسائل القصيرة في حساب Twilio. |
| تفشل رسائل واتساب بالخطأ 63016 | لم يراسل الشخص رقم واتساب الخاص بك خلال آخر 24 ساعة (راجع واتساب). |
| الرسائل القصيرة غير متاحة في الحملة | الرسائل النصية القصيرة معطّلة أو بلا مزوّد في الإعدادات ← الإشعارات ← القنوات. |
| لا تصل الردود | تحقق من ويب هوك الرسائل الواردة في Twilio، ومن أن العنوان لُصق تمامًا. يعرض قسم النشاط في صفحة Twilio تم رفض رسالة واردة عند فشل التحقق، مثلًا بعد تغيير Auth Token في Twilio دون تغييره في Polzy. |
معلومات مفيدة
- Auth Token جديد. إذا غيّرت Auth Token في Twilio، فأدخل الجديد في Polzy (تهيئة) فورًا: يستخدمه الإرسال وإيصالات التسليم والردود جميعًا.
- مرسل Polzy. من دون مزوّد خاص، تخرج الرسائل القصيرة باتجاه واحد من مرسل Polzy المشترك، وتُحتسب ضمن الرسائل الشهرية لمؤسستك، ولا يمكن الرد عليها. ويمرّ واتساب عبر حساب Telnyx أو Twilio الخاص بك إلى أن يُوثَّق رقم واتساب الخاص بـ Polzy.
- إذا توقف Twilio عن العمل، يواصل Polzy المحاولة ويضع عليه حالة يحتاج إلى انتباه. وإذا قطعت اتصاله، تعود الرسائل القصيرة إلى مرسل Polzy المشترك.
- ما يحتفظ به Polzy. يُحفظ Auth Token مشفّرًا ولا يُعرض مجددًا.
روابط مفيدة
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.