מה זה Webhook
היום מושג חדש, ולדעתי אחד החשובים בקורס: Webhooks.
עד עכשיו, בכל מה שעשינו עם APIs (מזג האוויר, שליחת המיילים ב-Resend), התקשורת זרמה לכיוון אחד. השרת שלנו פנה החוצה. הוא יזם את הבקשה, כדי לקבל מידע או כדי שמישהו יבצע פעולה.
אבל לפעמים רוצים את ההפך. שמערכת חיצונית תפנה אלינו ותספר לנו שמשהו קרה. למשל: לקוח קובע פגישה ביומן שלכם, ומערכת הפגישות מודיעה על כך לאתר, שמעדכן לבד את התאריך והשעה בכרטיס הלקוח.
זה Webhook. הצד ההפוך של API: במקום שאנחנו נשאל, העדכון נדחף אלינו (Push), בזמן אמת.
נרשמים ל-Cal.com
בשביל תיאום הפגישות נשתמש ב-Cal.com (cal.com), שירות שזה בדיוק מה שהוא עושה.
אחרי ההרשמה הוא מתחבר ליומן הגוגל שלכם, יודע מתי אתם פנויים, ונותן לכם קישור לקביעת פגישות. למשל, פגישות של 30 דקות. תכינו את הקישור הזה מראש, נצטרך אותו עוד רגע.
מה מבקשים מ-Claude Code, ומה זה Webhook Secret
עם הקישור ביד, עוברים ל-Claude Code בתיקיית ה-CRM ומבקשים:
- לחבר את האפליקציה ל-Cal.com.
- להוסיף לכל כרטיס ליד אפשרות לשלוח קישור לקביעת פגישה.
- ליצור בשרת שלנו Endpoint שמקבל את ה-Webhooks מ-Cal.com ומעדכן את הנתונים.
- לעשות
deployבסוף.
אחרי כמה דקות Claude מסיים, ומבקש מכם לעשות עוד שלב אבטחה בטרמינל: ליצור Webhook Secret.
למה צריך את זה? כי ה-Endpoint שלנו הוא כתובת פתוחה באינטרנט. כל אחד יכול לשלוח אליה הודעה שנראית כאילו הגיעה מ-Cal.com. ה-Secret הוא מפתח משותף שרק אתם ו-Cal.com מכירים, ובעזרתו השרת מאמת שההודעה באמת הגיעה משם. הודעה בלי חתימה נכונה פשוט נזרקת.
ההגדרה:
- יוצרים בטרמינל (PowerShell) מחרוזת סודית.
- שומרים אותה ב-Secrets של Cloudflare עם
wrangler secret put, תחת השםWEBHOOK_SECRET.
מגדירים את ה-Webhook ב-Cal.com, ובודקים עם Ping
עכשיו צריך להגיד ל-Cal.com לאן לשלוח את העדכונים:
- מעתיקים מ-Claude Code את כתובת ה-Endpoint שהוא יצר (משהו שמתחיל ב-
graphs.wins.../api/webhooks/cal). - ב-Cal.com נכנסים ל-Settings, אחר כך ל-Webhooks, ולוחצים New.
- מדביקים את הכתובת, מפעילים (Enable), ומסמנים את האירועים שמעניינים אתכם, כמו קביעת פגישה וביטול פגישה.
- בשדה ה-Secret מדביקים את המחרוזת שיצרתם קודם, ולוחצים Create Webhook.
- גוללים למטה ולוחצים Ping test. אם חוזר 200 OK ירוק (
Passed), Cal.com מדבר עם השרת שלכם.
בדיקה מקצה לקצה
Ping זה נחמד, אבל אני רוצה לראות את כל התהליך עובד באמת, כמו שלקוח יחווה אותו:
- נכנסים ל-CRM, מרעננים ופותחים כרטיס ליד. אני בחרתי ב-Eli Barnes.
- לוחצים על הכפתור החדש Send meeting link. נשלח מייל לליד, עם קישור ליומן ב-Cal.com.
- פותחים את המייל ולוחצים על הקישור, כאילו אתם הלקוח.
- בוחרים מועד פנוי (אני בחרתי 20 באוקטובר, 10:00 בבוקר) ומאשרים.
- חוזרים ל-CRM ופותחים שוב את הכרטיס של Eli Barnes. למטה, תחת Meetings, מחכה הפגישה: 20 באוקטובר, 10:00, בסטטוס Booked.
אף אחד לא הקליד את הפגישה הזו ב-CRM. ברגע שהלקוח אישר, Cal.com שלח Webhook לשרת, והשרת עדכן את הכרטיס.
איפה אנחנו עומדים
תעצרו רגע ותסתכלו על מה שיש לכם עכשיו. השרת שלנו מדבר עם העולם בשני הכיוונים: הוא פונה בעצמו לשירותים חיצוניים (מזג אוויר, מיילים ב-Resend), והוא גם מקבל עדכונים שנדחפים אליו בזמן אמת (Webhooks מ-Cal.com).
זה היה כנראה השיעור הכי מורכב בסדרה, ועברתם אותו. 83% מהקורס מאחוריכם.
סדנה חדשה · בזום · 9.11 ו-12.11 יש לכם קובץ אקסל שעובד? הפכו אותו לאתר חי, עם Claude Code שני מפגשים של שעתיים, בלי ניסיון בתכנות. יוצאים עם אתר אמיתי בכתובת משלכם. לפרטים והרשמה ←