Google Sheets

חברו את הסוכן ל-Google Sheets כדי שרגעים שימושיים בשיחה, כמו ליד מתאים, שאלה שלא נענתה, בקשת תכונה או הדגמה, יהפכו לשורות בגיליון שהצוות כבר משתמש בו. אין Zapier, webhook או קוד: החיבור בלחיצה אחת ויוצר פעולת AI רגילה שאפשר לערוך.

בדיקות דוגמה אופציונליות

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

• בדיקת תנאי הרצת פעולה. העריכו תנאים מול נתוני דוגמה בלי להריץ פעולה.

איך זה עובד

פעולת AI היא בקשת HTTP עם תיאור, והוספת שורה לגיליון היא בקשה כזו. ל-Google Sheets נקודת append שמוסיפה שורה ללשונית; כל דיווח הוא POST אליה עם ערכי השורה בגוף.

כדאי לדעת מראש:

• העמודות אינן קבועות. הן מה שהפעולה שולחת. מגדירים בעריכת גוף הבקשה ושורת הכותרות, כך שאותו חיבור יכול לתעד לידים, תקלות או כל דבר אחר.
• הרשאות מצומצמות. החיבור מבקש רק drive.file, שמעניק גישה לקבצים שהוא יוצר בלבד. אין גישה ליתר ה-Drive.
• ה-AI אינו רואה פרטי גישה. הבקשה כוללת כותרת Authorization עם {{google_sheets_access_token}}. Quickchat מחליפה באסימון אמיתי שמתחדש אוטומטית אחרי חלקו של המודל; האסימון אינו נכנס לפרומפט.

חיבור Google Sheets

פתחו פעולות ו־MCP, לחצו הוספת פעולה ובחרו Google Sheets.

חלונית החיבור מסבירה מראש מה ייווצר: גיליון חדש ב-Drive ופעולת רישום מוכנה ללידים. לחצו חיבור, בחרו את חשבון Google שבו יישמר הגיליון ואשרו drive.file.

הלחיצה מבצעת שני דברים אוטומטית:

1. יוצרת גיליון ב-Google Drive עם לשונית Leads ושורת כותרות.
2. מוסיפה פעולת AI אחת כבויה (log_lead_to_google_sheet), שכבר מחוברת לגיליון.

Note

אם תמחקו את הפעולה המתחילה, פתחו שוב הוספת פעולה ← Google Sheets והשתמשו בחיבור מחדש. הפעולה נוצרת מחדש ומשתמשת בגיליון הקיים במקום ליצור נוסף.

פעולת הרישום שנוצרה

הפעולה היא פעולת API רגילה וניתנת לעריכה מלאה. היא מופיעה תחת פעולות מותאמות אישית, כבויה כדי שתוכלו לבדוק לפני הפעלה.

מכיוון ש-Quickchat יצרה את הגיליון והפעולה יחד, הכתובת כבר כוללת את מזהה הגיליון:

https://sheets.googleapis.com/v4/spreadsheets/<your sheet ID>/values/Leads:append?valueInputOption=RAW

השאירו valueInputOption=RAW כדי שהודעה המתחילה ב-= או + תישמר מילולית ולא כנוסחה. הכותרות זהות בכל דיווח:

מפתח	ערך
Authorization	Bearer {{google_sheets_access_token}}
Content-Type	application/json

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

{ "values": [["{{email}}", "{{what_they_asked}}", "{{conversation_url}}", "{{conversation_channel}}"]] }

לכן העמודות נקבעות בגוף ובשורת הכותרות, ולא מקובעות בחיבור. {{conversation_url}} (קישור ישיר לתיבה) ו-{{conversation_channel}} (מקור המבקר) הם משתנים מובנים הזמינים לכל פעולה.

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

רישום כל סוג מידע, מעבר ללידים

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

https://sheets.googleapis.com/v4/spreadsheets/<your sheet ID>/values/Unanswered:append?valueInputOption=RAW

דיווחים נפוצים לצד לידים:

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

Tip

הוסיפו עמודות באמצעות פרמטרים בגוף וכותרות תואמות בגיליון. השתמשו ב-{{metadata_*}} לרישום מידע שכבר נמצא בשיחה. ראו משתני פעולות AI לרשימה המלאה.

שאלות נפוצות

צריך Zapier, webhook או קוד? לא. Quickchat מתחברת ישירות לגיליון דרך פעולת AI, בקשת HTTP שהסוכן מבצע בשיחה. לחיצה אחת יוצרת את הגיליון ואת פעולת הרישום הראשונה.

האם הנתונים ב-Google Drive בטוחים? כן. נדרשת רק הרשאת OAuth ‏drive.file, המעניקה גישה רק לקבצים שהחיבור יוצר. אי אפשר לקרוא או לשנות דבר אחר ב-Drive, ואסימון הגישה אינו נחשף למודל.

באילו ערוצים זה עובד? בכולם. אותן פעולות פועלות בכל מקום שבו הסוכן פרוס, כמו ווידג’ט, Slack ו-WhatsApp, והעמודה {{conversation_channel}} מתעדת מהיכן הגיעה כל שורה.

מידע נוסף

• פעולות מותאמות אישית: איך פעולות עובדות ואיך לערוך אותן.
• משתני פעולות AI: מצייני המקום {{...}} שאפשר להכניס לשורה.
• חיבור סוכן ל-Google Sheets: מדריך מלא לבניית ארבעת הדיווחים והתאמתם.