تأمين أتمتة WhatsApp: المفاتيح وخطاف الويب (webhook) والتوقيعات
تأمين أتمتة WhatsApp عند أربع نقاط: مفتاح الذكاء الاصطناعي، المحفوظ مشفّرًا ويُستخدم للردود الآلية وحدها؛ والـ webhook الذي تستدعيه الأتمتة، ويجب أن يتحقق من توقيع HMAC قبل الوثوق بالطلب؛ وإعادة توجيه الرسائل الواردة، الموقّعة بسر يمكن تدويره؛ والأشخاص والمساعدون الذين لديهم وصول، ويُقصر على ما يحتاجونه.
تخزّن easyCoexistence مفاتيح الذكاء الاصطناعي مشفّرة ولا تعرضها مرة أخرى، وتوقّع كل طلب Call my webhook وكل رسالة مُعاد توجيهها بالترويسة X-EC-Signature باستخدام سر لا يملكه غيرك، وترفض عناوين webhook التي ليست HTTPS عامة.
التشفير المستخدم في حالة السكون لمفاتيح الذكاء الاصطناعي المحفوظة، وأسرار التوقيع، ورمز الوصول (token) الخاص بـ Meta للرقم.
كل ما يُعرض من مفتاح ذكاء اصطناعي محفوظ لاحقًا هو «ينتهي بـ» آخر أربعة أحرف فيه.
عشوائية في كل سر توقيع: whsec_ متبوعة بـ 24 بايت عشوائيًا، واحد لكل أتمتة وواحد لكل رقم لإعادة التوجيه.
يجب أن يكون عنوانا webhook وإعادة التوجيه عامّين عبر HTTPS، وتُرفض العناوين الخاصة والداخلية عند الحفظ وقبل كل إرسال.
حدّ مقترح لعمر قيمة t في التوقيع، لرفض الطلبات المعادة.
ما الذي يحتاج إلى حماية في إعداد أتمتة WhatsApp؟
خمسة بيانات اعتماد، لكل منها موقعه وإصلاحه الخاص إن تسرّبت. اثنان منها يخصان الأتمتات نفسها: مفتاح الذكاء الاصطناعي وسر توقيع «Call my webhook»؛ وسر إعادة التوجيه يخص الرقم؛ ورمز الوصول وتسجيل دخول المساعد يخصان الحساب. ومعرفة أيها أيّ تحدد ما يجب تدويره عند وقوع خطأ.
كيف تُخزَّن مفاتيح الذكاء الاصطناعي وكيف تُستخدم؟
من لوحة التحكم وحدها: زر «AI keys» في صفحة Automations، ثم «Test and save». يُتحقق أولًا من المفتاح عبر نقطة النهاية (endpoint) المجانية لدى المزوّد، وهي لا تستهلك أي رموز، ويُهمَل المفتاح الذي يرفضه المزوّد دون حفظه. أما المفتاح الصالح فيُشفَّر في حالة السكون بخوارزمية AES-256-GCM، ولا يُفكّ تشفيره إلا لاستدعاء ذلك المزوّد من أجل خطوات الذكاء الاصطناعي والوكلاء، ولكتابة الرسائل الصوتية نصًا عند استخدام مفتاح OpenAI أو OpenRouter، ولا يُعرض بعد ذلك إلا بصيغة «ending in 1234». ولا تقبل أي أداة MCP مفتاحًا ولا تُعيده، فلا يمرّ المفتاح أبدًا عبر محادثة مع مساعدك.
يحتفظ الحساب بمفتاح واحد لكل مزوّد، وحفظ مفتاح جديد يستبدل القديم. أنشئ لدى المزوّد مفتاحًا مخصصًا للأتمتات، مع حدّ للإنفاق حيث يتيحه، حتى يمكن إلغاؤه دون كسر تطبيقاتك الأخرى. وإذا رفض المزوّد المفتاح يومًا، تظهر الأتمتات التي تستخدمه بحالة «Paused» وتصلك رسالة بريد إلكتروني واحدة، وحفظ مفتاح يعمل يعيد تشغيلها تلقائيًا.
كيف تتحقق من أن طلب Call my webhook أصلي؟
تحقق من التوقيع قبل قراءة أي شيء آخر. يحمل كل طلب الترويسة X-EC-Signature بصيغة: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">، ويُحسب بسر التوقيع الخاص بتلك الأتمتة، وتنسخه من الخطوة في المحرر بعد الحفظ. أعد حساب HMAC على البايتات الخام، وقارن بوقت ثابت، وارفض أي قيمة t تبعد أكثر من 5 دقائق عن ساعتك. ويخبرك الجسم بأمرين يستحقان الانتباه. الحقل dry_run يكون true عندما يأتي الطلب من Try it، فتخطَّ أي عملية لا يمكن التراجع عنها، مثل إنشاء طلب شراء. والحقل run_id فريد لكل تشغيل، فاحتفظ بالمعرّفات التي عالجتها وارفض الطلب المعاد. أجب خلال 20 ثانية، فالرد {"reply": "..."} يُرسل إلى العميل كما هو مكتوب، فلا تمرر نص العميل دون فحص.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }كيف تعمل أسرار إعادة التوجيه، وكيف تدوّرها؟
يمكن للرقم المضبوط على «Through easyCoexistence» أن يعيد توجيه رسائله الواردة إلى نظامك الخاص. عند أول حفظ لعنوان Forward URL يُولَّد سر ويُعرض مرة واحدة تحت عبارة «Your signing secret, shown once. Copy it now:»، وهو يوقّع كل طلب POST مُعاد توجيهه بالمخطط نفسه X-EC-Signature. أما «New secret» في صفحة الرقم، أو set_inbound_mode مع rotate_secret مضبوطًا على true، فيُولّد بديلًا يُعرض مرة واحدة أيضًا، ومن تلك اللحظة يوقّع كل شيء، بما في ذلك إعادة محاولات التسليم الأقدم. ويمكنك أيضًا كتابة سر خاص بك، لا يقل عن 24 حرفًا، يُخزَّن ولا يُعرض مرة أخرى. وإيقاف إعادة التوجيه يحذف السر، فحفظ عنوان لاحقًا يبدأ بسر جديد.
دوّر السر بعد مغادرة أحد أعضاء الفريق الذي كان له وصول، وبعد تسرّب سر إلى مستودع أو تذكرة أو سجل، وعند تغيير الاستضافة. أما سر Call my webhook فيتبع الأتمتة ولا يراه إلا مالك الحساب. وحيث يعرض المحرر «New secret»، ضمن مشغّل «Your system calls a URL»، فإن ذلك الزر يستبدله ويتوقف القديم عن العمل فورًا؛ وفي أتمتة بلا هذا الزر، أنشئ الأتمتة من جديد، ووجّه المستقبِل إلى السر الجديد، ثم احذف الأتمتة القديمة.
ما العناوين التي يمكن للأتمتات استدعاؤها؟
عناوين HTTPS عامة فقط. يُرفض عنوان Call my webhook URL أو Forward URL إذا بدأ بـ http://، أو أشار إلى localhost، أو إلى نطاق شبكة خاصة، أو إلى اسم ينتهي بـ .internal أو .local، أو إلى عنوان البيانات الوصفية لخدمة سحابية، وذلك عند حفظه. ويُفحص مرة أخرى بعد DNS قبل كل طلب، حتى لا يمكن توجيه اسم عام لاحقًا إلى داخل شبكة خاصة. لا تُتبع عمليات إعادة التوجيه: الاستجابة 301 أو 302 تُفشل الخطوة، فاحفظ العنوان النهائي.
لا تضع الأسرار داخل العنوان نفسه. تُرجع list_automations خطوات كل أتمتة، بما فيها عنوان webhook، لأي مساعد متصل بحسابك، فرمز الوصول في سلسلة الاستعلام يمكن قراءته هناك. دع التوقيع يحمل إثبات الصحة بدلًا من ذلك.
كيف تُبقي الوصول عند حدّه الأدنى؟
امنح كل شخص وكل أداة الوصول الذي تحتاجه مهمتها فقط، وأزل ما لم يعد مستخدمًا. أما جانب الموصِّل، مع تسجيل الدخول والتأكيدات والأدوات المحظورة، فمغطّى في الصفحة الخاصة بربط WhatsApp بالذكاء الاصطناعي بأمان. أما من جهة الأتمتة، فهذه العادات أهمها:
- اطلب
get_api_credentialsفي محادثة خاصة فقط، لأن رمز وصول الرقم يبقى حينها في ذلك السجل. - فضّل Call my webhook أو Forward URL على تسليم رمز الوصول إلى أداة طرف ثالث.
- احذف الأتمتات التي تقاعدتها، فهذا يُلغي أيضًا أسرار توقيعها.
- تذكّر أن سجلات التشغيل تحتفظ برسائل العملاء والردود لمدة 30 يومًا، وتحتفظ Conversations بالمحادثات طوال مدة الاحتفاظ لديك (30 أو 90 أو 365 يومًا)، وكلاهما قابل للقراءة في لوحة التحكم وعبر مساعدك المتصل.
- على رقم مضبوط على «Straight to your system»، ضع سرًا عشوائيًا طويلًا في مسار عنوان callback، لأن توقيع Meta لا يمكن التحقق منه هناك.
الأخطاء الشائعة
- التحقق من التوقيع على JSON أعاد إطار العمل تسلسله. كثير من المحلِّلات تغيّر المسافات أو الترميز أو ترتيب المفاتيح، لذا احسب HMAC على البايتات الخام للطلب حيثما تكشفها حزمتك.
- تنفيذ آثار جانبية على طلبات الاختبار. يستدعي Try it خطاف webhook الخاص بك مع dry_run مضبوطًا على true، فالطلب أو الاسترداد أو كتابة CRM تُجرى عندها تكون حقيقية.
- لصق مفتاح الذكاء الاصطناعي في محادثة مع مساعدك لتوفير الوقت. لا توجد أداة تقبله، ويبقى في سجل المحادثة، لذا استخدم مفاتيح الذكاء الاصطناعي من لوحة التحكم.
- الخلط بين سر Call my webhook وسر إعادة التوجيه، أو العكس. هما سرّان منفصلان: واحد لكل رقم لإعادة التوجيه، وواحد لكل أتمتة لاستدعاءات webhook.
ويبقى رقمك على Cloud API الرسمية من Meta عبر Coexistence، تحت مراقبة على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل رقم شهريًا، ويتناقص كلما أضفت أرقامًا، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل يستطيع موظفو easyCoexistence أو فريق الدعم رؤية مفتاح الذكاء الاصطناعي الخاص بي؟
لا يُعرض المفتاح بعد حفظه، لا في لوحة التحكم، ولا في نتائج MCP، ولا في الحقائق التي يقرؤها مساعد الدعم. ولا يُفكّ تشفيره إلا بواسطة النظام، في اللحظة التي يستدعي فيها مزوّدك لردٍّ بالذكاء الاصطناعي.
من يستطيع قراءة سجلات تشغيل أتمتتي؟
أي شخص مسجّل الدخول إلى حسابك في easyCoexistence، بمن فيهم من دعوتهم إليه، في تبويب Runs، وأي مساعد متصل بالحساب، عبر list_automation_runs وget_automation_run. تشمل السجلات رسالة العميل والرد، وتُحذف بعد 30 يومًا.
كيف أزيل مفتاح الذكاء الاصطناعي بأمان؟
أوقف أولًا الأتمتات التي تستخدمه باستخدام «Switch Off»، وأي وكيل يعمل عليه، ثم اختر «Remove» ضمن AI keys، وألغِ المفتاح لدى المزوّد. إزالته بينما لا تزال الأتمتات تستخدمه توقفها عند ردها التالي بالذكاء الاصطناعي، وترسل إليك بريدًا إلكترونيًا.
هل ترسل Try it بيانات العملاء إلى webhook الخاص بي؟
ترسل فقط نص العينة الذي كتبته، مع dry_run مضبوطًا على true وسجل فارغ. أما التشغيل الحقيقي فيرسل الرسالة الواردة وأحدث رسائل المحادثة، حتى 10 رسائل، لذا عامِل نقطة النهاية كأنها تتعامل مع بيانات عملاء.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في