התחברותהתחילו תקופת ניסיון
Meta Tech Provider

אבטחת אוטומציות ב-WhatsApp: מפתחות, וובהוקים וחתימות

מאבטחים אוטומציה ב-WhatsApp בארבע נקודות: מפתח ה-AI, שנשמר מוצפן ומשמש רק לתשובות AI; הוובהוק (Webhook) שהאוטומציה קוראת לו, שצריך לבדוק בו חתימת HMAC לפני שסומכים על הבקשה; העברת ההודעות הנכנסות, החתומה בסוד שניתן להחליף; והאנשים והעוזרים עם גישה, שמוגבלים למה שהם צריכים.

easyCoexistence שומר את מפתחות ה-AI שלכם מוצפנים ולעולם לא מציג אותם שוב, חותם כל בקשה של "קריאה לוובהוק שלי" וכל הודעה מועברת עם X-EC-Signature באמצעות סוד שרק אתם מחזיקים, ודוחה כתובות וובהוק שאינן HTTPS ציבוריות.

AES-256-GCM

הצפנה במנוחה למפתחות AI שנשמרו, לסודות החתימה ולאסימון הגישה (Access Token) של המספר ב-Meta.

Last 4

ממפתח AI שמור רואים שוב רק את "מסתיים ב-" ואת ארבעת התווים האחרונים שלו.

192 bits

כל סוד חתימה נוצר אקראית: whsec_ ואחריו 24 בייטים אקראיים, סוד אחד לכל אוטומציה וסוד אחד לכל מספר שמעביר הודעות.

HTTPS only

כתובות ה-URL של הוובהוק וההעברה חייבות להיות HTTPS ציבורי; כתובות פרטיות ופנימיות נדחות בשמירה ולפני כל שליחה.

5 minutes

מומלץ להגביל את גיל הערך t בחתימה, כדי לדחות בקשות שנשלחו שוב.

על מה צריך להגן באוטומציה של WhatsApp?

חמישה פרטי גישה רגישים, לכל אחד מקום משלו ותיקון משלו אם הוא דולף. שניים מהם שייכים לאוטומציות עצמן: מפתח ה-AI וסוד החתימה של "קריאה לוובהוק שלי". סוד ההעברה שייך למספר; אסימון הגישה וההתחברות של העוזר שלכם שייכים לחשבון. הידיעה מה שייך למה אומרת לכם מה להחליף כשמשהו משתבש.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

איך מאוחסנים ומשתמשים במפתחות AI?

רק מלוח הבקרה: כפתור "מפתחות AI" בעמוד האוטומציות, ואז "בדיקה ושמירה". המפתח נבדק קודם מול נקודת קצה חינמית של הספק, שאינה צורכת טוקנים, ומפתח שהספק דוחה נמחק בלי להישמר. מפתח תקין מוצפן במנוחה ב-AES-256-GCM, מפוענח רק כדי לקרוא לספק עבור שלבי ה-AI והסוכנים שלכם, ולתמלל הודעות קוליות במפתח OpenAI או OpenRouter, ומוצג אחר כך רק כ-"מסתיים ב-1234". אף כלי MCP לא מקבל או מחזיר מפתח, ולכן הוא לעולם לא עובר בשיחה עם העוזר שלכם.

לחשבון יש מפתח אחד לכל ספק, ושמירת מפתח חדש מחליפה את הישן. צרו מפתח ייעודי לאוטומציות אצל הספק, עם מגבלת הוצאה אם הספק מציע כזאת, כדי שאפשר יהיה לבטל אותו בלי לשבור את שאר האפליקציות שלכם. אם הספק דוחה אותו בשלב כלשהו, אוטומציות שמשתמשות בו מוצגות כ-"מושהה" ומקבלים מייל אחד; שמירת מפתח שעובד מפעילה אותן מחדש לבד.

איך מאמתים שבקשת קריאה לוובהוק היא אמיתית?

בודקים את החתימה לפני שקוראים כל דבר אחר. כל בקשה נושאת את הכותרת X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, חתומה במפתח שהוא סוד החתימה של האוטומציה, שמעתיקים מהשלב בעורך אחרי השמירה. מחשבים מחדש את ה-HMAC על הבייטים הגולמיים, משווים בזמן קבוע, ודוחים t שרחוק יותר מ-5 דקות מהשעון שלכם. הגוף מלמד גם שני דברים שכדאי לפעול לפיהם. dry_run הוא true כשהבקשה מגיעה מ-"נסו", ולכן מדלגים על כל דבר שאי אפשר לבטל, כמו יצירת הזמנה. run_id ייחודי לכל הרצה, לכן שומרים את אלה שטיפלתם בהם ודוחים בקשה שנשלחה שוב. עונים תוך 20 שניות; {"reply": "..."} נשלח ללקוח כפי שהוא כתוב, ולכן לעולם אל תעבירו טקסט של לקוח בלי בדיקה.

