أدلة المنتج
اربط حساب Telegram
يمكنك ربط حساب Telegram الخاص بك بـ Wbiztool، إلى جانب أرقام WhatsApp. يرسل الحساب عبر API نفسه والصفحات نفسها التي يستخدمها رقم WhatsApp، ويرى الناس رسائلك رسائل Telegram عادية منك.
- API واحد لكليهما. تعمل إرسال رسالة والإرسال إلى عدة أرقام وجدولة رسالة والإرسال إلى مجموعة وإلغاء رسالة وwebhooks حالة الرسائل بالطريقة نفسها. مرّر معرّف حساب Telegram كـ
whatsapp_client. - الصفحات نفسها. يمكن الإرسال منه في الإرسال السريع والحملات والتذكيرات.
- طرق أكثر للوصول إلى الناس. أرسل إلى رقم هاتف، أو اسم مستخدم @، أو رابط t.me، أو مجموعة.
من يمكنه ذلك: يربط المالكون والمحررون حسابات Telegram ويديرونها.
قبل أن تبدأ#
- تطبيق Telegram على هاتفك، مسجّل الدخول بالحساب الذي تريد الإرسال منه.
- عنوان بريد إلكتروني مؤكد.
- باقة لا دفعات متأخرة عليها، وفيها مكان شاغر لرقم. يشغل حساب Telegram مكانًا من أماكن الأرقام في باقتك، مثل رقم WhatsApp. راجع حدود الأرقام.
- رسائل متبقية في باقتك. تستهلك كل رسالة من حساب Telegram رصيد رسالة واحدة، كما في WhatsApp.
ربط حسابك#
في صفحة الأرقام، انقر على إضافة حساب Telegram. تجده أيضًا أسفل نافذة إضافة رقم WhatsApp: هل تريد ربط حساب Telegram؟ إضافة حساب Telegram.
تعرض نافذة إضافة حساب Telegram طريقتين لتسجيل الدخول: مسح رمز QR أو رمز تسجيل الدخول. والنتيجة واحدة في الحالتين.
باستخدام رمز QR#
استخدم هذه الطريقة عندما يكون هاتفك بجانب الكمبيوتر.
افتح إضافة حساب Telegram
في صفحة الأرقام، انقر على إضافة حساب Telegram. تُفتح النافذة مع تحديد مسح رمز QR.
اعرض رمز QR
انقر على عرض رمز QR. تعرض نافذة امسح الرمز باستخدام Telegram الرمز.
افتح إضافة جهاز على هاتفك
افتح Telegram على هاتفك وانتقل إلى الإعدادات ← الأجهزة ← إضافة جهاز.
امسح الرمز
وجّه هاتفك نحو رمز QR. يتغير الرمز كل 30 ثانية: امسح أحدث رمز. عندما ينجح تسجيل الدخول، تعرض النافذة تم ربط حساب Telegram و"… متصل. تُرسَل الرسائل التي ترسلها منه عبر Telegram."
باستخدام رمز تسجيل الدخول#
استخدم هذه الطريقة عندما يتعذّر عليك مسح رمز QR، مثلًا عندما يكون الهاتف جهازك الوحيد.
اختر رمز تسجيل الدخول
في نافذة إضافة حساب Telegram، انقر على تبويب رمز تسجيل الدخول.
أدخل رقمك
تحقّق من دولتك تحت رمز الدولة. وتحت رقم هاتف Telegram، اكتب الرقم الذي يستخدمه حساب Telegram الخاص بك، دون رمز الدولة، مثل
9876543210. انقر على إرسال رمز تسجيل الدخول.اكتب الرمز
يرسل Telegram رمز تسجيل دخول إلى تطبيق Telegram لديك (أو برسالة SMS). في نافذة أدخل رمز تسجيل الدخول، اكتبه تحت رمز تسجيل الدخول وانقر على تسجيل الدخول. تعرض النافذة بعد ذلك تم ربط حساب Telegram.
التحقق بخطوتين#
إذا كان التحقق بخطوتين مفعّلًا في حسابك، تطلب النافذة كلمة مرور Telegram بعد رمز QR أو رمز تسجيل الدخول: أدخل كلمة مرور Telegram. اكتب كلمة مرور Telegram (السحابية) تحت كلمة مرور Telegram وانقر على تسجيل الدخول. تستخدمها Wbiztool مرة واحدة لتسجيل الدخول ولا تحفظها أبدًا.
بعد الربط#
- يحصل الحساب على بطاقة في صفحة الأرقام مع شارة Telegram ومعرّفه، مثل المعرّف 702. انقر على المعرّف لنسخه: استخدمه كـ
whatsapp_clientفي API، كما في الرقم. - انقر على إرسال رسالة تجريبية للتحقق من أنه يرسل. تحت الإرسال إلى، اكتب اسم مستخدم @ أو رقم هاتف مع رمز دولته، مثل
@nameأو +91 98765 43210. - يعمل إعادة التسمية وإزالة كما في رقم WhatsApp. راجع إدارة رقم.
الإرسال من حساب Telegram الخاص بك#
اختر حساب Telegram كأي رقم: تحت من في الإرسال السريع، أو كرقم الإرسال في حملة أو تذكير، أو بمعرّفه كـ whatsapp_client في API. تظهر رسائله في التقارير، ويبلّغ webhook في إرسال رسالة عن SENT أو FAILED كما في WhatsApp.
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 702,
"phone": "@emma_thompson",
"msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
}'
استبدل 12345 وYOUR_API_KEY و702 بقيمك الخاصة: 702 هو معرّف حساب Telegram من بطاقته.
إلى من يمكنك الإرسال#
من حساب Telegram، تقبل phone في API (وكذلك الأرقام في الإرسال السريع، وأرقام الحملة، والإرسال إلى في التذكير) أيًّا مما يلي:
| ما تكتبه | مثال | معلومة مفيدة |
|---|---|---|
| رقم هاتف مع رمز دولته | +91 98765 43210 | يجب أن يكون الشخص على Telegram. في المرة الأولى، يُضاف الرقم إلى جهات اتصال Telegram في حسابك. يرفض Telegram الأشخاص الذين يخفون أرقامهم عن الغرباء: تفشل الرسالة مع "Not on Telegram, or their privacy settings hide this number". |
| اسم مستخدم @ | @emma_thompson | اسم مستخدم الشخص في Telegram. |
| رابط t.me | t.me/emma_thompson | مثل اسم المستخدم @. ويعمل https://t.me/emma_thompson أيضًا. |
tg:<id> | tg:5012345678 | الطريقة التي يسمّي بها صندوق الوارد وwebhooks الخاصة به شخصًا لا يُظهر رقمًا ولا اسم مستخدم. استخدمه للرد عليه. |
لا تعمل أسماء المستخدمين وروابط t.me وtg:<id> إلا من حساب Telegram. من رقم WhatsApp، تجيب إرسال رسالة وجدولة رسالة بـ "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client"، ويتخطّاها الإرسال إلى عدة أرقام.
أي حساب يختاره API#
عندما تحذف whatsapp_client، تستخدم إرسال رسالة الرقم المتصل الوحيد، مع تقديم WhatsApp أولًا:
- يُستخدم رقم WhatsApp المتصل الوحيد، حتى لو كان حساب Telegram متصلًا أيضًا. لا تنقل إضافة حساب Telegram تكاملاتك الحالية إليه.
- لا يُستخدم حساب Telegram إلا عندما لا يكون أي رقم WhatsApp متصلًا.
- يستخدم اسم المستخدم @ حساب Telegram المتصل الوحيد.
للإرسال من حساب Telegram في أي حالة أخرى، مرّر معرّفه كـ whatsapp_client.
المجموعات#
من حساب Telegram، تقبل group_name (وكذلك مجموعات في الإرسال السريع):
- اسم المستخدم @ لمجموعة عامة أو رابط t.me لها، مثل
@lumen_clubأوt.me/lumen_club، أو - الاسم الدقيق لمجموعة أو قناة ينتمي إليها الحساب، مثل
Lumen VIP Club. لا يهم الفرق بين الأحرف الكبيرة والصغيرة.
يجب أن يكون الحساب عضوًا بالفعل في المجموعة ومسموحًا له بالنشر فيها. فهو لا ينضم إلى أي مجموعة من تلقاء نفسه.
- إذا لم تطابق أي مجموعة، تفشل الرسالة مع "Group not found".
- إذا تعذّر على الحساب النشر هناك، تفشل الرسالة مع "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".
حدود Telegram#
يحدّ Telegram من عدد الأشخاص الذين يمكن للحساب مراسلتهم ممن لم يتواصلوا معه. والحسابات الجديدة هي الأكثر تقييدًا.
- عندما يطلب Telegram الإبطاء، يتوقف الحساب مؤقتًا وتنتظر رسائله. وتُرسَل بعد انتهاء التوقف.
- عندما يقيّد Telegram الرسائل إلى الغرباء، تفشل تلك الرسالة مع "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour"، ويستريح الحساب لمدة ساعة.
صندوق الوارد (Unibox)#
يمكن إضافة حساب Telegram إلى صندوق الوارد Unibox مثل أي رقم: في أرقام صندوق الوارد، انقر على إضافة رقم إلى صندوق الوارد واختره. يستخدم الحساب رقمًا من أرقام صندوق الوارد في إضافة Unibox لديك، مثل رقم WhatsApp.
- تظهر محادثاته الخاصة في صندوق الوارد: الرسائل التي يتلقاها، والرسائل المرسلة من الهاتف أو من Wbiztool. تحمل المحادثات القادمة من Telegram علامة Telegram.
- تُنسخ الملفات حتى 16 MB إلى صندوق الوارد.
- تعمل الردود حتى مع الأشخاص الذين يخفون أرقامهم.
- لا تظهر أبدًا المجموعات والقنوات والرسائل المحفوظة (Saved Messages) ومحادثة خدمة Telegram نفسه (التي تصل فيها رموز تسجيل الدخول).
يرسل webhook الخاص بحساب في صندوق الوارد رسائله كما يفعل webhook الرقم. تكون قيمة platform في الحمولة telegram، ويكون contact.phone وmessage.from رقم الشخص أو @username أو tg:<id>: أرسل ردك إلى تلك القيمة كـ phone. راجع الحمولة.
الفصل وإعادة الربط#
- يوقف فصل في البطاقة الحساب عن الإرسال. ويسجّل أيضًا خروج Wbiztool من قائمة أجهزة الحساب في Telegram.
- إذا أنهى Telegram الجلسة، مثلًا عندما تسجّل خروج Wbiztool تحت الإعدادات ← الأجهزة، أو يُسجَّل خروج الحساب من كل الأجهزة، تعرض البطاقة غير متصل. ويتلقى المالكون والمحررون تنبيه انقطاع مصاغًا لـ Telegram، كما في رقم WhatsApp. راجع تنبيهات انقطاع اتصال WhatsApp.
- ما دام الحساب غير متصل، تنتظر رسائله تحت في انتظار الإرسال.
- لربطه مجددًا، انقر على إعادة الربط في بطاقته وسجّل الدخول مرة أخرى، برمز QR أو برمز تسجيل الدخول.
غير متاح بعد#
- تصدير أعضاء مجموعات Telegram. يعمل تصدير أعضاء المجموعات مع مجموعات WhatsApp فقط.
- مجموعات Telegram في صندوق الوارد Unibox. لا تظهر فيه إلا المحادثات الخاصة.
استكشاف الأخطاء وإصلاحها#
| المشكلة | ما يجب فعله |
|---|---|
| لا يوجد زر إضافة حساب Telegram | أنت محلل في مساحة العمل هذه. اطلب من أحد المالكين أن يفعل ذلك أو أن يجعلك محررًا. |
| زر إضافة حساب Telegram رمادي | مرّر المؤشر فوقه لمعرفة السبب: بريدك الإلكتروني غير مؤكد، أو كل أماكن الأرقام في باقتك مستخدمة، أو هناك دفعة متأخرة على الباقة. تنطبق القواعد نفسها كما في الأرقام، راجع حدود الأرقام. |
| لا يعمل رمز QR | يتغير كل 30 ثانية: امسح أحدث رمز، في Telegram تحت الإعدادات ← الأجهزة ← إضافة جهاز. إذا عرضت النافذة "استغرق تسجيل الدخول وقتًا طويلًا. ابدأ من جديد."، فانقر على البدء من جديد. |
| "هذا الرمز غير صحيح. تحقّق من أحدث رمز أرسله Telegram وحاول مرة أخرى." | اكتب أحدث رمز تسجيل دخول من تطبيق Telegram لديك (أو من رسالة SMS). |
| "انتهت صلاحية الرمز. ابدأ من جديد للحصول على رمز جديد." | انقر على البدء من جديد واكتب الرمز الجديد. |
| "كلمة المرور هذه غير صحيحة. حاول مرة أخرى." | اكتب كلمة مرور Telegram الخاصة بالتحقق بخطوتين في الحساب، لا رمز تسجيل الدخول. |
| "لا يوجد حساب Telegram لهذا الرقم." | تحقّق من الدولة والرقم، أو سجّل الدخول برمز QR. |
| "يطلب Telegram الانتظار قبل المحاولة مرة أخرى. حاول لاحقًا." | انتظر بعض الوقت، ثم سجّل الدخول مجددًا. |
| فاشلة مع "Not on Telegram, or their privacy settings hide this number" | الشخص ليس على Telegram، أو يخفي رقمه عمّن لا يعرفهم. أرسل إلى اسم المستخدم @ الخاص به بدلًا من ذلك، أو اطلب منه أن يراسل حسابك أولًا ثم ردّ عليه من صندوق الوارد. |
| فاشلة مع "Group not found" | تحقّق من الاسم الدقيق للمجموعة، أو استخدم اسم المستخدم @ أو رابط t.me الخاص بها. يجب أن يكون الحساب عضوًا في المجموعة. |
| فاشلة مع "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)" | انضم إلى المجموعة في Telegram بهذا الحساب أولًا. وإذا كان المشرفون وحدهم يستطيعون النشر، فاطلب ذلك من أحد مشرفي المجموعة. |
| فاشلة مع "Telegram limited this account: …" | راجع حدود Telegram. يُستأنف الإرسال بعد ساعة. |
| يجيب API بـ "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client" | مرّر معرّف حساب Telegram كـ whatsapp_client. راجع أي حساب يختاره API. |
| تعرض البطاقة غير متصل | أنهى Telegram الجلسة. انقر على إعادة الربط وسجّل الدخول مرة أخرى. |
