انتقل إلى المحتوى
WbizTool

أدلة المنتج

أرقام صندوق الوارد وwebhooks الرسائل الواردة

في صفحة أرقام صندوق الوارد تختار أيًّا من أرقام WhatsApp الخاصة بك تتم مزامنتها مع صندوق الوارد Unibox، حيث يقرأ فريقك محادثاتها ويرد عليها. أعطِ الرقم رابط webhook، وستُرسل WbizTool أيضًا كل رسالة جديدة يستلمها أو يرسلها إلى خادمك بصيغة JSON موقّعة: سجّل المحادثات في نظام CRM، أو نبّه فريقك أو شغّل ردًا تلقائيًا.

تبني المستقبِل؟ انتقل إلى كيف تصل webhooks والتحقق من التوقيع والحمولة.

من يمكنه ذلك: يضيف المالكون والمحررون الأرقام، ويغيّرون webhooks ويرون المفتاح السري لـ webhook. لا يرى المحللون أرقام صندوق الوارد في الشريط الجانبي. يتطلب ذلك إضافة Unibox: 20 دولارًا شهريًا أو 200 دولار سنويًا بأسعار القائمة الأمريكية لكل رقم في صندوق الوارد (يظهر سعرك في الفوترة والباقات)، ويضيفها المالك إلى باقة مدفوعة أو باقة مدى الحياة في الفوترة والباقات (راجع الإضافات). كميتها هي عدد الأرقام التي يمكن أن تكون في صندوق الوارد في الوقت نفسه.

افتح أرقام صندوق الوارد ضمن صندوق الوارد في الشريط الجانبي، أو انتقل إلى /unibox/listeners/.

صفحة أرقام صندوق الوارد في نافذة متصفح، مع تحديد “أرقام صندوق الوارد” في الشريط الجانبي: أرقام صندوق الوارد المستخدمة 2 من 3، ورابط “دليل webhook”، وزر “إضافة رقم إلى صندوق الوارد” وبطاقتا رقمين، إحداهما ترسل إلى webhook خاص بها والأخرى إلى Zap في Zapier

قبل أن تبدأ#

  • إضافة Unibox مع رقم متاح في صندوق الوارد: يعرض السطر تحت عنوان الصفحة مثلًا "أرقام صندوق الوارد المستخدمة: 2 من 3 (إضافة Unibox)"، أو "لا توجد إضافة Unibox" (راجع بدون إضافة Unibox).
  • رقم WhatsApp مربوط برمز QR أو برمز الربط، يظهر بالحالة متصل في أرقام WhatsApp. لا يمكن إضافة الأرقام المتصلة عبر إضافة المتصفح. ويمكن إضافة حساب Telegram متصل مثل أي رقم.
  • لـ webhook: عنوان https://‎ لا يتجاوز 500 حرف على الإنترنت العام (لا localhost ولا شبكة خاصة)، يقبل طلبات POST بجسم JSON ويجيب بـ 2xx خلال 8 ثوانٍ.

