שמירת הודעות 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 לפני שהמשלוח נשלח שוב.
בקשות כתיבה של Google Sheets API המותרות לדקה לכל משתמש ולכל פרויקט; 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 or Update Row, כשהעמודה להתאמה מוגדרת ל-Message id, כך שניסיון חוזר של משלוח כותב מחדש את אותה שורה במקום להוסיף אחת.
סוד ההעברה מופיע פעם אחת, כשמשמרים את ה-Forward URL; אם הוא אבד, לוחצים על New secret ומדביקים את החדש. ב-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 or Update Row, מותאם לפי העמודה Phone. ממפים את הטלפון, שם הפרופיל, מזהה המשתמש, השעה והטקסט של ההודעה האחרונה. ההודעה הראשונה ממספר יוצרת את השורה שלו; הבאות מעדכנות את עמודות השם ושל הקשר האחרון, כך שהלשונית משמשת גם כרשימה של מי כתב ומתי. שמרו הערות שנכתבו ידנית בלשונית נפרדת, שמחפשים לפי הטלפון, כדי שתהליך האוטומציה לעולם לא ידרוס אותן.
אנשי הקשר ששמורים בספר הכתובות של הטלפון לא מגיעים בדרך הזו. Meta שולחת אותם, עם עד 6 חודשים של שיחות, רק ליעד וובהוק ישיר שנשמר תוך 24 שעות מחיבור המספר.
האם Apps Script יכול לקבל את ההודעות ישירות?
לא בצורה נקייה, ולכן שמים כלי אוטומציה לפני הגיליון. גוגל מגישה את התגובה של אפליקציית אינטרנט של Apps Script דרך הפניה לכתובת חד-פעמית ב-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.
מתייחסים לכתובת ה-hook כאל סיסמה, כי כל מי שמחזיק בה יכול להוסיף שורות. אם התוכנית שלכם כוללת צעד קוד, בדקו שם את X-EC-Signature באותו מתכון HMAC כמו בצומת ה-n8n שלמעלה.
איך נמנעים משורות כפולות או חסרות?
כפילויות נובעות מניסיונות חוזרים. העברה שלא קיבלה תשובה 2xx תוך 10 שניות נשלחת שוב, עם אותה כותרת X-EC-Delivery ואותו id בגוף, וההודעות שבתוכה שומרות על ה-wamid שלהן. לכן התאמה לפי Message id הופכת ניסיון חוזר לבלתי מזיק. במסלול Call my Webhook, בדיקות מ-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 or Update Row שמותאם לפי מזהה ההודעה.
- כתיבת סטטוסי מסירה כהודעות. אירוע messages נושא גם את הסטטוסים sent, delivered ו-read ב-value.statuses; לסטטוסים אלה אין טקסט, והם יוצרים שורות ריקות.
- שמירת כתובת אפליקציית האינטרנט של Apps Script כ-Forward URL. ההפניה שלה נחשבת לכישלון, ולכן כל אחד מ-7 הניסיונות מריץ את 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 חודשים של צ'אטים אחד על אחד רק ליעד וובהוק ישיר שנשמר תוך 24 שעות מחיבור, פעם אחת לכל חיבור. מספר שמנותב דרך easyCoexistence רושם מהרגע שבו ה-Forward URL נשמר.
האם easyCoexistence שומר עותק של ההודעות?
חלקית. במספר שמנותב דרך easyCoexistence כשהאוטומציות פועלות, טקסט ההודעה נשמר לתקופה שבחרתם, 30, 90 או 365 ימים (90 כברירת מחדל), ומוצג ב-Conversations; משלוחים מועברים נשמרים עד 7 ימים לניסיונות חוזרים, ויומני ההפעלה נשמרים 30 ימים. הגיליון הוא העותק הקבוע שלכם.
האם ה-AI שלי יכול לקרוא את הגיליון כדי לענות ללקוחות?
לא משלב Reply with AI, שקורא רק את ה-Instructions שלו ואת השיחה. סוכן AI יכול לחפש מידע דרך כלי HTTP מותאם אישית, ושלב Call my Webhook או Call an API יכול לשלוח את השאלה לתהליך שמחפש את התשובה בגיליון ומחזיר אותה כתשובה.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-