כתיבת מדריך טכני שעובד באמת מתחילה בהבנה של פער הידע בין המפתח ללקוח. הלקוח האחרון שבדקנו במערכת הפנימית של Studio Pro הפסיד 120 שעות עבודה בחודש של צוות התמיכה. הסיבה? מסמך הוראות שהמתכנת הראשי כתב ללקוחות הקצה. כשהאנשים שבונים את המוצר כותבים את הוראות ההפעלה שלו, התוצאה היא טקסט הנדסי שאף אחד מחוץ למחלקת הפיתוח לא מבין.
פער הידע בין צוות הפיתוח ללקוח מייצר עומס אדיר על התמיכה. תרגום נכון של הפעולות חותך את הפניות בעשרות אחוזים.
- ◆הגדירו את הפעולה הסופית של הלקוח לפני המילה הראשונה
- ◆תרגמו תכונות הנדסיות וממשקיות לתוצאות בעולם האמיתי
- ◆מדדו את הצלחת המסמך דרך נתוני הנטישה בתוך שלוש דקות
אנחנו רואים את זה חוזר על עצמו מאות פעמים אצל חברות תוכנה ושירותים. מנהל הפיתוח כותב מסמך יסודי שמתאר את הארכיטקטורה. הוא מסביר איך המערכת עובדת מאחורי הקלעים ומפרט על כל שדה במסד הנתונים. הלקוח שניסה להפיק חשבונית קורא את הפסקה הראשונה, סוגר את העמוד מיד, ומרים טלפון לשירות לקוחות. בשטח זה נראה אחרת לגמרי. הלקוח לא רוצה ללמוד איך המערכת שלכם בנויה, הוא פשוט רוצה לדעת על איזה כפתור ללחוץ כדי לסיים את המשימה שלו ולחזור הביתה.
1הגדירו את הפעולה הסופית לפני כל כתיבת מדריך טכני
רוב המדריכים במרכזי התמיכה מתחילים בהסבר ארוך ומתיש על מה המודול החדש עושה. זו טעות נפוצה שעולה לכם ביוקר זמן אוויר של נציגי שירות. הלקוח הגיע למסמך כי הוא נתקע בתהליך מסוים ולא הצליח להתקדם. הוא מחפש פתרון מהיר, לא הרצאה אקדמית על טכנולוגיה.
הצעד הראשון שלכם הוא לנסח את כותרת המסמך כפעולה שהלקוח רוצה להשלים. אל תקראו למסמך מודול ניהול משתמשים. במקום זה, קראו לו איך להוסיף עובד חדש למערכת. השינוי הקטן הזה משנה את כל הפרספקטיבה ומכריח אתכם לכתוב את המסמך סביב המטרה של הלקוח ולא סביב המבנה של המוצר.
30 שניות
זה חלון הזמן שיש לכם להראות ללקוח שהמסמך פותר לו את הבעיה לפני שהוא נוטש לטובת מוקד התמיכה שלכם.
אם בתוך חצי דקה הלקוח לא הבין שהוא הגיע למקום הנכון, איבדתם אותו. לכן, הפסקה הפותחת חייבת להכיל הצהרת כוונות פשוטה. תגידו מיד: המסמך הזה יראה לכם איך לאפס את הסיסמה שלכם בלי לפנות למנהל הרשת.
2תרגמו תכונות הנדסיות לתוצאות בעולם האמיתי
מהנדסים מדברים במונחים של שדות דאטה, קריאות שרת והרשאות מערכת. משתמשים אמיתיים מדברים במונחים של שעות עבודה, עובדים וחשבוניות מס. כשאתם משאירים מונחים מקצועיים בתוך המדריך שניסחתם ב-HubSpot או בכל פלטפורמת ניהול ידע אחרת, אתם מייצרים חומה אטומה בין הלקוח לפתרון.
כדי לשבור את החומה הזו לחלוטין, אתם צריכים לבנות תהליך המרה ברור שעושה סדר. הנה הדרך המעשית להפוך טקסט הנדסי כבד לפעולות פשוטות:
הטכניקה הזו מבטיחה שהלקוח יזהה את הכוונה שלו בתוך הטקסט מיד וללא מאמץ. אם השארתם מושג טכני שרק צוות הפיתוח שלכם מבין, הכשלתם את המדריך כולו. הלקוח ירגיש שזה גדול עליו וירים את הטלפון.
| המושג הטכני | שפת מתכנתים (פסול) | שפת לקוחות (תקין) |
|---|---|---|
| יצירת ישות נתונים | הזן את משתני המערכת לשדות | הכנס את שם העובד והטלפון שלו |
| תהליך אימות הרשאות | המערכת תבצע ולידציה לאסימון | הקש את הסיסמה החדשה שנשלחה אליך |
| שגיאת תקשורת נתונים | שגיאה 404 בהתחברות למסד | בדוק את חיבור האינטרנט שלך ונסה שוב |
3נקו את הטקסט מהנחות יסוד מוקדמות
הבעיה המרכזית עם מפתחים שמנסים להדריך לקוחות היא קללת הידע. הם שוכחים איך זה להיות אדם שרואה את המסך הזה בפעם הראשונה בחייו. כתוצאה מכך, הם מדלגים על שלבים שנראים להם מובנים מאליהם, אבל עבור הלקוח הם מחסום בלתי עביר.
אתם לא יכולים לכתוב גש להגדרות הפרופיל אם לא הסברתם איפה הכפתור הזה נמצא. אל תניחו שהלקוח יודע שהאייקון של גלגל השיניים מסמל הגדרות. הנה הרשימה המדויקת של מה שאתם חייבים להסביר בכל שלב:
- ציינו במדויק איפה נמצא הכפתור במסך: לחץ על כפתור השמירה הירוק בפינה השמאלית העליונה.
- הסבירו מה יקרה אחרי הלחיצה: יפתח חלון חדש ובו רשימת הלקוחות.
- תנו דרך מילוט במקרה של שגיאה: אם החלון לא נפתח, ודאו שחוסם הפופ אפים שלכם כבוי.
ראינו ב-Studio Pro מקרים שבהם חסר של אחד קטן בשרשרת הפעולות ייצר מאות פניות שירות בחודש בודד. לקוחות נתקעו בדיוק בנקודה שבה המדריך יצא מנקודת הנחה שהם יבינו לבד מה לעשות הלאה.
רוצים לקדם את העסק יחד עם יניר כהן?
יניר כהן הוא הראש הטכנולוגי של סטודיו פרו — שיחה קצרה ואישית שבה נבין לאן אתם רוצים להגיע ונראה אם יש בינינו התאמה. ללא עלות וללא התחייבות.
4הכוונו את המבט של הלקוח בעזרת תמונות מסך ברורות
הלקוחות שלכם סורקים את המסך, הם לא קוראים אותו משפט אחרי משפט. אם כתבתם מסמך של אלף מילים בלי להראות להם איפה למצוא את הכפתור, הם יוותרו באמצע. טקסט ארוך מייצר עייפות ויזואלית שדוחפת את הלקוח לחפש עזרה אנושית.
כל פעולה משמעותית צריכה להיות מלווה בצילום מסך ממוקד. אבל צילום מסך רגיל לא מספיק. אתם חייבים להראות ללקוח בדיוק לאן להסתכל בתוך התמונה כדי שלא ילך לאיבוד בים המידע שעל המסך.
- צלמו רק את האזור הרלוונטי במסך: אין צורך להראות את כל הדפדפן ואת התפריטים שמסביב.
- סמנו את הכפתור הרצוי במסגרת אדומה או חץ בולט: הלקוח צריך למצוא את היעד תוך שתי שניות.
- טשטשו מידע לא רלוונטי: כל דבר שלא תורם להבנת הפעולה, מסיח את הדעת.
כשאתם משלבים ויזואליה נכונה עם שפה שמדברת בתוצאות, אתם מקצרים את זמן הפתרון של הלקוח. ב-ניהול עסק, כל דקה שחסכתם ללקוח מתורגמת ישירות לחיסכון בהוצאות שכר של נציגי התמיכה שלכם.
5בדקו את יעילות המדריך מול משתמש אפס
זה השלב האסטרטגי שרוב החברות מוותרות עליו. מנהל המוצר אישר את המסמך ומיד מעלים אותו לאוויר לכלל הלקוחות. זו הסיבה שהרבה פעמים, דווקא המסמכים המושקעים והארוכים ביותר מייצרים את נפח התלונות הגבוה ביותר כשאנחנו מנתחים מערכי תמיכה ולומדים על התנהגות צרכנים.
הפעולה הפשוטה ביותר היא לתת את המסמך לאדם בחברה שלא עבד מעולם על הפיתוח של המודול הזה. איש מכירות, פקידת קבלה, או איש כספים. בקשו ממנו לבצע את הפעולה במערכת אך ורק בעזרת המדריך שכתבתם. הנה המדדים האמיתיים שקובעים אם נכשלתם בבדיקה:
- משך קריאה ארוך משלוש דקות: המסמך עמוס מדי בפרטים טכניים מיותרים וצריך לפצל אותו למסמכים קצרים.
- המשתמש שואל שאלת הבהרה: חסר שלב קונקרטי בתוך רצף הפעולות שכתבתם.
- החיפוש בטקסט לא מוצא את המונח הנכון: השתמשתם בשפה מקצועית שהלקוח שלכם לעולם לא יקליד.
שימוש יומיומי בנתונים מתוך מערכות כמו Google Search Console יכול להראות לכם בדיוק אילו מונחים ושאלות הלקוחות מחפשים ברשת. השתמשו במילים המדויקות האלה בכותרות שלכם כדי להקל עליהם למצוא את הפתרון ללא עזרה אנושית.
השורה התחתונה
לקוחות לא קוראים מדריכים טכניים בזמנם הפנוי. הם פותחים אותם אך ורק כי הם נתקעו בעבודה וצריכים עזרה כאן ועכשיו. כל מילה מקצועית ומיותרת שלכם מעכבת אותם ומקרבת אותם לנציג השירות שלכם בטלפון.
הצעד הראשון שלכם למחר בבוקר: כנסו למערכת ניהול הידע שלכם, מצאו את שלושת המדריכים הנצפים ביותר, ופתחו אותם לעריכה. עברו על פסקת הפתיחה והסירו כל מונח מקצועי או הסבר הנדסי. במקומם, הכניסו רשימה ממוספרת של הפעולות הנדרשות. אחרי עשרה ימים, היכנסו לדוחות השירות ובידקו את כמות הפניות סביב אותם נושאים בדיוק. כשהמספרים ירדו ב-20 עד 30 אחוז, תבינו שפשוט התחלתם לדבר בשפה הנכונה.
הצעד הבא של העסק שלכם מתחיל בשיחה אחת
כמה דקות של שיחה עם יניר כהן, בלי התחייבות ובלי לחץ — נבין מה חשוב לכם ולאן כדאי לקחת את זה מכאן.