إضافة رقم إلى صندوق الوارد#

  1. افتح مربع الحوار

    انقر على إضافة رقم إلى صندوق الوارد أعلى يسار الصفحة.

  2. اختر الرقم

    اختره تحت رقم WhatsApp. تعرض القائمة أرقامك المتصلة التي ليست في صندوق الوارد بعد.

  3. أضف webhook (اختياري)

    اكتب عنوانك تحت رابط Webhook (اختياري). يظهر عندها الرسائل المراد إرسالها: أبقِ الرسائل المستلمة أو الرسائل المُرسَلة أو كليهما محددًا. يمكنك إضافة webhook أو تغييره لاحقًا.

    مربع الحوار “إضافة رقم إلى صندوق الوارد”: أرقام صندوق الوارد المستخدمة 2 من 3، ورقم “البيع بالجملة” مختار تحت “رقم WhatsApp” (2)، ورابط webhook مكتوب (3)، و“الرسائل المستلمة” و“الرسائل المُرسَلة” محددتان، وزر “إضافة الرقم” محاط بإطار (4)
  4. أضِفه

    انقر على إضافة الرقم. تظهر الرسالة "تمت إضافة الرقم – تبدأ مزامنة محادثاته خلال بضع دقائق." إذا أدخلت رابط webhook، يُفتح المفتاح السري لـ webhook الخاص بك: انقر على نسخ واحفظ المفتاح السري حيث يستطيع خادمك قراءته. يمكنك إظهاره مرة أخرى لاحقًا في إعدادات webhook.

  • الرسائل الجديدة فقط. تبدأ مزامنة الرقم من لحظة إضافته: لا تُستورد الرسائل الأقدم ولا تُرسَل.
  • كل الأرقام مستخدمة؟ يعرض مربع الحوار "كل أرقام صندوق الوارد لديك مستخدمة. أوقف رقمًا أو أزله، أو أضف المزيد إلى إضافة Unibox." أوقف رقمًا أو أزله، أو اطلب من أحد المالكين زيادة كمية الإضافة (عرض الإضافات).
  • إعادة إضافة رقم أُزيل تعيد صندوق الوارد الخاص به ("تمت إعادة إضافة الرقم – تتم مزامنة محادثاته مجددًا من الآن فصاعدًا.")؛ ولا تُلتقط الرسائل التي وصلت أثناء إزالته. مع رابط webhook، يحتفظ الرقم بمفتاحه السري السابق إن كان له مفتاح (استخدم إظهار في إعدادات webhook)؛ وإلا فيُفتح المفتاح السري لـ webhook الخاص بك بمفتاح جديد.

ما تعرضه بطاقة الرقم#

تعرض كل بطاقة الرقم، ووقت آخر فحص أجرته WbizTool عليه بحثًا عن رسائل ("آخر فحص قبل 1 د"، أو لم يُفحص قط)، والرسائل وجهات الاتصال المتزامنة (كل محادثة تمت مزامنتها منه، بما فيها المحادثات التي ليس لها رسائل في صندوق الوارد)، وآخر رسالة، وWebhook: الرابط وما يرسله، مثل "يرسل كل رسالة مستلمة ومُرسَلة · موقّع بمفتاح سري"، أو "لا يوجد – تظهر الرسائل في صندوق الوارد فقط." وتعني شارة Zapier أن Zap يتلقى الرسائل (راجع Zapier وأرقام صندوق الوارد).

تبيّن الشارة أعلى يسار البطاقة ما يفعله الرقم:

الشارةالمعنى
قيد المزامنةيُفحص مرة في الدقيقة تقريبًا؛ وتصل الرسائل الجديدة إلى صندوق الوارد وإلى webhook الخاص بك.
لم يُفحص مؤخرًا"لم يُفحص خلال آخر 15 دقيقة – مثلًا أثناء إرسال الرقم لحملة، مما يوقف فحص صندوق الوارد مؤقتًا. إذا استمر ذلك، فتواصل مع الدعم." تُلتقط الرسائل بعد انتهاء الإرسال.
الرقم غير متصل"رقم WhatsApp غير متصل، لذا لا يصل أي جديد." انقر على أعد ربطه.
متوقفأوقفته أنت، أو أوقفته WbizTool عندما انتهت الإضافة أو صارت تغطي أرقامًا أقل (راجع عندما تنتهي الإضافة). لا تتم مزامنة شيء ولا يُرسَل شيء.
معلّق"تمت إضافته (مثلًا عبر Zapier) بينما كان الرقم غير متصل. لن تتم مزامنته حتى يتم تشغيله." أعد ربط الرقم إذا لزم الأمر، ثم انقر على تشغيل.

تغيير رابط webhook أو الرسائل المُرسَلة إليه#

  1. افتح إعدادات webhook

    انقر على إعدادات webhook في بطاقة الرقم.

  2. غيّر الإعدادات

    عدّل رابط Webhook (اختياري) والتحديدات تحت الرسائل المراد إرسالها. لإيقاف webhook، امسح الرابط.

  3. احفظ

    انقر على حفظ. تظهر الرسالة "تم حفظ إعدادات webhook."

    مربع الحوار “Webhook – طلبات المتجر”: رابط webhook (2)، و“الرسائل المراد إرسالها” مع تحديد “الرسائل المستلمة” وعدم تحديد “الرسائل المُرسَلة”، و“المفتاح السري لـ Webhook” مخفيًا مع “إظهار” و“إعادة الإنشاء”، وزر “حفظ” محاط بإطار (3)
  • تغيير الرابط يُبقي المفتاح السري. أما مسح الرابط فيحذفه؛ والرابط الذي يُضاف لاحقًا يحصل على مفتاح سري جديد، يُعرض مرة واحدة في المفتاح السري لـ webhook الخاص بك.
  • إذا لم يكن أي من المربعين محددًا، تعرض البطاقة "لم يتم اختيار أي أحداث – لا يُرسَل شيء".

