أدلة المنتج
أرقام صندوق الوارد وwebhooks الرسائل الواردة
في صفحة أرقام صندوق الوارد تختار أيًّا من أرقام WhatsApp الخاصة بك تتم مزامنتها مع صندوق الوارد Unibox، حيث يقرأ فريقك محادثاتها ويرد عليها. أعطِ الرقم رابط webhook، وستُرسل WbizTool أيضًا كل رسالة جديدة يستلمها أو يرسلها إلى خادمك بصيغة JSON موقّعة: سجّل المحادثات في نظام CRM، أو نبّه فريقك أو شغّل ردًا تلقائيًا.
تبني المستقبِل؟ انتقل إلى كيف تصل webhooks والتحقق من التوقيع والحمولة.
من يمكنه ذلك: يضيف المالكون والمحررون الأرقام، ويغيّرون webhooks ويرون المفتاح السري لـ webhook. لا يرى المحللون أرقام صندوق الوارد في الشريط الجانبي. يتطلب ذلك إضافة Unibox: 20 دولارًا شهريًا أو 200 دولار سنويًا بأسعار القائمة الأمريكية لكل رقم في صندوق الوارد (يظهر سعرك في الفوترة والباقات)، ويضيفها المالك إلى باقة مدفوعة أو باقة مدى الحياة في الفوترة والباقات (راجع الإضافات). كميتها هي عدد الأرقام التي يمكن أن تكون في صندوق الوارد في الوقت نفسه.
افتح أرقام صندوق الوارد ضمن صندوق الوارد في الشريط الجانبي، أو انتقل إلى /unibox/listeners/.
قبل أن تبدأ#
- إضافة Unibox مع رقم متاح في صندوق الوارد: يعرض السطر تحت عنوان الصفحة مثلًا "أرقام صندوق الوارد المستخدمة: 2 من 3 (إضافة Unibox)"، أو "لا توجد إضافة Unibox" (راجع بدون إضافة Unibox).
- رقم WhatsApp مربوط برمز QR أو برمز الربط، يظهر بالحالة متصل في أرقام WhatsApp. لا يمكن إضافة الأرقام المتصلة عبر إضافة المتصفح. ويمكن إضافة حساب Telegram متصل مثل أي رقم.
- لـ webhook: عنوان
https:// لا يتجاوز 500 حرف على الإنترنت العام (لاlocalhostولا شبكة خاصة)، يقبل طلباتPOSTبجسم JSON ويجيب بـ2xxخلال 8 ثوانٍ.
إضافة رقم إلى صندوق الوارد#
افتح مربع الحوار
انقر على إضافة رقم إلى صندوق الوارد أعلى يسار الصفحة.
اختر الرقم
اختره تحت رقم WhatsApp. تعرض القائمة أرقامك المتصلة التي ليست في صندوق الوارد بعد.
أضف webhook (اختياري)
أضِفه
انقر على إضافة الرقم. تظهر الرسالة "تمت إضافة الرقم – تبدأ مزامنة محادثاته خلال بضع دقائق." إذا أدخلت رابط webhook، يُفتح المفتاح السري لـ webhook الخاص بك: انقر على نسخ واحفظ المفتاح السري حيث يستطيع خادمك قراءته. يمكنك إظهاره مرة أخرى لاحقًا في إعدادات webhook.
- الرسائل الجديدة فقط. تبدأ مزامنة الرقم من لحظة إضافته: لا تُستورد الرسائل الأقدم ولا تُرسَل.
- كل الأرقام مستخدمة؟ يعرض مربع الحوار "كل أرقام صندوق الوارد لديك مستخدمة. أوقف رقمًا أو أزله، أو أضف المزيد إلى إضافة Unibox." أوقف رقمًا أو أزله، أو اطلب من أحد المالكين زيادة كمية الإضافة (عرض الإضافات).
- إعادة إضافة رقم أُزيل تعيد صندوق الوارد الخاص به ("تمت إعادة إضافة الرقم – تتم مزامنة محادثاته مجددًا من الآن فصاعدًا.")؛ ولا تُلتقط الرسائل التي وصلت أثناء إزالته. مع رابط webhook، يحتفظ الرقم بمفتاحه السري السابق إن كان له مفتاح (استخدم إظهار في إعدادات webhook)؛ وإلا فيُفتح المفتاح السري لـ webhook الخاص بك بمفتاح جديد.
ما تعرضه بطاقة الرقم#
تعرض كل بطاقة الرقم، ووقت آخر فحص أجرته WbizTool عليه بحثًا عن رسائل ("آخر فحص قبل 1 د"، أو لم يُفحص قط)، والرسائل وجهات الاتصال المتزامنة (كل محادثة تمت مزامنتها منه، بما فيها المحادثات التي ليس لها رسائل في صندوق الوارد)، وآخر رسالة، وWebhook: الرابط وما يرسله، مثل "يرسل كل رسالة مستلمة ومُرسَلة · موقّع بمفتاح سري"، أو "لا يوجد – تظهر الرسائل في صندوق الوارد فقط." وتعني شارة Zapier أن Zap يتلقى الرسائل (راجع Zapier وأرقام صندوق الوارد).
تبيّن الشارة أعلى يسار البطاقة ما يفعله الرقم:
| الشارة | المعنى |
|---|---|
| قيد المزامنة | يُفحص مرة في الدقيقة تقريبًا؛ وتصل الرسائل الجديدة إلى صندوق الوارد وإلى webhook الخاص بك. |
| لم يُفحص مؤخرًا | "لم يُفحص خلال آخر 15 دقيقة – مثلًا أثناء إرسال الرقم لحملة، مما يوقف فحص صندوق الوارد مؤقتًا. إذا استمر ذلك، فتواصل مع الدعم." تُلتقط الرسائل بعد انتهاء الإرسال. |
| الرقم غير متصل | "رقم WhatsApp غير متصل، لذا لا يصل أي جديد." انقر على أعد ربطه. |
| متوقف | أوقفته أنت، أو أوقفته WbizTool عندما انتهت الإضافة أو صارت تغطي أرقامًا أقل (راجع عندما تنتهي الإضافة). لا تتم مزامنة شيء ولا يُرسَل شيء. |
| معلّق | "تمت إضافته (مثلًا عبر Zapier) بينما كان الرقم غير متصل. لن تتم مزامنته حتى يتم تشغيله." أعد ربط الرقم إذا لزم الأمر، ثم انقر على تشغيل. |
تغيير رابط webhook أو الرسائل المُرسَلة إليه#
افتح إعدادات webhook
انقر على إعدادات webhook في بطاقة الرقم.
غيّر الإعدادات
عدّل رابط Webhook (اختياري) والتحديدات تحت الرسائل المراد إرسالها. لإيقاف webhook، امسح الرابط.
احفظ
- تغيير الرابط يُبقي المفتاح السري. أما مسح الرابط فيحذفه؛ والرابط الذي يُضاف لاحقًا يحصل على مفتاح سري جديد، يُعرض مرة واحدة في المفتاح السري لـ webhook الخاص بك.
- إذا لم يكن أي من المربعين محددًا، تعرض البطاقة "لم يتم اختيار أي أحداث – لا يُرسَل شيء".
إظهار المفتاح السري أو إعادة إنشائه#
المفتاح السري 32 حرفًا ورقمًا. في إعدادات webhook، تحت المفتاح السري لـ Webhook، يكشفه إظهار مع نسخ بجانبه. يسأل إعادة الإنشاء "هل تريد إنشاء مفتاح سري جديد؟ سيتوقف المفتاح الحالي عن العمل فورًا – حدّثه أينما تتحقق من التوقيعات." انقر على إنشاء مفتاح سري جديد: يُحفظ فورًا ("تم إنشاء مفتاح سري جديد.")، دون حفظ، ويُوقَّع به كل طلب من ذلك الحين، بما في ذلك إعادة محاولات الرسائل السابقة.
إيقاف رقم أو تشغيله أو إزالته#
| الزر | ما يحدث |
|---|---|
| إيقاف | بعد أن تؤكد، تتوقف مزامنة محادثاته ولا يُرسَل شيء. لا يعود يستخدم أحد أرقام صندوق الوارد لديك؛ وتُحفظ إعداداته. |
| تشغيل | تتم مزامنته ويُرسِل مجددًا، مستخدمًا أحد أرقام صندوق الوارد لديك. تُضاف الرسائل التي وصلت أثناء إيقافه إلى صندوق الوارد، حتى 30 يومًا للوراء، لكنها لا تُرسَل: لا يصل إلى webhook الخاص بك إلا ما يصل من رسائل منذ لحظة النقر على تشغيل. بعد إيقاف لأقل من ساعة، تُرسَل هي أيضًا. يكون تشغيل رماديًا بدون الإضافة ("يتطلب إضافة Unibox") أو بدون رقم متاح في صندوق الوارد ("كل أرقام صندوق الوارد لديك مستخدمة – أوقف رقمًا آخر أو أزله أولًا"). |
| إزالة | يسأل "إزالة … من صندوق الوارد؟" تتوقف مزامنة محادثاته ويتم إيقاف webhook الخاص به؛ وتبقى المحادثات التي تمت مزامنتها بالفعل في صندوق الوارد. أضفه مرة أخرى لإعادته. |
تُسقَط webhooks التي تنتظر إعادة المحاولة عندما توقف الرقم أو تزيله أو تغيّر رابطه.
كيف تصل webhooks#
- متى: يُفحص كل رقم في صندوق الوارد مرة في الدقيقة تقريبًا ما دام متصلًا؛ ويتوقف الفحص مؤقتًا أثناء إرساله للرسائل، مثل حملة. تُرسَل الرسالة بعد الفحص الذي يعثر عليها، عادةً خلال دقيقة أو دقيقتين. لا يوجد زر اختبار: أرسل رسالة إلى الرقم من هاتف آخر.
- طلب واحد لكل رسالة:
message_receivedلـ الرسائل المستلمة؛ وmessage_sentلـ الرسائل المُرسَلة، المرسلة من الهاتف أو WhatsApp Web أو من WbizTool (الحملات وAPI والتذكيرات). أما الردود المرسلة من صندوق الوارد Unibox فلا تُرسَل عادةً: صندوق الوارد يحتوي عليها بالفعل. - النجاح: أي حالة
2xxخلال 8 ثوانٍ. لا تُتبع عمليات إعادة التوجيه: تُحتسب3xxفشلًا. - إعادة المحاولة: تُعاد محاولة انتهاء المهلة، أو خطأ الاتصال، أو
429أو5xx3 مرات، بعد 30 ثانية ثم دقيقة ثم دقيقتين. أما الإجابات الأخرى، مثل400أو404، وشهادة TLS غير الصالحة فلا تُعاد محاولتها. 410 Gone: توقف WbizTool webhook الخاص بالرقم (يُزال الرابط والمفتاح السري؛ ولـ hook من Zapier، يعود webhook السابق الخاص بك). ويواصل الرقم المزامنة مع صندوق الوارد.- الترتيب والتكرار: قد تصل الطلبات بغير ترتيبها، ونادرًا مرتين. رتّب حسب
message.whatsapp_timestampوتخطَّ أيmessage.idعالجته لـwhatsapp_client_idنفسه. إذا كان رقمان من أرقامك في مجموعة واحدة، يرسل كل منهما نسخته الخاصة. - الرسائل المتأخرة: الرسالة التي تُلتقط متأخرة، مثلًا بعد إعادة ربط الرقم أو بعد توقف مؤقت في الفحص، تُرسَل رغم ذلك، وتكون قيمة
replayedفيهاtrueإذا مضى عليها أكثر من 10 دقائق. أما الرسائل التي وصلت أثناء إيقاف الرقم فلا تُرسَل بعد تشغيل (راجع إيقاف رقم أو تشغيله أو إزالته). - فحص العنوان: يُفحص الرابط مرة أخرى قبل كل طلب؛ والمضيف الذي صار يشير إلى شبكة خاصة، أو لا يمكن تحليله، لا يُرسَل إليه، ولا تُعاد محاولة تلك الرسالة.
الترويسات#
| الترويسة | القيمة |
|---|---|
Content-Type | application/json |
X-Wbiztool-Event | message_received أو message_sent |
X-Wbiztool-Timestamp | وقت إجراء الطلب، بصيغة ISO 8601 بتوقيت UTC. مطابق لـ timestamp في الجسم. |
X-Wbiztool-Webhook-Id | معرّف الرقم في صندوق الوارد. مطابق لـ webhook_id في الجسم. |
X-Wbiztool-Signature | sha256= متبوعًا بالتوقيع (راجع التحقق من التوقيع). |
التحقق من التوقيع#
يُوقَّع كل طلب بالمفتاح السري لـ 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);# Flask
import hashlib
import hmac
import json
import os
from flask import Flask, abort, request
app = Flask(__name__)
SECRET = os.environ["WBIZTOOL_WEBHOOK_SECRET"].encode()
@app.post("/wbiztool/webhook")
def wbiztool_webhook():
raw_body = request.get_data() # raw bytes, before parsing
expected = "sha256=" + hmac.new(SECRET, raw_body, hashlib.sha256).hexdigest()
received = request.headers.get("X-Wbiztool-Signature", "")
if not hmac.compare_digest(expected, received):
abort(401)
data = json.loads(raw_body)
if data["event"] == "message_received":
print(f"New message from {data['contact']['phone']}: {data['message']['content']}")
return "", 200<?php
$secret = getenv('WBIZTOOL_WEBHOOK_SECRET');
$rawBody = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
$received = $_SERVER['HTTP_X_WBIZTOOL_SIGNATURE'] ?? '';
if (!hash_equals($expected, $received)) {
http_response_code(401);
exit('Invalid signature');
}
$data = json_decode($rawBody, true);
if ($data['event'] === 'message_received') {
error_log('New message from ' . $data['contact']['phone'] . ': ' . $data['message']['content']);
}
http_response_code(200);لاختبار المستقبِل قبل وصول رسالة حقيقية، وقّع جسمًا بنفسك وأرسله:
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 عالجته.
الحمولة#
{
"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"
}
}{
"event": "message_sent",
"timestamp": "2026-10-15T10:34:22.117205+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected]_3EB0F9E8D7C6B5A40312",
"type": "chat",
"content": "Of course! Send us the text and we'll print it on a card.",
"from": "12125550120",
"from_name": "Emma Thompson",
"to": "12125550101",
"timestamp": "2026-10-15T10:33:40+00:00",
"whatsapp_timestamp": 1792060420,
"direction": "outgoing",
"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"
}
}{
"event": "message_received",
"timestamp": "2026-10-15T10:35:48.904311+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected]_3EB0A7B6C5D4E3F20109",
"type": "image",
"content": "📸 Image",
"from": "12125550122",
"from_name": "Sofia Martinez",
"to": "12125550101",
"timestamp": "2026-10-15T10:34:51+00:00",
"whatsapp_timestamp": 1792060491,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0,
"media": {
"filename": "",
"mimetype": "image/jpeg",
"size": 245760,
"url": "https://wbiztool-static.s3.ap-southeast-1.amazonaws.com/unibox/10314/media/false_12125550122%40c.us_3EB0A7B6C5D4E3F20109.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=…&X-Amz-Date=20261015T103548Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=…"
}
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "12125550122",
"lid": null,
"phone_hidden": false,
"name": "Sofia Martinez",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
}
}{
"event": "message_received",
"timestamp": "2026-10-15T10:39:40.330187+00:00",
"replayed": false,
"webhook_id": 51,
"whatsapp_client_id": "101",
"whatsapp_phone": "12125550101",
"platform": "whatsapp",
"message": {
"id": "[email protected][email protected]",
"type": "chat",
"content": "Will there be a larger size?",
"from": "120363041234567890",
"from_name": "Lumen VIP Club",
"to": "12125550101",
"timestamp": "2026-10-15T10:39:02+00:00",
"whatsapp_timestamp": 1792060742,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0,
"sender": {
"phone": "12125550126",
"name": "Olivia Brooks",
"phone_hidden": false
}
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "120363041234567890",
"lid": null,
"phone_hidden": false,
"name": "Lumen VIP Club",
"is_group": true,
"is_business": false
},
"organisation": {
"id": "10314",
"name": "Lumen & Wick"
},
"group": {
"name": "Lumen VIP Club"
}
}الأرقام والمعرّفات والأسماء أعلاه أمثلة. الجسم الحقيقي سطر واحد من JSON المضغوط، ويصل كل حرف خارج ASCII (الأحرف ذات العلامات، والأبجديات الأخرى، والرموز التعبيرية) كتسلسل هروب \uXXXX، مثل \ud83d\udcf8 لـ 📸. قد تُضاف حقول أخرى؛ تجاهل ما لا تستخدمه.
الحقول على المستوى الأعلى#
| الحقل | النوع | الوصف |
|---|---|---|
event | string | message_received أو message_sent. |
timestamp | string | وقت إجراء الطلب (ISO 8601، بتوقيت UTC). |
replayed | boolean | تكون true عندما تسبق الرسالة الطلب بأكثر من 10 دقائق: إرسال لاحق لما فات، مثلًا بعد إعادة ربط الرقم. وإلا فهي false. يبقى timestamp وقت الطلب. |
webhook_id | integer | معرّف الرقم في صندوق الوارد. |
whatsapp_client_id | string | معرّف رقم WhatsApp الخاص بك، كما في أرقام WhatsApp وفي API. |
whatsapp_phone | string | رقم WhatsApp الخاص بك، بالأرقام فقط. |
platform | string | whatsapp، أو telegram لمحادثات حساب Telegram. |
message | object | الرسالة، راجع أدناه. |
contact | object | الشخص أو المجموعة التي تدور المحادثة معها، راجع أدناه. |
organisation | object | مساحة عملك: id (string) وname. |
group | object | لمحادثات المجموعات فقط: name، اسم المجموعة. |
حقول message#
| الحقل | النوع | الوصف |
|---|---|---|
id | string | معرّف WhatsApp للرسالة. استخدمه لتخطي التكرارات. |
type | string | chat للنص. وإلا فنوع WhatsApp، مثل image أو video أو audio أو ptt (رسالة صوتية) أو document أو sticker أو location أو vcard (بطاقة جهة اتصال) أو poll_creation أو call_log (مكالمة) أو revoked (رسالة محذوفة). |
content | string | نص رسالة chat. وإلا فتسمية: 📸 Image أو 🎥 Video أو 🎵 Audio أو 🎤 Voice Message أو 😊 Sticker أو Document: متبوعًا بنص المستند (Document إن لم يكن له نص)، أو النوع بأحرف أولى كبيرة، مثل Location أو Call_Log. لا تُضمَّن تعليقات الصور والفيديو. |
from | string | دائمًا رقم جهة الاتصال (أو معرّف المجموعة)، في الاتجاهين. يكون فارغًا عندما يخفي WhatsApp الرقم. |
from_name | string | اسم جهة الاتصال أو المجموعة. قد يكون فارغًا. |
to | string | دائمًا رقم WhatsApp الخاص بك، في الاتجاهين. |
timestamp | string | وقت إرسال الرسالة على WhatsApp (ISO 8601، بتوقيت UTC). |
whatsapp_timestamp | integer | الوقت نفسه بثواني Unix. |
direction | string | incoming أو outgoing. استخدم هذا الحقل، لا from وto، لمعرفة الاتجاه. |
status | string | دائمًا pending: ليست حالة تسليم أو قراءة. |
is_forwarded | boolean | ما إذا كانت الرسالة مُعاد توجيهها. |
forwarding_score | integer | دائمًا 0 حاليًا. |
media | object | للصور والفيديو والصوت والرسائل الصوتية والمستندات والملصقات: filename (فارغ غالبًا للصور)، وmimetype، وsize بالبايت، وurl عندما تخزّن WbizTool نسخة. |
media.url | string | رابط تنزيل موقّع تنتهي صلاحيته – بعد 3½ إلى 7 أيام – لذا نزّل الملف عند وصول webhook. استخدمه تمامًا كما أُرسل. يغيب عندما يتعذر تخزين الملف، مثل الملفات التي يزيد حجمها على 15 MB. |
sender | object | لمحادثات المجموعات فقط: من كتب الرسالة – name، وphone (فارغ عندما يخفي WhatsApp رقمه) وphone_hidden (true عندما يخفيه). |
حقول contact#
| الحقل | النوع | الوصف |
|---|---|---|
whatsapp_id | string | معرّف المحادثة في WhatsApp: …@c.us لشخص، و…@g.us لمجموعة، أو معرّف خصوصية مثل 62337239240946@lid. |
phone | string | الرقم بدون +، أو معرّف المجموعة. يكون فارغًا عندما يخفي WhatsApp الرقم. |
lid | string or null | معرّف الخصوصية الذي يستخدمه WhatsApp لجهة الاتصال، عندما يستخدم WhatsApp واحدًا، وإلا null. |
phone_hidden | boolean | true عندما لا يشارك WhatsApp رقم جهة الاتصال. تملأ WbizTool الرقم عندما يتيحه WhatsApp. |
name | string | اسم جهة الاتصال أو اسم المجموعة. قد يكون فارغًا. |
is_group | boolean | true لمحادثات المجموعات. |
is_business | boolean | true لحسابات 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 غير نشطة في مساحة العمل هذه." يُخبَر المالكون والمحررون بصناديق الوارد التي توقفت، في رسالة الفوترة الإلكترونية أو في التنبيه "توقفت بعض أرقام … أو ميزاتها" (مشكلات الرقم والإرسال في الإشعارات). يُحتفظ بالمحادثات وروابط 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. |
صفحات ذات صلة#
- صندوق الوارد Unibox: اقرأ محادثات أرقام صندوق الوارد لديك وردّ عليها
- تكامل Zapier
- اربط رقم WhatsApp الخاص بك
- الباقات والفوترة
- API إرسال رسالة: يبيّن الحقل
webhookفيها ما إذا خرجت رسالة ترسلها (webhook مختلف)



