كيف يمكننا المساعدة؟

تكامل خطاف الويب الوارد

تم إنشاؤه في

يتيح لك TimelinesAI أتمتة إرسال رسائل WhatsApp استجابة للأحداث أو الإجراءات في الأدوات التي تستخدمها بالفعل: CRM ، والدعم ، وأنظمة التوظيف ، وما إلى ذلك.

حدث "إرسال رسالة"

من الممكن توجيه TimelinesAI لإرسال رسالة (مع أو بدون مرفق ملف) إلى جهة اتصال معينة (يمكن أن تكون مجموعة). إذا تم توصيل حسابات WhatsApp متعددة في مساحة العمل الخاصة بك ، فمن الممكن أيضا تحديد حساب WhatsApp معين لاستخدامه لإرسال الرسالة.

لإعداد التكامل ، يجب على مالك مساحة العمل الانتقال إلى شاشة "عمليات التكامل / خطافات الويب الواردة" وإنشاء عنوان URL جديد. يجب أن ينشر النظام الخارجي الرسالة بتنسيق معين (انظر التفاصيل أدناه) إلى عنوان URL هذا.

القيود

  • الحد الأقصى لحجم المرفق هو 2 ميغابايت.
  • لا يوجد تحقق فوري من تنسيق رقم هاتف المستلم أو اتصاله بواتساب. انتقل إلى واجهة مستخدم الجداول الزمنية للتحقق من حالة إرسال / قراءة الرسائل.

إرسال الملفات عبر خطافات الويب الواردة

إرسال ملف: تنزيل مباشر مقابل خدمات استضافة الملفات

من الضروري إرسال الملفات باستخدام روابط التنزيل المباشر. هذا يسمح للمستلم باستلام الملف بالفعل.

في حين يجب استخدام خدمة استضافة الملفات حتى تتمكن من توفير رابط تنزيل مباشر. من الأفضل اختبار هذا الرابط عبر التصفح المتخفي / الخاص. عن طريق لصق الرابط في شريط البحث. إذا بدأ تنزيل الملف على الفور ، يكون الرابط مقبولا. إذا تم عرض أي نوع من صفحات الويب بدلا من ذلك ، فلا يمكن استخدام الرابط لإرسال الملفات.

الحالة مع روابط خدمة استضافة الملفات هي أنه لا يمكن تنزيل الملفات. ما يتم تنزيله وإرساله بدلا من ذلك ، هو صفحة ويب مشاركة ، مما قد يؤدي إلى ملف "تالف".

وهذا بدوره سيؤثر على رسالتك حيث لا يمكن للمستلمين الوصول إلى الوسائط التي ترسلها إليهم ، مما يجعل الملفات غير قابلة للاستخدام. وبالتالي ، من الأهمية بمكان أن تتأكد من إرسال روابط تنزيل مباشرة ، لأن ذلك سيسمح لهم بالوصول إلى الملف دون أي مشاكل.

يمكنك أيضا تشغيل هذا الاختبار عن طريق إرسال رسالة webhook إلى أحد أرقام الاختبار الخاصة بك. ستتمكن من تحديد كيفية تصرف الملف بناء على ما قمنا بمراجعته هنا ؛ إذا تلقيت رسالة خطأ مثل "الملف تالف" ، "ملف غير متوافق" ؛ أو "فشل تحميل مستند X" ، بعد النقر فوق المرفق ، فهذا رابط خدمة استضافة الملفات ويجب استبداله برابط تنزيل مباشر.

استخدام الائتمان

  • يستهلك إرسال رسالة رصيدا 1 من حصة إرسال الرسائل.
  • إرسال رسالة بنص ومرفق غير فارغ يستهلك 2 أرصدة من حصة إرسال الرسالة.
  • إذا تعذر إرسال رسالة (غير صالحة أو غير متصلة برقم WhatsApp ، خطأ في خادم WhatsApp) ، استعادة حصة إرسال الرسائل (عادة في غضون ساعتين).