إظهار المفتاح السري أو إعادة إنشائه#

المفتاح السري 32 حرفًا ورقمًا. في إعدادات webhook، تحت المفتاح السري لـ Webhook، يكشفه إظهار مع نسخ بجانبه. يسأل إعادة الإنشاء "هل تريد إنشاء مفتاح سري جديد؟ سيتوقف المفتاح الحالي عن العمل فورًا – حدّثه أينما تتحقق من التوقيعات." انقر على إنشاء مفتاح سري جديد: يُحفظ فورًا ("تم إنشاء مفتاح سري جديد.")، دون حفظ، ويُوقَّع به كل طلب من ذلك الحين، بما في ذلك إعادة محاولات الرسائل السابقة.

إيقاف رقم أو تشغيله أو إزالته#

الزرما يحدث
إيقافبعد أن تؤكد، تتوقف مزامنة محادثاته ولا يُرسَل شيء. لا يعود يستخدم أحد أرقام صندوق الوارد لديك؛ وتُحفظ إعداداته.
تشغيلتتم مزامنته ويُرسِل مجددًا، مستخدمًا أحد أرقام صندوق الوارد لديك. تُضاف الرسائل التي وصلت أثناء إيقافه إلى صندوق الوارد، حتى 30 يومًا للوراء، لكنها لا تُرسَل: لا يصل إلى webhook الخاص بك إلا ما يصل من رسائل منذ لحظة النقر على تشغيل. بعد إيقاف لأقل من ساعة، تُرسَل هي أيضًا. يكون تشغيل رماديًا بدون الإضافة ("يتطلب إضافة Unibox") أو بدون رقم متاح في صندوق الوارد ("كل أرقام صندوق الوارد لديك مستخدمة – أوقف رقمًا آخر أو أزله أولًا").
إزالةيسأل "إزالة … من صندوق الوارد؟" تتوقف مزامنة محادثاته ويتم إيقاف webhook الخاص به؛ وتبقى المحادثات التي تمت مزامنتها بالفعل في صندوق الوارد. أضفه مرة أخرى لإعادته.

تُسقَط webhooks التي تنتظر إعادة المحاولة عندما توقف الرقم أو تزيله أو تغيّر رابطه.

كيف تصل webhooks#

  • متى: يُفحص كل رقم في صندوق الوارد مرة في الدقيقة تقريبًا ما دام متصلًا؛ ويتوقف الفحص مؤقتًا أثناء إرساله للرسائل، مثل حملة. تُرسَل الرسالة بعد الفحص الذي يعثر عليها، عادةً خلال دقيقة أو دقيقتين. لا يوجد زر اختبار: أرسل رسالة إلى الرقم من هاتف آخر.
  • طلب واحد لكل رسالة: message_received لـ الرسائل المستلمة؛ وmessage_sent لـ الرسائل المُرسَلة، المرسلة من الهاتف أو WhatsApp Web أو من WbizTool (الحملات وAPI والتذكيرات). أما الردود المرسلة من صندوق الوارد Unibox فلا تُرسَل عادةً: صندوق الوارد يحتوي عليها بالفعل.
  • النجاح: أي حالة 2xx خلال 8 ثوانٍ. لا تُتبع عمليات إعادة التوجيه: تُحتسب 3xx فشلًا.
  • إعادة المحاولة: تُعاد محاولة انتهاء المهلة، أو خطأ الاتصال، أو 429 أو 5xx 3 مرات، بعد 30 ثانية ثم دقيقة ثم دقيقتين. أما الإجابات الأخرى، مثل 400 أو 404، وشهادة TLS غير الصالحة فلا تُعاد محاولتها.
  • 410 Gone: توقف WbizTool webhook الخاص بالرقم (يُزال الرابط والمفتاح السري؛ ولـ hook من Zapier، يعود webhook السابق الخاص بك). ويواصل الرقم المزامنة مع صندوق الوارد.
  • الترتيب والتكرار: قد تصل الطلبات بغير ترتيبها، ونادرًا مرتين. رتّب حسب message.whatsapp_timestamp وتخطَّ أي message.id عالجته لـ whatsapp_client_id نفسه. إذا كان رقمان من أرقامك في مجموعة واحدة، يرسل كل منهما نسخته الخاصة.
  • الرسائل المتأخرة: الرسالة التي تُلتقط متأخرة، مثلًا بعد إعادة ربط الرقم أو بعد توقف مؤقت في الفحص، تُرسَل رغم ذلك، وتكون قيمة replayed فيها true إذا مضى عليها أكثر من 10 دقائق. أما الرسائل التي وصلت أثناء إيقاف الرقم فلا تُرسَل بعد تشغيل (راجع إيقاف رقم أو تشغيله أو إزالته).
  • فحص العنوان: يُفحص الرابط مرة أخرى قبل كل طلب؛ والمضيف الذي صار يشير إلى شبكة خاصة، أو لا يمكن تحليله، لا يُرسَل إليه، ولا تُعاد محاولة تلك الرسالة.

