מדריכים למפתחים

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

איך Kavchat בנוי

1. לוח הבקרה. אתם והצוות נכנסים ל-app.kavchat.com. לכל סביבת עבודה יש מפתח ציבורי (pk_live_...) ומפתח סודי (sk_live_...), ושניהם מופיעים בעמוד התקנה.
2. תסריטים. בעורך הוויזואלי בונים תסריטים משלבים. בכל שלב יש הודעה, כפתורים ומילות מפתח. כפתור מוביל לשלב אחר, לתסריט אחר, לקישור, למסך באפליקציה שלכם או לטופס הפנייה.
3. פרסום. כל פרסום נשמר כגרסה ממוספרת. אתם קובעים מי רואה את הבוט: אף אחד, רק בודקים (לפי מספר טלפון) או כולם. אפשר לשחזר גרסה קודמת בכל רגע, בלי לעדכן את האפליקציה.
4. ווידג'ט או ערכת פיתוח. האתר טוען את הווידג'ט עם המפתח הציבורי, והאפליקציה משתמשת באחת מערכות הפיתוח למובייל. הן מורידות את הגרסה שפורסמה, שומרות אותה במכשיר ומנהלות בו את השיחה.
5. טוקן זהות (לא חובה). כשמשתמש מחובר, השרת שלכם חותם JWT קצר במפתח הסודי. כך Kavchat מצמיד לשיחה ולפנייה את מזהה המשתמש שלכם, ויכול להציג בוט שפתוח רק לבודקים לאנשים הנכונים.
6. פניות ו-webhook. כשהתסריט לא פותר את הבעיה, טופס הפנייה פותח פנייה עם השיחה המלאה. היא מגיעה לתיבת הפניות בלוח הבקרה, ובפרימיום נשלחת גם למערכת שלכם ב-webhook חתום. השרת שלכם יכול גם לקרוא ולסגור פניות דרך ה-Server API.

שני מפתחות, שני מקומות

התחלה מהירה

באתר מספיקה השורה הזו לפני </body>. העתיקו אותה עם המפתח שלכם מעמוד התקנה בלוח הבקרה:

<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>

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

המדריכים

צריכים עזרה?

כתבו לנו ל-support@kavchat.com. ה-API המלא מתואר בקובץ openapi.yaml (OpenAPI 3.1).