API לניתוח שיחות AI: חיבור כל מערכת טלפוניה ו-CRM
כל מערכת שיכולה לשלוח בקשת HTTP יכולה לשלוח שיחות ל-TalkWiz: מרכזייה, מערכת חיוג, CRM, קוד שלכם או כלי אוטומציה כמו n8n, Make ו-Zapier. הניתוח חוזר אליכם דרך ה-API או ב-webhook חתום, אוטומטית אחרי כל שיחה.
עודכן
מה אפשר לחבר
החיבור הישיר של TalkWiz הוא ל-CallMarker. כל מערכת אחרת מתחברת דרך ה-API הפתוח:
- מרכזייה, מערכת חיוג או CRM שיכולים לשלוח בקשת HTTP כשהשיחה מסתיימת.
- כלי אוטומציה בלי קוד: n8n, Make ו-Zapier. מגדירים צעד ששולח את השיחה ל-TalkWiz, בלי לכתוב שורת קוד.
- קוד שלכם, בכל שפה.
אין לכם דרך לשלוח שיחות אוטומטית? אפשר גם להעלות הקלטות וקבצי תמלול.
מה ה-API עושה
- שליחת שיחה לניתוח: בקשת
POSTלכתובת/api/v1/callsעם התמלול ופרטי השיחה. אפשר לשלוח שיחה אחת או עד 100 שיחות בבקשה. התשובה חוזרת מיד, והניתוח רץ ברקע. - פרטי השיחה: התמלול הוא שדה החובה היחיד. אפשר להוסיף מזהה שיחה, מועד, משך, כיוון, נציג, לקוח וטלפון, קמפיין ותוצאה. נציג חדש נוצר אוטומטית, ומספרים ישראליים מומרים לפורמט בינלאומי.
- בלי כפילויות: שליחה חוזרת עם אותו
external_call_idלא יוצרת שיחה כפולה. - הקלטה במקום תמלול: רושמים את ההקלטה, מעלים את הקובץ לכתובת חתומה שחוזרת מה-API, ומסיימים. TalkWiz מתמלל בעברית, מפריד בין הנציג ללקוח ומנתח. פורמטים: mp3, m4a, mp4, wav, webm, ogg, flac, עד 25MB לקובץ.
- קריאת תוצאות:
GET /api/v1/calls/{id}מחזיר את מצב השיחה, ו-GET /api/v1/calls/{id}/analysisמחזיר את הניתוח.
כל השדות, דוגמאות מוכנות להעתקה ומפרט OpenAPI מלא נמצאים בתיעוד ה-API.
הניתוח חוזר אליכם: webhook חתום
אחרי שהשיחה נותחה, TalkWiz יכול לשלוח את הניתוח לכל כתובת שתבחרו, בפורמט JSON. כך הסיכום והתוצאה מגיעים ל-CRM שלכם, למאנדיי דרך Make או Zapier, או לכל מערכת שמקבלת webhook.
- בוחרים מה לשלוח: סיכום קצר, תוצאת השיחה, ציון, צעדים הבאים, הודעת פולואפ מוצעת, הסטטוס שהנציג סימן מול השיחה, נתונים שחולצו, התנגדויות וקישור לשיחה ב-TalkWiz.
- בוחרים מתי: אוטומטית אחרי כל ניתוח, או רק בלחיצה מדף השיחה.
- כל בקשה חתומה בכותרת
X-TalkWiz-Signature: HMAC-SHA256 של גוף הבקשה עם מפתח חתימה שמוצג לכם פעם אחת. כך המערכת שלכם יודעת שהבקשה באמת הגיעה מ-TalkWiz. - יומן משלוחים מראה מה נשלח, מה נכשל ולמה, ויש כפתור ששולח את השיחה האחרונה לבדיקה.
הגדרה, שלב אחרי שלב
- יוצרים מפתח API: מנהל מערכת בארגון יוצר מפתח בהגדרות, תחת "מפתחות API". שומרים אותו במקום בטוח.
- שולחים שיחה: מהמערכת שלכם, או מצעד HTTP ב-n8n, Make או Zapier, שולחים
POSTלכתובת/api/v1/callsעם הכותרתAuthorization: Bearerוהמפתח. הדוגמה בתיעוד עובדת כמו שהיא. - בודקים שהשיחה הגיעה: היא מופיעה ברשימת השיחות, ותוך זמן קצר גם הניתוח שלה.
- מחזירים את הניתוח (לא חובה): בהגדרות, תחת "החזרת נתונים", מוסיפים webhook עם כתובת https, בוחרים שדות ומועד שליחה, ושומרים את מפתח החתימה. שולחים שיחה לבדיקה ובודקים ביומן שהיא הגיעה.
כמה זה עולה בטוקנים
טוקן הוא דקה אחת של ניתוח:
- שיחה שנשלחה כתמלול: טוקן אחד לכל דקה מתחילה של שיחה.
- שיחה שנשלחה כהקלטה: עוד 2 טוקנים לכל דקה על התמלול, כלומר 3 טוקנים לדקה בסך הכול.
- שיחה בלי שיחה אמיתית, למשל ניתוק מיד אחרי המענה: לא מנותחת ולא מחויבת על ניתוח.
- החזרת הניתוח ב-webhook: בלי טוקנים.
החבילות והמחירים בעמוד המחירים.
פרטיות, אבטחה ומגבלות
- מפתחות API נוצרים רק על ידי מנהלי מערכת, מוצגים פעם אחת ונשמרים כגיבוב בלבד. אפשר ליצור חדש בכל רגע.
- פרטים רגישים כמו מספרי כרטיס אשראי, תעודת זהות וחשבון בנק מוסתרים אוטומטית לפני השמירה, והתמלולים נשמרים מוצפנים.
- פרטי ה-webhook שלכם, הכתובת ומפתח החתימה, נשמרים מוצפנים. TalkWiz שולח רק לכתובות https ציבוריות.
- מגבלות: עד 60 בקשות לדקה למפתח, גוף בקשה עד 1MB ותמלול עד 200,000 תווים.
רוצים לראות מה חוזר מכל שיחה? הציצו בניתוח לדוגמה. הניתוח משמש לבקרת איכות שיחות ולאימון אנשי מכירות, ואם עוד לא בחרתם דרך חיבור, כל האפשרויות מרוכזות בעמוד החיבורים. רקע על מה הניתוח בודק יש במדריך לניתוח שיחות AI.
שאלות נפוצות
יש לכם חיבור מובנה למרכזייה או למערכת החיוג שלנו?
החיבור הישיר היחיד היום הוא ל-CallMarker. כל מערכת אחרת מתחברת דרך ה-API, דרך כלי אוטומציה כמו n8n, Make או Zapier, או בהעלאה של הקלטות וקבצים.
צריך מתכנת כדי לחבר?
לא בהכרח. ב-n8n, Make ו-Zapier מגדירים צעד ששולח בקשת HTTP לכתובת /api/v1/calls עם מפתח ה-API בכותרת. התיעוד כולל דוגמה מלאה שאפשר להעתיק.
מה קורה אם אותה שיחה נשלחת פעמיים?
אם שולחים external_call_id, שהוא מזהה השיחה במערכת שלכם, שליחה חוזרת עם אותו מזהה לא יוצרת שיחה כפולה.
אפשר לשלוח הקלטה במקום תמלול?
כן. רושמים את ההקלטה, מעלים את הקובץ לכתובת חתומה שחוזרת מה-API, ומסיימים. TalkWiz מתמלל את ההקלטה, מפריד בין הנציג ללקוח ומנתח אותה כמו כל שיחה.
איך יודעים שה-webhook באמת הגיע מ-TalkWiz?
כל בקשה חתומה בכותרת X-TalkWiz-Signature: HMAC-SHA256 של גוף הבקשה עם מפתח חתימה שמוצג לכם פעם אחת בזמן ההגדרה. המערכת שלכם מחשבת את החתימה ומשווה.