الترويسات#

الترويسةالقيمة
Content-Typeapplication/json
X-Wbiztool-Eventmessage_received أو message_sent
X-Wbiztool-Timestampوقت إجراء الطلب، بصيغة ISO 8601 بتوقيت UTC. مطابق لـ timestamp في الجسم.
X-Wbiztool-Webhook-Idمعرّف الرقم في صندوق الوارد. مطابق لـ webhook_id في الجسم.
X-Wbiztool-Signaturesha256=‎ متبوعًا بالتوقيع (راجع التحقق من التوقيع).

التحقق من التوقيع#

يُوقَّع كل طلب بالمفتاح السري لـ webhook الخاص بالرقم باستخدام HMAC-SHA256 على جسم الطلب الخام تمامًا كما وصل. يُرسَل الملخص الست عشري بأحرف صغيرة في X-Wbiztool-Signature بالشكل sha256=<digest>‎. لكل webhook مضبوط في صفحة أرقام صندوق الوارد مفتاح سري دائمًا، لذا تكون الترويسة موجودة دائمًا.

احسب التوقيع من البايتات الخام قبل تحليل JSON. فتحليل الجسم ثم إعادة ترميزه يغيّره (المسافات، والأحرف المُهرَّبة)، ولن يتطابق التوقيع.

// Express: register this route before app.use(express.json()), or the raw body is lost
import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.WBIZTOOL_WEBHOOK_SECRET;

app.post("/wbiztool/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const received = req.get("X-Wbiztool-Signature") || "";

  const a = Buffer.from(received), b = Buffer.from(expected);
  const valid = a.length === b.length && crypto.timingSafeEqual(a, b);
  if (!valid) return res.status(401).send("Invalid signature");

  const data = JSON.parse(req.body.toString("utf8"));
  if (data.event === "message_received") {
    console.log(`New message from ${data.contact.phone}: ${data.message.content}`);
  }
  res.sendStatus(200); // answer quickly; do slow work in the background
});

app.listen(3000);

لاختبار المستقبِل قبل وصول رسالة حقيقية، وقّع جسمًا بنفسك وأرسله:

BODY='{"event":"message_received","message":{"content":"Test"},"contact":{"phone":"12125550120"}}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$WBIZTOOL_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST https://your-server.example/wbiztool/webhook -H 'Content-Type: application/json' -H "X-Wbiztool-Signature: sha256=$SIG" -d "$BODY"

يغطي التوقيع الجسم، بما فيه timestamp الخاص به، الذي يتغير في كل محاولة. لرفض الطلبات المُعادة، ارفض أي timestamp مضى عليه أكثر من 5 دقائق وتخطَّ أي message.id عالجته.

الحمولة#

