השתמשו ב-ThunderPhone עם n8n

התקינו את צומת ThunderPhone עבור n8n, חברו מפתח API של שרת ובנו תהליך עבודה שפועל בכל פעם ששיחה מסתיימת.

n8n הוא כלי לאוטומציית תהליכי עבודה. חבילת ThunderPhone עבור n8n מוסיפה שני צמתים:

• ThunderPhone Trigger מפעיל תהליך עבודה כאשר שיחה מסתיימת (השיחה הושלמה) או כאשר הרצת דירוג שיחות מסתיימת (השיחה דורגה).
• ThunderPhone מבצע שיחות יוצאות, מוסיף אנשי קשר לקמפיינים ומפעיל אותם, מאחזר שיחות עם התמלול וההקלטה שלהן, ומציג את הסוכנים ומספרי הטלפון שלכם.

זהו צומת קהילה מאומת, המופיע ב- ThunderPhone ב-n8n.

התקינו את הצומת#

בעורך n8n, לחצו על + כדי לפתוח את חלונית הצמתים וחפשו את ThunderPhone. ייתכן שבעלים של מופע יצטרכו להגדיר צמתים מאומתים לפני שמשתמשים אחרים יוכלו להוסיף אותם.

ב-n8n באירוח עצמי, תוכלו גם להתקין לפי שם החבילה: פתחו את הגדרות > צמתי קהילה והתקינו את n8n-nodes-thunderphone. בדקו את הסיכונים של צמתי קהילה ואת מדיניות המופע שלכם לפני ההתקנה.

צרו מפתח API לשרת#

1. פתחו את הכרטיסייה מפתחות

   ב-ThunderPhone, עברו אל ארגון → מפתחות ולחצו על יצירת מפתח.

2. תנו לו שם

   השתמשו בשם שמציין היכן המפתח נמצא, כגון "n8n".

3. העתיקו אותו עכשיו

   הסוד המלא sk_live_... מוצג פעם אחת. העתיקו אותו לפני שתסגרו את חלון הדו-שיח.

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

הוסיפו את פרטי ההתחברות ב-n8n#

1. ב-n8n, צרו פרטי התחברות מסוג ThunderPhone API.
2. הדביקו את המפתח בשדה מפתח API.
3. שמרו אותם והריצו את בדיקת פרטי ההתחברות. הבדיקה קוראת שיחה אחת מהארגון שלכם באמצעות GET /v1/calls?limit=1.

בניית תהליך עבודה ראשון#

תהליך עבודה זה מוסיף שורה לגיליון Google בכל פעם ששיחה מסתיימת.

1. הוספת הטריגר

   הוסיפו את ThunderPhone Trigger, בחרו את אישורי ה-API של ThunderPhone, והגדירו את האירוע ל-שיחה הושלמה.

2. קבלת השיחה

   הוסיפו צומת ThunderPhone. הגדירו את המשאב ל-שיחה, את הפעולה ל-קבלה, ואת מזהה השיחה לביטוי {{ $json.data.call_id }}. הפלט הוא רשומת השיחה בתוספת transcripts ו-recording_url, קישור קצר-מועד שהוא null כאשר לשיחה אין הקלטה.

3. הוספת שורה

   הוסיפו צומת Google Sheets שמוסיף שורה, ומפו את העמודות הרצויות מפלט קבלת השיחה (ראו את הטבלה להלן).

4. הפעלת תהליך העבודה

   שמרו והפעילו. הטריגר רושם את כתובת ה-URL לייצור שלו כנקודת קצה של webhook בארגון ThunderPhone שלכם. השבתת תהליך העבודה מוחקת נקודת קצה זו.

5. בדיקה

   פתחו סוכן בבנאי, לחצו על דברו, וסיימו את השיחה. שיחות בדיקה מהבנאי נשלחות כ-web.complete, אחד משני האירועים שמאחורי שיחה הושלמה, ולכן תהליך העבודה פועל ומופיעה שורה.

עמודות שימושיות:

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

כדי להוסיף בכל זאת את התמליל, מפו את {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. כתובת ה-URL של ההקלטה פגה, לכן שמרו את מזהה השיחה והפעילו שוב את קבלת השיחה כאשר אתם זקוקים לקישור חדש. תמלילי שיחות, סיכומים והקלטות עשויים להכיל מידע אישי או מידע רפואי. שלחו אותם רק לאפליקציות שהארגון שלכם מורשה להשתמש בהן עבור נתונים אלה, במסגרת BAA כאשר מדובר במידע רפואי, ושמרו רק את השדות הדרושים לכם.

הטריגר מפיק את האירוע המלא: type, event_id ו-data. ראו telephony.complete / web.complete ואת call.graded לכל שדה. המסירה מתבצעת לפחות פעם אחת, ו-event_id נשאר זהה בין ניסיונות חוזרים של אותו אירוע, לכן בדקו אותו לפני שלב שאסור שיחזור על עצמו.

בצעו שיחות יוצאות בבטחה#

ביצוע שיחה יוצאת (משאב שיחה יוצאת, פעולה ביצוע) מקבל:

מפו את מפתח האידמפוטנטיות למזהה מכל גורם שהפעיל את הריצה, כגון מזהה רשומת CRM או event_id של הטריגר. הצומת שולח n8n:<node ID>:<your value>, לכן:

• ניסיון חוזר אוטומטי או ניסיון חוזר של ביצוע שולחים את אותו מפתח, ו-ThunderPhone מחזיר את השיחה המקורית עם idempotent_replay: true במקום לחייג שוב.
• שני צמתי ThunderPhone שמוזנים מאותה רשומה שולחים מפתחות שונים.
• ערך ריק נכשל לפני שנשלחת בקשה כלשהי.

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

קמפיינים. הוספת אנשי קשר (משאב קמפיין) מוסיפה אנשי קשר לקמפיין טיוטה. היא מקבלת מזהה קמפיין ומערך JSON של אנשי קשר. כל איש קשר זקוק ל-phone_number; מפתחות אחרים הופכים למשתני שיחה. הצומת נכשל כאשר כל אנשי הקשר נדחים ומגדיר partial_success: true כאשר רק חלק מהם נדחים. התחלה מחייבת את תיבת הסימון המאשרת שהקמפיין מבצע שיחות אמיתיות ומשתמש בקרדיטים של ThunderPhone. ראו קמפיינים יוצאים.

לפני שזרימת עבודה מתחילה שיחות:

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

דוגמאות לזרימות עבודה#

• אנשי קשר מ-CRM לקמפיין. הוסיפו אנשי קשר מ-CRM לקמפיין טיוטה של ThunderPhone, ואז התחילו את הקמפיין לאחר שמישהו מאשר את הרשימה.
• שיחה שהושלמה לרשומת הלקוח. בעת השלמת שיחה, הפעילו את קבלת השיחה ושמרו את התמליל וקישור ההקלטה ברשומת הלקוח התואמת.
• ציונים נמוכים לבדיקה. בעת דירוג שיחה, סננו לפי {{ $json.data.grade.score }} ונתבו שיחות בעלות ציון נמוך לתור בדיקה עם מזהה השיחה ופרטי הציון. ניתן לדרג שיחה יותר מפעם אחת, וכל ריצת דירוג שהסתיימה מפעילה את הטריגר, לכן שמרו רק את הערך האחרון של graded_at עבור כל מזהה שיחה.

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