יומן Google Calendar - SuperBook CRM 🔗

סקירה כללית 🔗

SuperBook CRM מתחבר ליומן Google Calendar ומאפשר:

• תצוגת אירועים ופגישות ישירות ב-CRM
• יצירת אירועים חדשים
• עדכון אירועים קיימים
• מחיקת אירועים
• סנכרון דו-כיווני אוטומטי

גישה להגדרות: SuperBook CRM ← הגדרות Google Calendar

[צילום מסך 040: עמוד הגדרות Google Calendar]

---

דרישות מוקדמות 🔗

לפני שמתחילים, צריך:

1. חשבון Google עם גישה ל-Google Calendar
2. Google Cloud Project עם הפעלת Calendar API
3. Service Account עם מפתח JSON
4. שיתוף היומן עם ה-Service Account

הערה: התהליך דורש ידע טכני בסיסי.

הוראות מפורטות ליצירת Service Account וקבלת מפתח JSON זמינות כאן: הגדרת-יומן-גוגל

---

שלב 1: הגדרה ב-SuperBook CRM 🔗

1.1 גישה להגדרות 🔗

1. עבור לSuperBook CRM ← הגדרות Google Calendar
2. תראה טופס עם שלושה שדות עיקריים

[צילום מסך 052: עמוד הגדרות Calendar ב-CRM]

---

1.2 הדבקת Service Account JSON 🔗

1. פתח את קובץ ה-JSON שהורדת (ראה הוראות בהגדרת-יומן-גוגל)
2. העתק את כל התוכן של הקובץ
3. הדבק בשדה JSON חשבון שירות

טיפ: ודא שהעתקת את כל התוכן, כולל הסוגריים המסולסלים בהתחלה ובסוף.

[צילום מסך 053: שדה JSON ממולא]

---

1.3 הזנת Calendar ID 🔗

1. הדבק את ה-Calendar ID שהעתקת (ראה הוראות בהגדרות-יומן-גוגל)
2. בשדה מזהה לוח שנה

דוגמה: [email protected]

[צילום מסך 054: שדה Calendar ID ממולא]

---

1.4 הגדרות נוספות 🔗

משך פגישה ברירת מחדל:

• בחר משך זמן: 15, 30, 45, 60, 90, או 120 דקות
• ברירת מחדל: 60 דקות (שעה אחת)

תחילת שעות עבודה:

• בחר שעה: 00:00 עד 23:00
• ברירת מחדל: 08:00

סוף שעות עבודה:

• בחר שעה: 01:00 עד 24:00
• ברירת מחדל: 18:00

[צילום מסך 055: הגדרות נוספות]

---

1.5 שמירה והפעלה 🔗

1. לחץ על שמור הגדרות לוח שנה
2. המערכת תבדוק את החיבור ליומן
3. אם הכל תקין, תופיע הודעה: ✓ Webhook הוגדר בהצלחה

[צילום מסך 056: הודעת הצלחה]

---

1.6 בדיקת סטטוס 🔗

לאחר השמירה, תראה סטטוס Webhook:

• ✓ Webhook פעיל - החיבור פעיל
• מזהה ערוץ - מזהה הערוץ
• פג תוקף - תאריך תפוגה (מתחדש אוטומטית)

[צילום מסך 057: סטטוס Webhook]

---

שימוש ביומן ב-CRM 🔗

תצוגת היומן 🔗

לאחר הגדרה מוצלחת, היומן יופיע בצד ימין של ממשק ה-CRM.

[צילום מסך 058: ממשק CRM עם יומן]

---

יצירת אירוע חדש 🔗

שיטה 1: מכרטיס לקוח

1. פתח כרטיס לקוח
2. הגדר תאריך מעקב
3. לחץ על קביעת פגישה
4. האירוע נוצר אוטומטית עם:

• כותרת: שם הלקוח
• תאריך ושעה: לפי תאריך המעקב
• משך: לפי ברירת המחדל
• תיאור: פרטי הלקוח

[צילום מסך 059: כפתור יצירת אירוע]

---

שיטה 2: ישירות מהיומן

1. לחץ על תאריך ושעה ביומן
2. ייפתח חלון יצירת אירוע
3. מלא את הפרטים
4. לחץ שמור

[צילום מסך 060: חלון יצירת אירוע]

---

עריכת אירוע 🔗

ניתן לשנות את זמן האירוע על ידי גרירה:

1. לחץ והחזק על אירוע ביומן
2. גרור אותו למועד ושעה חדשים
3. שחרר - השינוי יישמר אוטומטית

השינויים יתעדכנו גם ב-Google Calendar.

[צילום מסך 061: גרירת אירוע ביומן]

---

מחיקת אירוע 🔗

1. לחץ על אירוע ביומן
2. לחץ על מחק
3. אשר את המחיקה

תכונה מיוחדת: כאשר מוחקים אירוע מהיומן, תאריך המעקב של הלקוח אוטומטית נעוץ (📌) כדי למנוע שינוי לא רצוי.

[צילום מסך 062: כפתור מחיקה]

---

סנכרון אוטומטי 🔗