أمثلة على أجسام webhook
{
  "event": "message_received",
  "timestamp": "2026-10-15T10:30:31.482913+00:00",
  "replayed": false,
  "webhook_id": 51,
  "whatsapp_client_id": "101",
  "whatsapp_phone": "12125550101",
  "platform": "whatsapp",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Can I add a gift note to it?",
    "from": "12125550120",
    "from_name": "Emma Thompson",
    "to": "12125550101",
    "timestamp": "2026-10-15T10:30:04+00:00",
    "whatsapp_timestamp": 1792060204,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "12125550120",
    "lid": null,
    "phone_hidden": false,
    "name": "Emma Thompson",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "10314",
    "name": "Lumen & Wick"
  }
}

الأرقام والمعرّفات والأسماء أعلاه أمثلة. الجسم الحقيقي سطر واحد من JSON المضغوط، ويصل كل حرف خارج ASCII (الأحرف ذات العلامات، والأبجديات الأخرى، والرموز التعبيرية) كتسلسل هروب ‎\uXXXX، مثل ‎\ud83d\udcf8 لـ 📸. قد تُضاف حقول أخرى؛ تجاهل ما لا تستخدمه.

الحقول على المستوى الأعلى#

الحقلالنوعالوصف
eventstringmessage_received أو message_sent.
timestampstringوقت إجراء الطلب (ISO 8601، بتوقيت UTC).
replayedbooleanتكون true عندما تسبق الرسالة الطلب بأكثر من 10 دقائق: إرسال لاحق لما فات، مثلًا بعد إعادة ربط الرقم. وإلا فهي false. يبقى timestamp وقت الطلب.
webhook_idintegerمعرّف الرقم في صندوق الوارد.
whatsapp_client_idstringمعرّف رقم WhatsApp الخاص بك، كما في أرقام WhatsApp وفي API.
whatsapp_phonestringرقم WhatsApp الخاص بك، بالأرقام فقط.
platformstringwhatsapp، أو telegram لمحادثات حساب Telegram.
messageobjectالرسالة، راجع أدناه.
contactobjectالشخص أو المجموعة التي تدور المحادثة معها، راجع أدناه.
organisationobjectمساحة عملك: id (string) وname.
groupobjectلمحادثات المجموعات فقط: name، اسم المجموعة.

حقول message#

الحقلالنوعالوصف
idstringمعرّف WhatsApp للرسالة. استخدمه لتخطي التكرارات.
typestringchat للنص. وإلا فنوع WhatsApp، مثل image أو video أو audio أو ptt (رسالة صوتية) أو document أو sticker أو location أو vcard (بطاقة جهة اتصال) أو poll_creation أو call_log (مكالمة) أو revoked (رسالة محذوفة).
contentstringنص رسالة chat. وإلا فتسمية: ‎📸 Image أو ‎🎥 Video أو ‎🎵 Audio أو ‎🎤 Voice Message أو ‎😊 Sticker أو Document: ‎ متبوعًا بنص المستند (Document إن لم يكن له نص)، أو النوع بأحرف أولى كبيرة، مثل Location أو Call_Log. لا تُضمَّن تعليقات الصور والفيديو.
fromstringدائمًا رقم جهة الاتصال (أو معرّف المجموعة)، في الاتجاهين. يكون فارغًا عندما يخفي WhatsApp الرقم.
from_namestringاسم جهة الاتصال أو المجموعة. قد يكون فارغًا.
tostringدائمًا رقم WhatsApp الخاص بك، في الاتجاهين.
timestampstringوقت إرسال الرسالة على WhatsApp (ISO 8601، بتوقيت UTC).
whatsapp_timestampintegerالوقت نفسه بثواني Unix.
directionstringincoming أو outgoing. استخدم هذا الحقل، لا from وto، لمعرفة الاتجاه.
statusstringدائمًا pending: ليست حالة تسليم أو قراءة.
is_forwardedbooleanما إذا كانت الرسالة مُعاد توجيهها.
forwarding_scoreintegerدائمًا 0 حاليًا.
mediaobjectللصور والفيديو والصوت والرسائل الصوتية والمستندات والملصقات: filename (فارغ غالبًا للصور)، وmimetype، وsize بالبايت، وurl عندما تخزّن WbizTool نسخة.
media.urlstringرابط تنزيل موقّع تنتهي صلاحيته – بعد 3½ إلى 7 أيام – لذا نزّل الملف عند وصول webhook. استخدمه تمامًا كما أُرسل. يغيب عندما يتعذر تخزين الملف، مثل الملفات التي يزيد حجمها على 15 MB.
senderobjectلمحادثات المجموعات فقط: من كتب الرسالة – name، وphone (فارغ عندما يخفي WhatsApp رقمه) وphone_hidden (true عندما يخفيه).