A Call my webhook request: headers and body
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 יכול להעביר את ההודעות הנכנסות שלו למערכת שלכם. בפעם הראשונה ששומרים כתובת URL להעברה נוצר סוד ומוצג פעם אחת, תחת "סוד החתימה שלכם, מוצג פעם אחת. העתיקו עכשיו:"; הוא חותם כל POST מועבר באותה שיטה של X-EC-Signature. סוד חדש בעמוד המספר, או set_inbound_mode עם rotate_secret בערך true, יוצר סוד חלופי שמוצג שוב פעם אחת, ומאז הוא חותם הכול, כולל ניסיונות חוזרים של משלוחים ישנים. אפשר גם להקליד סוד משלכם, לפחות 24 תווים, שנשמר ולא מוצג שוב. הפסקת ההעברה מוחקת את הסוד, כך ששמירת כתובת בהמשך מתחילה עם סוד חדש.

מחליפים לאחר שחבר צוות עוזב, לאחר שסוד נחשף במאגר קוד, בכרטיס או ביומן, וכשמשנים אירוח. סוד של "קריאה לוובהוק שלי" שייך לאוטומציה, ורק בעל החשבון רואה אותו. במקום שבו העורך מציג סוד חדש, תחת טריגר "המערכת שלכם קוראת ל-URL", הכפתור הזה מחליף אותו והישן מפסיק לעבוד מיד; באוטומציה בלי הכפתור הזה, יוצרים את האוטומציה מחדש, מצביעים את המקבל שלכם על הסוד החדש, ואז מוחקים את האוטומציה הישנה.

אילו כתובות האוטומציות יכולות לקרוא?

רק כתובות HTTPS ציבוריות. כתובת URL של "קריאה לוובהוק שלי" או כתובת URL להעברה שמתחילה ב-http://, מצביעה על localhost, על טווח רשת פרטית, על שם מסוג .internal או .local, או על כתובת מטא-דאטה של ענן, נדחית בשמירה, ונבדקת שוב אחרי ה-DNS לפני כל בקשה, כך ששם ציבורי לא יוכל להצביע מאוחר יותר לתוך רשת פרטית. הפניות אינן נעקבות: 301 או 302 מכשילים את השלב, ולכן שומרים את הכתובת הסופית.

שומרים סודות מחוץ לכתובת עצמה. list_automations מחזיר את השלבים של כל אוטומציה, כולל כתובת הוובהוק, לכל עוזר מחובר לחשבון שלכם, ולכן אסימון במחרוזת השאילתה נקרא שם. תנו לחתימה להוכיח את הזהות במקום.

איך שומרים על גישה למינימום?

נותנים לכל אדם ולכל כלי רק את הגישה שהתפקיד שלו דורש, ומסירים מה שכבר לא בשימוש. צד המחבר, עם התחברות, אישורים וכלים חסומים, מכוסה בעמוד על חיבור WhatsApp לעוזר AI בבטחה; בצד האוטומציה, ההרגלים האלה חשובים ביותר:

  • מבקשים get_api_credentials רק בצ'אט פרטי: אסימון הגישה של המספר נשמר אז בתמליל השיחה.
  • מעדיפים קריאה לוובהוק או כתובת URL להעברה על פני מסירת האסימון לכלי של צד שלישי.
  • מוחקים אוטומציות שפרשתם; מחיקה מבטלת גם את סודות החתימה שלהן.
  • זכרו שיומני ההרצה שומרים הודעות לקוחות ותשובות למשך 30 ימים, ו-Conversations שומרת צ'אטים לתקופת השמירה שלכם (30, 90 או 365 ימים), ושניהם ניתנים לקריאה בלוח הבקרה ובאמצעות העוזר המחובר שלכם.
  • במספר שמוגדר ל"ישירות למערכת שלכם", שימו סוד אקראי ארוך בנתיב של כתובת ההחזרה (callback), כי אי אפשר לבדוק שם את החתימה של Meta.