המערכת מסנכרנת אוטומטית:

• מ-CRM ל-Google - אירועים שנוצרו/עודכנו ב-CRM
• מ-Google ל-CRM - אירועים שנוצרו/עודכנו ב-Google Calendar

זמן סנכרון: כמעט מיידי (עד דקה)

---

פתרון בעיות 🔗

היומן לא מופיע ב-CRM 🔗

בעיה: לאחר הגדרה, היומן לא מוצג בממשק

פתרונות:

1. ודא שהרישיון של SuperBook CRM תקף
2. בדוק שה-Service Account JSON נכון (כל התוכן)
3. בדוק שה-Calendar ID נכון
4. ודא ששיתפת את היומן עם ה-Service Account
5. רענן את דף ה-CRM
6. נקה מטמון דפדפן

[צילום מסך 063: דוגמה ליומן לא מוצג]

---

שגיאת Webhook 🔗

בעיה: מופיעה שגיאה "Webhook Error" לאחר שמירה

שגיאות נפוצות:

"Invalid credentials"

• בדוק שה-JSON נכון ומלא
• ודא שלא העתקת רווחים מיותרים
• נסה להוריד מחדש את קובץ ה-JSON

"Calendar not found"

• בדוק שה-Calendar ID נכון
• ודא ששיתפת את היומן עם ה-Service Account
• בדוק שהיומן קיים ב-Google Calendar

"Permission denied"

• ודא שנתת הרשאה "Make changes to events"
• בדוק שה-Service Account מופיע ברשימת השיתוף
• נסה להסיר ולהוסיף שוב את השיתוף

[צילום מסך 064: דוגמאות שגיאות]

---

אירועים לא מסתנכרנים 🔗

בעיה: אירועים שנוצרו ב-CRM לא מופיעים ב-Google או להיפך

פתרונות:

1. בדוק את סטטוס ה-Webhook (צריך להיות "active")
2. המתן דקה - הסנכרון לוקח זמן
3. רענן את Google Calendar
4. רענן את דף ה-CRM
5. בדוק שהאירוע נוצר ביומן הנכון

---

Calendar API לא מופעל 🔗

בעיה: שגיאה "Calendar API has not been used"

פתרון:

1. חזור ל-Google Cloud Console
2. עבור ל-APIs & Services ← Library
3. חפש "Google Calendar API"
4. לחץ ENABLE
5. המתן מספר דקות
6. נסה שוב ב-CRM

---

טיפים ושימושים מתקדמים 🔗

שימוש במספר יומנים 🔗

כרגע המערכת תומכת ביומן אחד. אם יש לך מספר יומנים:

• בחר את היומן הראשי לעבודה עם לקוחות
• יומנים נוספים יופיעו ב-Google Calendar אבל לא ב-CRM

---

צבעי אירועים 🔗

אירועים שנוצרו מ-CRM מקבלים צבע ברירת מחדל של Google Calendar. ניתן לשנות ידנית ב-Google Calendar.

---

תזכורות 🔗

תזכורות מוגדרות לפי הגדרות ברירת המחדל של היומן ב-Google Calendar. ניתן לשנות ידנית לכל אירוע.

---

שיתוף אירועים 🔗

אירועים שנוצרו מ-CRM הם פרטיים כברירת מחדל. ניתן לשתף או להזמין משתתפים ב-Google Calendar.

---

שאלות נפוצות 🔗

האם צריך Google Workspace (G Suite)? 🔗

לא. חשבון Google רגיל (חינמי) מספיק.

האם יש עלות ל-Google Calendar API? 🔗

לא. השימוש ב-Calendar API חינמי עד למכסה גבוהה מאוד (מספיק לרוב העסקים).

מה קורה אם ה-Webhook פג? 🔗

המערכת מחדשת אוטומטית את ה-Webhook לפני שהוא פג. אין צורך בפעולה ידנית.

האם אפשר לנתק את החיבור? 🔗

כן. מחק את ה-Service Account JSON מההגדרות ושמור. היומן יפסיק להופיע ב-CRM.

האם אירועים קיימים יימחקו? 🔗

לא. ניתוק החיבור לא משפיע על אירועים קיימים ב-Google Calendar.

---

אבטחה ופרטיות 🔗

שמירת המפתח 🔗

• קובץ ה-JSON מאוחסן בבסיס הנתונים של WordPress
• רק מנהלים יכולים לגשת להגדרות
• אל תשתף את קובץ ה-JSON עם אף אחד

הרשאות Service Account 🔗

ה-Service Account יכול:

• לקרוא אירועים מהיומן
• ליצור אירועים חדשים
• לערוך אירועים קיימים
• למחוק אירועים

ה-Service Account לא יכול:

• לגשת ליומנים אחרים (רק מה ששיתפת)
• לשנות הגדרות חשבון Google
• לגשת לשירותים אחרים של Google

---

מעבר למדריכים נוספים 🔗

• מדריך התחלה
• הגדרות מערכת מתקדמות
• אינטגרציה עם טפסים
• Webhooks ואוטומציות
• ניהול משתמשים והרשאות