حقول contact#

الحقلالنوعالوصف
whatsapp_idstringمعرّف المحادثة في WhatsApp: ‎…@c.us لشخص، و‎…@g.us لمجموعة، أو معرّف خصوصية مثل 62337239240946@lid.
phonestringالرقم بدون +، أو معرّف المجموعة. يكون فارغًا عندما يخفي WhatsApp الرقم.
lidstring or nullمعرّف الخصوصية الذي يستخدمه WhatsApp لجهة الاتصال، عندما يستخدم WhatsApp واحدًا، وإلا null.
phone_hiddenbooleantrue عندما لا يشارك WhatsApp رقم جهة الاتصال. تملأ WbizTool الرقم عندما يتيحه WhatsApp.
namestringاسم جهة الاتصال أو اسم المجموعة. قد يكون فارغًا.
is_groupbooleantrue لمحادثات المجموعات.
is_businessbooleantrue لحسابات WhatsApp Business، عندما يكون ذلك معروفًا.

Zapier وأرقام صندوق الوارد#

يستخدم مشغّل Incoming WhatsApp Message من WbizTool في Zapier هذه webhooks. يضيف تفعيل Zap الرقمَ إلى صندوق الوارد إذا لزم الأمر (مستخدمًا أحد أرقام صندوق الوارد لديك) ويوجّه webhook الخاص به إلى Zapier، للرسائل المستلمة فقط، بمفتاح سري خاص به؛ وتعرض البطاقة شارة Zapier. يعود رابط webhook الخاص بك ومفتاحه السري وتحديداته عند إيقاف Zap.

بعد ذلك يحذّر إعدادات webhook: "ينتمي هذا الـ webhook إلى Zap في Zapier. تغيير الرابط أو إزالته يمنع الـ Zap من تلقي الرسائل." ويحذّر إيقاف وإزالة أيضًا: يبقى Zap مفعّلًا في Zapier لكنه لا يتلقى شيئًا، لذا أوقفه في Zapier بدلًا من ذلك. راجع كيف يعمل المشغّل مع أرقام صندوق الوارد لديك.

بدون إضافة Unibox#

تعرض الصفحة "لا توجد إضافة Unibox" و"إضافة Unibox غير نشطة في مساحة العمل هذه."، ويفتح إضافة رقم إلى صندوق الوارد مربع إضافة Unibox مطلوبة: "لإضافة أرقام WhatsApp إلى صندوق الوارد المشترك وتلقي رسائلها عبر webhook، اشترك في إضافة Unibox." ينقر المالك على عرض الإضافات ويضيف إضافة رقم هاتف Unibox في الفوترة والباقات، على باقة مدفوعة أو باقة مدى الحياة (لا في الفترة التجريبية المجانية).

صفحة أرقام صندوق الوارد بدون الإضافة: “لا توجد إضافة Unibox”، والتنبيه الأصفر “إضافة Unibox غير نشطة في مساحة العمل هذه.” مع زر “عرض الإضافات” محاطًا بإطار، و“لا توجد أرقام في صندوق الوارد بعد”