معدل إرسال الرسائل

  • سيتم إرسال الرسائل مع تأخير عشوائي لمدة 2 ثانية تقريبا بين كل رسالتين (لتجنب آليات الكشف عن البريد العشوائي في WhatsApp).
  • إذا قمت بتنشيط خطافات الويب بتردد أقل من 2 ثانية ، وضع الرسائل في قائمة الانتظار وإرسالها مع تأخير. ستستهلك كل رسالة في قائمة الانتظار رصيد إرسال رسالة ، لذلك لا يمكن أن يتجاوز عدد الرسائل المدرجة في قائمة الانتظار الحصة المتوفرة.

تكوين Webhook والإجراءات

  • "تمكين Webhook" - يسمح بتعطيل خطاف الويب دون إزالته تماما
  • "إنشاء عنوان URL جديد" - سيتم إنشاء عنوان URL فريد جديد يقبل الإشعارات. لن يكون عنوان URL السابق متاحا بعد الآن.
  • "آخر محاولات إرسال" - حالة آخر محاولات تنشيط webhook
  • "سجل التنزيل" - سجل مفصل لآخر 100 محاولة تنشيط ، مفيد لاستكشاف مشكلات التنسيق وإصلاحها.

تنسيق طلب خطاف الويب

يقبل Webhook البيانات بتنسيق JSON ، عن طريق طلب POST.

  • "الإجراء" (إلزامي) - حاليا ، يتم دعم قيمة واحدة ممكنة فقط "إرسال"
  • "نص" (إلزامي) - يمكن ترك رسالة مشفرة بنص عادي UTF-8 ليتم إرسالها (لا يوجد تخفيض مدعوم ، باستثناء فاصل الأسطر "\n") فارغة ، إذا تم تحديد الملف.
  • "file_url" (اختياري) - عنوان URL متاح للجمهور لملف سيتم تنزيله وإرساله كمرفق.
  • "file_name" (اختياري) - اسم للمرفق (يجب توفيره ، إذا تم تحديد عنوان URL).

يمكن تحديد المستلم من خلال توفير إحدى المعلمات التالية:

  • "chat_id" - معرف الدردشة كما يظهر في TimelinesAI (يمكن العثور عليه في عنوان URL لصفحة الدردشة ، أو في حمولة خطاف الويب الصادر). هذا يدعم إرسال رسائل إلى مجموعة.
  • "jid" - معرف WhatsApp JID الذي يحدد جهة الاتصال أو المجموعة
  • "الهاتف" - رقم هاتف ، منسق وفقا لمعيار رقم الهاتف الدولي ، أي:
    [+] [الرمز الدليلي للبلد] [رمز المنطقة] [رقم الهاتف المحلي] (على سبيل المثال: +14151231234)
  • "chat_name" - الاسم الدقيق للدردشة كما يظهر في TimelinesAI

إذا كانت حسابات واتساب متعددة متصلة في مساحة العمل، فاستخدم المعلمة الإضافية التالية لتحديد حساب واتساب المراد استخدامه:

  • "هاتف حساب WhatsApp" (اختياري) - يحدد (كرقم هاتف ، بالتنسيق الدولي) حساب WhatsApp لناе للإرسال. إذا تم حذفه ، استخدام أحدث حساب WhatsApp نشط متصل في مساحة العمل للإرسال. ملاحظة: إذا تم تحديد المعلمة "chat_id" ، تجاهل "هاتف حساب whatsapp" ، لأن كل دردشة متصلة بالفعل بحساب WhatsApp محدد.

استجابة خطاف الويب

في حالة النجاح (تم التحقق من صحة الطلب وقبوله للإرسال) ، سيستجيب Webhook بحالة HTTP 200 و JSON ، التي تحتوي على message_id للرسالة التي تم إنشاؤها:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

في حالة حدوث خطأ ، سيستجيب Webhook بحالة HTTP 40X و JSON بتفاصيل الخطأ ، على سبيل المثال:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

امثله

مثال 1 - إرسال رسالة عبر حساب WA محدد إلى رقم هاتف محدد:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

مثال 2 - إرسال رسالة تحتوي على نص ومرفق إلى دردشة (أو مجموعة) محددة بواسطة المعرف:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://150588669.v2.pressablecdn.com/logo.png",
"file_name" : "logo.png"
}
أحدث المشاركات التي كتبها المشرف (انظر الكل)
جدول المحتويات