Webhooks והתראות ב-Slack, Microsoft Teams או Discord
התשובה הקצרה
ב-Pro וב-Team פתחו את לוח הבקרה > "אינטגרציות" כדי לשלוח אירועים של Pandafile לערוץ ב-Slack, Microsoft Teams או Discord, או לשרת שלכם כ-Webhook חתום. בחרו אירועים, שלחו בדיקה ובדקו את יומן המסירות.
ב-Pro וב-Team, Pandafile יכול לעדכן את הכלים האחרים שלכם ברגע שמשהו קורה: בהודעה בערוץ Slack, Microsoft Teams או Discord, או ב-Webhook, כלומר בקשת HTTPS חתומה לשרת שלכם.
אירועים שאפשר לבחור
- ההעברה מוכנה: ההעלאה הסתיימה והקישור עובד.
- ההעברה הורדה: פעם אחת לכל נמען, בהורדה הראשונה. אפשר לבחור במקום זה כל הורדה.
- תוקף ההעברה פג.
- אישור או בקשת שינויים מנמען.
- העלאה לאחת מבקשות הקבצים שלכם.
- המסמך נחתם על ידי כולם, ב-Pandafile Sign.
הוספת אינטגרציה
- ב-Slack, Microsoft Teams או Discord צרו Webhook נכנס לערוץ והעתיקו את ה-URL שלו. למערכת שלכם, השתמשו בכתובת HTTPS בשרת שלכם.
- התחברו ל-Pandafile ופתחו את לוח הבקרה > "אינטגרציות".
- תחת "הוספת אינטגרציה" בחרו את הסוג, הדביקו את ה-URL, הוסיפו שם אם תרצו וסמנו את האירועים הרצויים.
- לחצו על "הוספת אינטגרציה", ואז על "שליחת אירוע בדיקה" כדי לוודא שהוא מגיע.
אפשר להגדיר עד 5 אינטגרציות. הודעות הצ'אט נכתבות בשפת החשבון שלכם.
Webhooks למפתחים
- כל מסירה היא JSON POST עם סוג האירוע, מזהה (id) והפרטים: מזהים, כותרות, קישורים, ספירות וכתובות המייל של הנמענים. היא אף פעם לא מכילה תוכן קבצים, סיסמאות או קישורי הורדה אישיים.
- בכל בקשה יש כותרת Pandafile-Signature עם חותמת זמן (t) וחתימת HMAC-SHA256 (v1) של חותמת הזמן והגוף, שנוצרה עם סוד החתימה שלכם. הסוד מתחיל ב-whsec_ ומוצג פעם אחת בלבד.
- "סוד חדש" יוצר סוד חתימה חדש. הישן ממשיך לעבוד 24 שעות, כך שאפשר לעבור בלי לפספס אירועים.
- ענו עם סטטוס 2xx בתוך 10 שניות. אחרת ננסה שוב אחרי דקה, 5 דקות, 30 דקות, שעתיים ו-12 שעות.
- יומן המסירות מציג את 50 המסירות האחרונות של כל אינטגרציה ואת התוצאה שלהן.
צוותים, מצב בדיקה ו-Zapier
בצוות כל אחד מנהל את האינטגרציות שלו ומקבל אירועים רק על ההעברות שלו. אירועים על העברות בדיקה שנוצרו עם מפתח API לבדיקה נשלחים ל-Webhooks עם livemode שערכו false, ואף פעם לא ל-Slack, Teams או Discord. Zapier ו-Make מתחברים דרך ה-API של Pandafile ומופיעים תחת "מינויים דרך ה-API".