عندما تنتهي الإضافة أو ينقطع اتصال رقم#

  • تنتهي الإضافة: يتوقف كل رقم في صندوق الوارد، فورًا أو خلال ساعة تقريبًا. تعرض البطاقات متوقف مع "متوقف لأن إضافة Unibox غير نشطة في مساحة العمل هذه." يُخبَر المالكون والمحررون بصناديق الوارد التي توقفت، في رسالة الفوترة الإلكترونية أو في التنبيه "توقفت بعض أرقام … أو ميزاتها" (مشكلات الرقم والإرسال في الإشعارات). يُحتفظ بالمحادثات وروابط webhook ومفاتيحها السرية: بعد عودة الإضافة، انقر على تشغيل لكل رقم. تُضاف حينها الرسائل التي وصلت أثناء الإيقاف إلى صندوق الوارد، حتى 30 يومًا للوراء، لكنها لا تُرسَل إلى webhook الخاص بك.
  • تغطي الإضافة أرقامًا أقل من المفعّلة: "عدد الأرقام المفعّلة أكبر مما تسمح به إضافتك. تتوقف الأرقام الزائدة الأحدث تلقائيًا خلال ساعة تقريبًا."
  • ينقطع اتصال الرقم: تعرض البطاقة الرقم غير متصل ولا تتم مزامنة شيء ولا يُرسَل شيء. بعد إعادة ربطه، تُلتقط الرسائل التي وصلت في الأثناء وتُرسَل أيضًا؛ وما مضى عليه منها أكثر من 10 دقائق تكون فيه قيمة replayed هي true.
  • يُعاد ربطه بهاتف مختلف: يستمر رقم صندوق الوارد وwebhook الخاص به للرقم الجديد (whatsapp_client_id نفسه، وwhatsapp_phone جديد) من تلك اللحظة؛ وتبقى المحادثات القديمة في صندوق الوارد كسجل.

استكشاف الأخطاء وإصلاحها#

الرسالة أو المشكلةما يجب فعله
إضافة Unibox مطلوبة، أو "يتطلب هذا إضافة Unibox."اطلب من أحد المالكين إضافة إضافة Unibox، راجع بدون إضافة Unibox.
"كل أرقام صندوق الوارد لديك مستخدمة. أوقف رقمًا أو أزله أولًا، أو أضف المزيد إلى إضافة Unibox."أوقف رقمًا لا تحتاج إليه أو أزله، أو زد كمية الإضافة. لا تُحتسب الأرقام المتوقفة.
"لا يوجد رقم WhatsApp متصل متاح للإضافة."كل رقم متصل موجود بالفعل في صندوق الوارد، أو لا يوجد رقم متصل برمز QR أو برمز الربط. انقر على اربط رقمًا.
"هذا الرقم لم يعد متصلًا. أعد ربطه، أو اختر رقمًا آخر."أعد ربطه في أرقام WhatsApp، ثم حاول مرة أخرى.
"أدخل عنوانًا كاملًا يبدأ بـ https://‎" أو "يجب أن يبدأ رابط webhook بـ https://‎"استخدم عنوان https://‎؛ لا يُقبل http://‎.
"يمكن أن يتكوّن العنوان من 500 حرف كحد أقصى."استخدم رابطًا أقصر، مثلًا دون استعلام طويل.
"يجب أن يشير رابط webhook إلى عنوان عام على الإنترنت."المضيف هو localhost، أو عنوان شبكة خاصة، أو لا يمكن تحليله. استخدم عنوانًا عامًا، أو نفقًا أثناء الاختبار.
لا تظهر أرقام صندوق الوارد في الشريط الجانبي، أو "يمكن لمالك مساحة العمل أو المحرّر فقط القيام بذلك."أنت محلل. اطلب من أحد المالكين أن يجعلك محررًا، راجع الأدوار والصلاحيات.
لا تصل أي webhooksتحقّق من أن البطاقة تعرض قيد المزامنة، وأن الرابط صحيح وأن المربع محدد تحت الرسائل المراد إرسالها. يجب أن يجيب خادمك بـ 2xx خلال 8 ثوانٍ، بشهادة صالحة. ردود صندوق الوارد لا تُرسَل.
بعض webhooks مفقودةأجاب خادمك بـ 4xx أو 3xx، أو فشلت المحاولات الثلاث كلها، أو تعذّر تحليل اسم مضيفه. تحقّق من سجلاته في وقت الرسالة المفقودة. الرسائل التي وصلت أثناء إيقاف الرقم لا تُرسَل: اقرأها في صندوق الوارد.
التوقيع لا يتطابقاستخدم الجسم الخام، لا JSON المُعاد ترميزه، والمفتاح السري الحالي. ما دام Zap يستخدم الرقم، تذهب الطلبات إلى Zapier بالمفتاح السري الخاص بـ Zapier.
يُرجع رابط وسائط خطأانتهت صلاحيته. نزّل الملفات عند وصول webhook.

صفحات ذات صلة#