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

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

Zapier מחבר אפליקציות באמצעות תהליכי עבודה אוטומטיים בשם Zaps. אפליקציית ThunderPhone ב-Zapier מוסיפה:

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

מצאו אותה ב-ThunderPhone ב-Zapier. לסקירה של שתי הדרכים להשתמש ב-Zapier עם ThunderPhone, עיינו ב- דף השילוב עם Zapier.

חברו את הארגון שלכם#

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

1. הוספת שלב ThunderPhone

   בעורך Zap, חפשו את ThunderPhone (מוצג עם תווית Beta) ובחרו טריגר או פעולה. כאשר Zapier מבקש חשבון, חברו חשבון חדש. Zapier פותח חלון כניסה ל-ThunderPhone.

2. כניסה ובחירת הארגון

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

3. בדיקת שם החיבור

   Zapier נותן לחיבור את שם הארגון שאישרתם, כך שתוכלו להבחין בין חיבורים כאשר אתם שייכים ליותר מארגון אחד.

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

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

יצירת Zap ראשון#

Zap זה מוסיף שורה ל-Google Sheet בכל פעם ששיחה מסתיימת.

1. בצעו שיחה לשימוש כנתוני דוגמה

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

2. הוסיפו את הטריגר

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

3. הוסיפו Google Sheets

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

4. פרסמו את ה-Zap

   פרסמו והפעילו את ה-Zap. הפעלתו יוצרת נקודת קצה של webhook בארגון ThunderPhone שלכם בשם Zapier: השיחה הושלמה. כיבוי ה-Zap מוחק את נקודת הקצה הזו.

5. בדקו אותו

   בצעו שיחת בדיקה נוספת בבנאי. כשהיא מסתיימת, ה-Zap פועל ומופיעה שורה.

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

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

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

טריגרים, פעולות וחיפוש#

שיחה דורגה מספק את מזהה השיחה, מזהה הסוכן, שם הסוכן והציון: מזהה הציון, ניקוד, תוצאת השיחה, סיכום, מודל המדרג ומועד הדירוג. הפעלת Zap יוצרת נקודת קצה בשם Zapier: שיחה דורגה. אפשר לדרג שיחה יותר מפעם אחת, וכל הרצת דירוג שהסתיימה מפעילה את הטריגר. ראו call.graded.

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

ביצוע שיחה יוצאת מקבל:

הפעולה מחזירה את מזהה השיחה, הסטטוס והפעלה חוזרת אידמפוטנטית.

הוספת אנשי קשר לקמפיין מוסיפה אנשי קשר לקמפיין טיוטה. עבור איש קשר אחד, מלאו את מספר טלפון בפורמט E.164, ובאופן אופציונלי את משתני איש קשר, אובייקט JSON שהמאפיינים שלו הופכים למשתני קמפיין. עבור אצווה, מלאו את JSON של אנשי קשר במערך של עד 5,000 אובייקטים. כל אובייקט דורש phone_number, ושאר המאפיינים שלו הופכים למשתנים. השלב נכשל כאשר כל אנשי הקשר נדחים, ומגדיר הצלחה חלקית כאשר רק חלק מהם נדחים.

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

לפני ש-Zap מבצע שיחות#

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

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

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

דוגמאות ל-Zaps#

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

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

פתרון בעיות#

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

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

ברצונכם לנתק את היישום. כבו את ה-Zaps של ThunderPhone לפני שאתם מבטלים את החיבור, מכיוון שכיבוי Zap מוחק את נקודת הקצה שלו ודורש חיבור פעיל. אם ביטלתם קודם, מחקו את נקודת הקצה שנותרה Zapier: … באמצעות DELETE /v1/developer/webhook-endpoints/{id} ובעזרת מפתח API של מנהל מערכת. ראו נקודות קצה של ווובהוקים.

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

הגורם המפעיל הפסיק לפעול. לכל Zap עם גורם מפעיל של ThunderPhone יש נקודת קצה אחת של ווובהוק בארגון שלכם, בשם Zapier: שיחה הושלמה או Zapier: שיחה קיבלה ציון. היא נוצרת כאשר ה-Zap מופעל ונמחקת כאשר הוא נכבה. השאירו אותה כפי שהיא. אם היא נערכה או נמחקה ב-ThunderPhone, כבו והפעילו שוב את ה-Zap כדי ליצור נקודה חדשה. בעזרת מפתח API של מנהל מערכת, GET /v1/developer/webhook-deliveries מציג ניסיונות מסירה אחרונים.