ממשקים למפתחים: API ו-Webhooks לכל השירותים
למיקרופיי מגוון ממשקי API ו-Webhooks שמאפשרים לקבל ולשלוח מידע מכל השירותים: שליחה וקבלת סמס, הודעות קוליות ו-IVR, OTP וניהול אנשי קשר. הכול בפרוטוקול HTTP סטנדרטי, בשיטת GET, POST או JSON, מכל שפת פיתוח.
בנינו את הממשקים כך שכל מפתח יוכל להתחיל לעבוד תוך דקות: קריאה אחת ב-cURL, אימות פשוט באמצעות טוקן אישי, ותגובה ברורה בחזרה. בתיעוד תמצאו דוגמאות קוד מוכנות, הסבר על כל פרמטר, ודוגמאות בקשה ותגובה גם ב-GET וגם ב-JSON.
שליחה, סטטוס מסירה, יתרה וסמס נכנס
ממשקים מלאים לכל מה שקשור בסמס: לשלוח, לדעת מה קרה להודעה, לבדוק יתרה ולקבל הודעות נכנסות אליכם.
שליחת סמס
שליחת הודעות מאתרים וממערכות המחשוב של העסק, עם פרמטרים לזיהוי השולח (Sender ID), תזמון, פרסונליזציה ושדות דינמיים.
פתיחת חשבון חינם ←סטטוס מסירה (DLR)
קבלת חיווי על הגעת ההודעה למכשיר או חסימה, בדיקת סטטוס של הודעות מתוזמנות וביצוע מחיקה שלהן לפני המשלוח.
בדיקת יתרה
שאילתה פשוטה שמחזירה את יתרת ההודעות שנותרה בחשבון, כדי לנטר מלאי ולהפעיל התראות אוטומטיות במערכת שלכם.
סמס נכנס
קבלת הודעות סמס נכנסות אל כתובת בשרת שלכם בזמן אמת, לטיפול אוטומטי, צ׳אט דו-כיווני או הצבעות.
הודעות קוליות, IVR דינמי ו-click-to-call
ממשקים שמחברים את מערכות הטלפוניה שלכם לזרימת המידע של העסק, ושולטים במהלך השיחה בזמן אמת.
הודעות קוליות
שליחת הודעה קולית מאתרים וממערכות המחשוב, עם פרמטרים לזיהוי השולח, תזמון, וקביעת השירות או ההודעה שתופעל.
מידע דינמי ב-IVR
קבלת מידע בזמן אמת משרתי ה-IVR: שירות מופעל, מקשים שהוקשו, מספר מתקשר וזמן שיחה. קביעת מהלך השיחה והשמעת נתונים מהשרת שלכם.
לשירותי הטלפוניה ←click-to-call
יצירת שיחה יזומה בלחיצה אחת מתוך האתר או ה-CRM, שמחברת בין הלקוח לנציג, עם חיווי על תוצאת השיחה.
אנשי קשר, נתוני טפסים ו-OTP
מעבר להודעות, הממשקים מאפשרים לנהל נתונים, לאסוף לידים ולאמת משתמשים.
ניהול אנשי קשר
הוספה, עדכון ומחיקה של אנשי קשר ורשימות תפוצה ישירות מהמערכת שלכם, לשמירה על סנכרון מלא מול ה-CRM.
נתוני טפסים
קבלת התוכן מטפסים ושאלונים שמולאו על ידי לקוחות בדפי הנחיתה, ישירות לכתובת בשרת שלכם, לטיפול מיידי בליד.
לדפי נחיתה וטפסים ←OTP וקוד אימות
שליחת סיסמה חד-פעמית בסמס או בהודעה קולית, בארבע שפות: עברית, ערבית, אנגלית ורוסית, ואימות הקוד מול הממשק.
ל-OTP וקוד אימות ←
Webhooks: המידע מגיע אליכם, ברגע שהוא קורה
במקום לבדוק שוב ושוב מה קרה, אנחנו דוחפים את האירוע אל כתובת בשרת שלכם ברגע שהוא מתרחש. כך המערכת שלכם תמיד מעודכנת בזמן אמת, בלי קוד מיותר.
- חיווי מסירה (DLR): נמסר, נכשל או נחסם, מיד עם תוצאת השליחה
- סמס נכנס: כל הודעה שמגיעה אליכם נדחפת לכתובת בשרת שלכם
- אירועי IVR: שירות מופעל, מקש שהוקש ומספר מתקשר, בזמן השיחה
- תגובה גם בפורמט GET קלאסי וגם בפורמט JSON, לפי בחירתכם
Zapier: חיבור לאלפי אפליקציות, בלי כתיבת קוד
לא לכל אינטגרציה צריך מפתח. דרך Zapier אפשר לחבר את מיקרופיי למערכות שאתם כבר עובדים איתן, ולהפעיל שליחת סמס אוטומטית כשמשהו קורה במערכת אחרת. חיבור וואטסאפ דרך Zapier מתוכנן בהמשך.
- ליד חדש שנכנס ל-CRM מפעיל מיד הודעת סמס
- הזמנה חדשה בחנות שולחת אישור ועדכון משלוח ללקוח
- חיבור למאות אפליקציות נפוצות, בלי שורת קוד אחת
- לוגיקה מתקדמת יותר תמיד זמינה דרך ממשקי ה-API
מהרשמה לקריאת ה-API הראשונה
- פותחים חשבון חינם
נרשמים למיקרופיי ללא כרטיס אשראי, ומקבלים גישה מלאה לכל השירותים והממשקים.
- מפיקים טוקן אימות
יוצרים טוקן אישי לחשבון. אפשר ליצור טוקן לבדיקות, ובסיום הפיתוח להחליף אותו בטוקן ייצור חדש.
- שולחים קריאת cURL
מעתיקים דוגמת קוד מוכנה מהתיעוד, מחליפים את הטוקן והפרמטרים, ומריצים קריאה ראשונה.
- מחברים Webhooks
מגדירים כתובת בשרת שלכם לקבלת חיווי מסירה, סמס נכנס ואירועי IVR בזמן אמת.
כל מה שמפתחים שואלים על הממשקים
אילו ממשקי API יש למיקרופיי?
יש ממשקים לשליחת סמס, בדיקת סטטוס מסירה, בדיקת יתרה וקבלת סמס נכנס, ממשקים טלפוניים להודעות קוליות ו-IVR דינמי ו-click-to-call, וכן ממשקים לניהול אנשי קשר, קבלת נתוני טפסים ושליחת קוד אימות OTP. כל הממשקים בפרוטוקול HTTP סטנדרטי בשיטת GET, POST או JSON.
באיזו שפת פיתוח אפשר להשתמש בממשקים?
בכל שפה. הממשקים עובדים בפרוטוקול HTTP רגיל, אז כל מערכת שיודעת לשלוח בקשת רשת יכולה להתחבר: PHP, Python, Node.js, C#, Java, וגם בלי קוד בכלל דרך cURL או דרך Zapier. בתיעוד יש דוגמאות קוד מוכנות.
איך מתבצע האימות מול הממשק?
האימות מתבצע באמצעות טוקן אישי שמשויך לחשבון שלכם. מצרפים את הטוקן לכל בקשה, והמערכת מזהה את החשבון ומאשרת את הפעולה. אפשר ליצור טוקן לבדיקות, ובסיום הפיתוח למחוק אותו וליצור טוקן חדש לסביבת הייצור.
מה ההבדל בין API לבין Webhooks?
ב-API אתם פונים אלינו ויוזמים פעולה, למשל שליחת סמס. ב-Webhooks אנחנו פונים אליכם ודוחפים מידע בזמן אמת לכתובת בשרת שלכם, למשל חיווי מסירה (DLR), סמס שנכנס או אירוע IVR חי. השילוב בין השניים נותן אינטגרציה דו-כיוונית מלאה.
אפשר להתחבר בלי לכתוב קוד?
כן. דרך Zapier אפשר לחבר את מיקרופיי לאלפי אפליקציות ולהפעיל שליחה וקבלה אוטומטית של סמס בלי כתיבת קוד. חיבור וואטסאפ דרך Zapier מתוכנן בהמשך. לפעולות מורכבות יותר משתמשים בממשקי ה-API עם דוגמאות הקוד שבתיעוד.
ממשיכים לקרוא
מוכנים להתממשק למיקרופיי?
פתחו חשבון חינם, הפיקו טוקן והתחילו להתנסות בקריאה הראשונה עוד היום. כל התיעוד ודוגמאות הקוד מחכים לכם במרכז המפתחים.