حفظ رسائل WhatsApp وجهات الاتصال في Google Sheets تلقائياً
لحفظ رسائل WhatsApp Business في Google Sheets تلقائياً، أرسلها كطلبات HTTP POST موقّعة إلى أداة أتمتة مثل n8n أو Make أو Zapier، ودع خطوة Google Sheets فيها تضيف صفاً لكل رسالة: الوقت، والاتجاه، ورقم الهاتف، والاسم، والنص، ومعرّف الرسالة. يحتفظ تبويب ثانٍ مفهرس بحسب رقم الهاتف بصف واحد لكل جهة اتصال، يُحدَّث عند كل رسالة جديدة منها.
يربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API لدى Meta عبر Coexistence.
تُعاد محاولة التحويلات بعد نحو 1 و5 و30 و120 و360 و1,440 دقيقة عندما يفشل عنوان URL لديك.
المدة التي ينتظرها طلب POST المُحوَّل للحصول على استجابة 2xx قبل إعادة محاولة هذا التسليم.
طلبات الكتابة في واجهة برمجة التطبيقات (API) الخاصة بـ Google Sheets المسموح بها في الدقيقة لكل مستخدم في كل مشروع؛ 300 لكل مشروع.
يُوجَّه ناتج تطبيق الويب في Apps Script إلى عنوان URL لمرة واحدة على script.googleusercontent.com.
كائن حدث doPost في Apps Script يعرض نص الطلب والمعاملات، لا ترويسات طلب HTTP.
أيّ مسار ينبغي أن يملأ الجدول؟
يوجد مساران على رقم تمر رسائله عبر easyCoexistence، ويلبيان حاجتين مختلفتين. يمرّر Forward URL، المُعيَّن مرة واحدة لكل رقم، أحداث Meta الأصلية سواء ردّت أتمتة أم لا: رسائل العملاء، والردود التي يكتبها فريقك في تطبيق WhatsApp Business، وحالات التسليم. وهو المسار المناسب لسجلّ كامل للرسائل. أما خطوة Call my webhook داخل أتمتة فتُطلق فقط للرسائل التي تختارها تلك الأتمتة، وتحمل المحادثة الأخيرة، بما فيها الرد الذي أرسلته الأتمتة للتو. وهي مناسبة لجدول بالعملاء المحتملين أو الطلبات أو الاستفسارات التي تعالجها أتمتة واحدة. وكلاهما موقّع، بسرّين مختلفين.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
ما الحقول التي تصل، وما الأعمدة التي ينبغي أن يحتويها الجدول؟
يغلّف طلب POST المُحوَّل تغييراً واحداً من Meta: id (معرّف التسليم)، وevent (اسم الحقل في Meta، مثل messages أو smb_message_echoes)، وreceived_at، وconnection (معرّف رقمك، وphone وphone_number_id)، وvalue كما أرسلته Meta تماماً. داخل value، تحمل messages ما كتبه العملاء، وتحمل message_echoes ما كتبه فريقك من الهاتف. تصل أرقام الهواتف كأرقام متتالية مع رمز الدولة دون علامة +؛ اجعل هذا العمود نصاً عادياً حتى لا يحوّله Sheets إلى رقم. قد يصل مستخدم له اسم مستخدم في WhatsApp مع معرّف مستخدم خاص بالنشاط التجاري إلى جانب الرقم أو بدلاً منه، فاحتفظ بعمود له.
كيف تبني سجلّ الرسائل في n8n؟
ثلاث عُقد. عقدة Webhook بطريقة HTTP Method المضبوطة على POST، وRespond مضبوطة على Immediately، وحفظ Production URL كـ Forward URL للرقم. عقدة Code تتحقق من X-EC-Signature بسرّ التحويل وتحوّل الحدث إلى صفوف، مع تخطّي حالات التسليم. وعقدة Google Sheets بعملية Append أو Update Row، وColumn to match on مضبوط على Message id، بحيث تعيد المحاولة المكررة كتابة الصف نفسه بدلاً من إضافة صف جديد.
يظهر سرّ التحويل مرة واحدة، عند حفظ Forward URL؛ فإن ضاع، انقر New secret والصق الجديد. يسمح n8n Cloud بوحدة crypto في عُقد Code؛ أما n8n المستضاف ذاتياً فيحتاج NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));كيف تحافظ على صف واحد لكل جهة اتصال؟
أضف عقدة Google Sheets ثانية على تبويب Contacts، بعملية Append أو Update Row أيضاً، مع المطابقة على Phone. اربط الهاتف، واسم الملف الشخصي، ومعرّف المستخدم، والوقت، ونص آخر رسالة. تُنشئ أول رسالة من رقم صفه؛ وتُحدّث الرسائل اللاحقة عمودَي الاسم وآخر تواصل، فيعمل التبويب كقائمة بمن كتب ومتى. احتفظ بالملاحظات المكتوبة يدوياً في تبويب منفصل، يُبحث فيه بالهاتف، حتى لا يكتب سير العمل فوقها أبداً.
لا تصل جهات الاتصال المحفوظة في دفتر عناوين الهاتف بهذه الطريقة. فـ Meta ترسلها، مع حتى 6 أشهر من المحادثات، فقط إلى وجهة webhook مباشرة محفوظة خلال 24 ساعة من ربط الرقم.
هل يمكن لـ Apps Script استقبال الرسائل مباشرة؟
ليس بشكل سليم، لذا ضع أداة أتمتة أمام الجدول. تُقدّم Google استجابة تطبيق ويب Apps Script عبر إعادة توجيه إلى عنوان URL لمرة واحدة على script.googleusercontent.com، و easyCoexistence لا تتبع عمليات إعادة التوجيه. يُحتسب الرد 302 كتسليم فاشل: يُعاد تحويل الطلب حتى 7 مرات، وكل إعادة تشغّل doPost من جديد وتكتب صفاً آخر، بينما تفشل خطوة Call my webhook وترسل إليك بريداً. كما لا يستطيع doPost قراءة ترويسات الطلب، فالتحقق من X-EC-Signature مستحيل هناك.
يبقى Apps Script خياراً جيداً للاتجاه الآخر، أي إرسال القوالب المعتمدة من صفوف في جدول، وهو ما تغطيه صفحة تكامل Google Sheets بالكود.
هل يمكن لـ Make أو Zapier ملء الجدول بدلاً من ذلك؟
نعم. في Make، ابدأ السيناريو بـ Webhooks > Custom webhook وأضف Google Sheets > Add a Row؛ وفي Zapier، استخدم Webhooks by Zapier مع Catch Raw Hook، الذي يحتفظ بالترويسات، ثم Google Sheets > Create Spreadsheet Row. يردّ كلاهما على طلب POST فوراً برمز 2xx، وهو ما يحتاجه التحويل خلال 10 ثوانٍ. طابِق الحقول نفسها المذكورة أعلاه من value.messages، واستبعد الأحداث التي تحمل في value حالات statuses بدلاً من messages.
عامل عنوان الخطاف كأنه كلمة مرور، لأن أي شخص يملكه يستطيع إضافة صفوف. وإن كانت خطتك تتضمن خطوة كود، فتحقق من X-EC-Signature هناك بالطريقة نفسها HMAC المستخدمة في عقدة n8n.
كيف تتجنّب الصفوف المكررة أو الناقصة؟
تأتي التكرارات من إعادة المحاولات. يُعاد إرسال التحويل الذي لم يحصل على رمز 2xx خلال 10 ثوانٍ مع الترويسة نفسها X-EC-Delivery والمعرّف نفسه في النص، وتحتفظ الرسائل بداخله بـ wamid الخاص بها، فالمطابقة على Message id تجعل المحاولة المعادة بلا أثر. وفي مسار خطوة الخطاف، تصل الاختبارات من Try it مع dry_run بقيمة true؛ فوجّهها إلى تبويب تجريبي أو تجاهلها.
تأتي الصفوف الناقصة من حصة الكتابة في Google. فـ Sheets API يسمح بـ 60 طلب كتابة في الدقيقة لكل مستخدم في كل مشروع، وبيانات اعتماد n8n الواحدة تمثّل مستخدماً واحداً؛ وقد تتجاوز دفعة من الردود بعد حملة قوالب هذا الحد فتحصل على HTTP 429. فعّل Retry On Fail في إعدادات عقدة Google Sheets، أو اجمع الرسائل لبضع ثوانٍ وأضفها في طلب واحد.
كيفية إعداده
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
الأخطاء الشائعة
- التحقق من التحويل بـ Signing secret الخاص بأتمتة، أو العكس. يُوقَّع Forward URL بسرّ التحويل الخاص بالرقم، وتُوقَّع Call my webhook بسرّ الأتمتة نفسها؛ فاختر السرّ بحسب ترويسة X-EC-Event.
- إضافة صف لكل طلب POST دون مفتاح. يكتب التسليم المعاد بعد استجابة بطيئة الرسالة نفسها مرتين؛ استخدم Append أو Update Row مع المطابقة على معرّف الرسالة.
- كتابة حالات التسليم كرسائل. يحمل حدث messages أيضاً حالات sent وdelivered وread في value.statuses، وهي بلا نص وتُنشئ صفوفاً فارغة.
- حفظ عنوان URL لتطبيق ويب Apps Script كـ Forward URL. تُحسب إعادة توجيهه فشلاً، فيُشغَّل doPost في كل محاولة من المحاولات السبع ويُضيف صفاً مكرراً.
مع تفعيل الأتمتة، يمرّر Forward URL أحداث Meta الأصلية إلى سير عملك، موقّعةً بسرّ لا يملكه سواك، ويُعاد إرسالها عندما يكون عنوانك متوقفاً، بينما ترسل خطوة Call my webhook ما عالجته أتمتة مع ردّها. وكلاهما مشمول في الخطة. من US$ 9 إلى US$ 0.75 لكل رقم شهرياً، ينخفض كلما أضفت أرقاماً، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يصل إلى الجدول ما يكتبه فريقي من الهاتف؟
نعم، عبر Forward URL. تصل الردود المكتوبة في تطبيق WhatsApp Business كأحداث smb_message_echoes، مع رقم العميل في to. أما الردود التي ترسلها الأتمتة فلا تعود إلا كحالات تسليم، لذا سجّل نصّها من خطوة Call my webhook الموضوعة بعد الرد.
هل يمكنني تحميل محادثاتي الحالية في الجدول؟
ليس على رقم تمر رسائله عبر easyCoexistence. ترسل Meta حتى 6 أشهر من المحادثات الفردية فقط إلى وجهة webhook مباشرة محفوظة خلال 24 ساعة من الربط، ومرة واحدة لكل اتصال. ويبدأ الرقم الذي يمر عبر easyCoexistence التسجيل من اللحظة التي تُحفظ فيها Forward URL.
هل تحتفظ easyCoexistence بنسخة من الرسائل؟
جزئياً. في رقم يمر عبر easyCoexistence مع أتمتة مفعّلة، يُحتفظ بنص الرسالة للمدة التي تختارها، 30 أو 90 أو 365 يوماً (90 افتراضياً)، ويظهر في Conversations؛ وتُحفظ الرسائل المحوَّلة حتى 7 أيام لإعادة المحاولة، وسجلات التشغيل 30 يوماً. الجدول هو نسختك الدائمة.
هل يستطيع الذكاء الاصطناعي لديّ قراءة الجدول للرد على العملاء؟
ليس من خطوة Reply with AI، التي تقرأ تعليماتها والمحادثة فقط. ويستطيع وكيل ذكاء اصطناعي البحث عبر أداة HTTP مخصصة، أما خطوتا Call my webhook وCall an API فيمكنهما إرسال السؤال إلى سير عمل يبحث عن الإجابة في الجدول ويعيدها كرد.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في