טעויות נפוצות

  • אימות החתימה על JSON שמסגרת העבודה שלכם סידרה מחדש. הרבה מפענחים משנים רווחים, תווי מילוט או סדר מפתחות; מחשבים את ה-HMAC על הבייטים הגולמיים של הבקשה בכל מקום שהמחסנית שלכם חושפת אותם.
  • הפעלת פעולות צד בבדיקות. "נסו" קוראת לוובהוק שלכם עם dry_run בערך true; הזמנה, החזר כספי או כתיבה ל-CRM שנעשים אז הם אמיתיים.
  • הדבקת מפתח AI לצ'אט עם העוזר כדי לחסוך זמן. אף כלי לא מקבל אותו, והוא נשאר בתמליל; משתמשים במפתחות AI בלוח הבקרה.
  • בדיקת העברה בעזרת סוד קריאת הוובהוק, או להפך. אלה סודות נפרדים: אחד לכל מספר להעברות, ואחד לכל אוטומציה לקריאות וובהוק.
עושים את זה עם EasyCoexistence

המספר שלכם נשאר ב-Cloud API הרשמי של Meta דרך Coexistence, בניטור 24/7. US$ 9 עד US$ 0.75 לכל מספר בחודש, וככל שמוסיפים מספרים המחיר יורד, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם צוות easyCoexistence או התמיכה יכולים לראות את מפתח ה-AI שלי?

המפתח לא מוצג לאחר השמירה, לא בלוח הבקרה, לא בתוצאות MCP ולא בעובדות שעוזר התמיכה קורא. המערכת בלבד מפענחת אותו, ברגע שהיא קוראת לספק שלכם לתשובת AI.

מי יכול לקרוא את יומני ההרצה של האוטומציות שלי?

כל מי שמחובר לחשבון easyCoexistence שלכם, כולל אנשים שהזמנתם אליו, בלשונית Runs, וכל עוזר מחובר לחשבון, דרך list_automation_runs ו-get_automation_run. היומנים כוללים את הודעת הלקוח ואת התשובה, ונמחקים לאחר 30 ימים.

איך מסירים מפתח AI בבטחה?

מכבים קודם את האוטומציות שמשתמשות בו, ואת כל סוכן שפועל עליו, ואז בוחרים "הסרה" תחת מפתחות AI, ומבטלים את המפתח אצל הספק. הסרה בזמן שאוטומציות עדיין משתמשות בו מושהה אותן בתשובת ה-AI הבאה שלהן, ושולחת לכם מייל.

האם "ניסיון" שולחת נתוני לקוח לוובהוק שלי?

היא שולחת רק את הטקסט לדוגמה שהקלדתם, עם dry_run בערך true והיסטוריה ריקה. הרצות אמיתיות שולחות את ההודעה הנכנסת ואת ההודעות האחרונות של השיחה, עד 10, לכן התייחסו לנקודת הקצה שלכם כאל מטפלת בנתוני לקוחות.

המשיכו לקרוא

האם בטוח לחבר WhatsApp ל-ChatGPT או ל-Claude?איך לחבר מספר WhatsApp Business ל-ChatGPT או ל-Claude בבטחה: ה-API הרשמי, כניסה דרך OAuth, אישורים, כלים חסומים והסרת גישה.איך הודעות WhatsApp מגיעות לשרת שלכם: ישירות או מנוהלות, ואימות החתימהישיר: Meta שולחת לשרת שלכם. מנוהל: אוטומציות עונות ועותק חתום נשלח ל-Forward URL. ה-payload, X-EC-Signature ב-Node ו-Python, וניסיונות חוזרים.ענו ללקוחות ב-WhatsApp בנתונים חיים: מחירים, מלאי וזמינות ממערכת שלכםענו על שאלות מחיר, מלאי או תורים פנויים ב-WhatsApp בנתונים חיים: וובהוק חתום שואל את המערכת שלכם והתשובה יוצאת תוך 20 שניות.שליחת שיחות WhatsApp ל-CRM באופן אוטומטיתעדו שיחות WhatsApp ב-CRM מהמספר שמנהלים באפליקציה: אירועים חתומים, התאמת איש קשר לפי טלפון או BSUID, וסינון כפילויות לפי מזהה הודעה.שיטות עבודה מומלצות לאוטומציה ב-WhatsApp: 12 כללים12 שיטות עבודה לאוטומציה ב-WhatsApp, מבוססות על מדיניות Meta והמגבלות בפועל: בדיקה לפני פרסום, תשובה אחת להודעה, דרך אל אדם, חלון 24 השעות ותקרות ל-AI.אימות נקודת הקצה של וובהוק (Webhook) ב-WhatsAppMeta שולחת בקשת GET לנקודת הקצה לפני מסירת אירועים. מה נשלח, מה מחזירים ולמה תשובה שגויה נכשלת בשקט.

מוכנים להתחיל?

מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

התחילו תקופת ניסיון בחינם

נבדק ב-