שימושי לדוגמה, מערכת שעת לימוד אישית, בתפריט הראשי משאירים הודעה "אני כעת באמצע הלימוד וכו', להשארת הודעה הקישו אחד", לאחר שמקיש אחד הוא מתבקש להשאיר הודעה, ולאחר מכן ההודעה נשלחת לנייד באמצעות הודעת SMS.
לצורך כך, ראשית כל יש לפנות לשירות הלקוחות של ימות המשיח, ולבקש להרשם לשירות ההודעות SMS, יש להזמין חבילה לפי הכמות שתרצו, לאחר מכן תקבלו שם משתמש וסיסמא לשירות, פרטים אלו יידרשו בהמשך, לצורך הגדרתם במערכת.
לצורך הפעלת השירות, יש צורך בשרת שמריץ קבצי PHP, ולהשים על השרת את הקובץ המצורף.
ראשית כל אני מעתיק פה את הקוד, עם הסבר היכן צריך להכניס את שם המשתמש והסיסמא.
וכן קובץ שמכניסים במערכת בשלוחה הרלוונטית, שזה מגדיר את השלוחה כ API, וכמובן צריך להכניס את הכתובת הנכונה של השרת שלכם והמיקום בו העליתם את הקובץ.
קוד הקובץ PHP הוא:
קוד: בחירת הכל
<?php
extract($_GET, EXTR_PREFIX_SAME, "wddx");
if (isset($_GET['ApiPhone']) == False )
{
print "שגיאה קריטית, לא מוגדר מספר טלפון של התחברות";
return;
}
$ApiPhone = $_GET['ApiPhone'];
// פונקציה להסרת מספר 01 בהתחלה, במקרה שהשיחה מנותבת עם תוספת של 01
if (strpos($ApiPhone,"1") == 1)
{
$ApiPhone = substr($ApiPhone,2);
$ApiPhone = "0".$ApiPhone;
}
// קבלת הטקסט של ההודעה
if (isset($_GET['הודעה'])==False ) {
echo 'read=t-';
echo "לאחר הצליל אנא הקליטו בקול ברור את הודעתכם ולסיום הַקישו סולמית";
echo '=הודעה,no,voice';
return;
}
// Sending simple message using PHP
// http://jasminsms.com
$baseurl = 'http://api.multisend.co.il/MultiSendAPI/sendsms?';
user=jasmin_username&password=jasmin_password&from=from_name&recipient=recipient_number&message=your+messageuser=jasmin_username&password=jasmin_password&from=from_name&recipient=recipient_number&message=your+messageuser=jasmin_username&password=jasmin_password&from=from_name&recipient=recipient_number&message=your+messageuser=jasmin_username&password=jasmin_password&from=from_name&recipient=recipient_number&message=your+messageuser=jasmin_username&password=jasmin_password&from=from_name&recipient=recipient_number&message=your+message';
//יש למחוק את שם_משתמש ולהכניס במקומו את שם המשתמש אותו קיבלתם משירות הלקוחות
$params = 'user=שם_משתמש';
//יש למחוק את סיסמא ולהכניס במקומו את הסיסמא אותו קיבלתם משירות הלקוחות
$params.= '&password=סיסמא';
$params.= '&from='.$ApiPhone;
// במקום מספר_טלפון יש להכניס את מספר הטלפון בו תרצו לקבל את ההודעות
$params.= '&recipient=מספר_טלפון';
$params.= '&message='.urlencode($הודעה);
// פרמטרים אופציונליים
//Optional Parameter
//$params.= '&message_type='.urlencode('message_type');
//$params.= '&scheduledatetime=schedule_time';
//$params.= '&international=international';
//$params.= '&deliverynotificationURL=urlencode(deliverynotificationURL)';
//$params.= '&customermessageid=customermessageid';
//$params.= '&deliverynotificationmethod=POST';
$response = file_get_contents($baseurl.$params);
//print $response;
$jsonObject = json_decode($response);
echo "id_list_message=t-אנא המתן.&";
if ($jsonObject->success != "true" )
{
echo "id_list_message=t-לצערנו קרתה תקלה בשליחת ההודעה, אנא פנה למנהל המערכת.&go_to_folder=/hangup";
return ;
}
if ($jsonObject->success == "true" )
{
echo "id_list_message=t-ההודעה נשלחה בהצלחה, שלום ותודה.&go_to_folder=/hangup";
return ;
}
בנוסף, לאחר שמעלים קובץ זה לשרת, יש להגדיר בשלוחה של ההודעות במערכת בקובץ ה ext.ini
קוד: בחירת הכל
type=api
;יש לשנות את הכתובת למיקום בשרת שלכם
api_link=https://domain.com/sms.php
api_phone_send=yes
api_did_send=no
api_extension_send=no
say_api_answer=no
api_say_tts=no
אני מצרף את הקבצים מוכנים להעלאה על השרת שלכם. נ.ב. לא באתי להסביר ולהדריך איך בונים מערכות API, רק בצורה קלה להשתמש עם משהו מוכן.
כמו"כ ייתכן שבהמשך אני יפתח משהו בשרת שלי עבור אלו שאין להם שרת, ורוצים להשתמש בשרות, שכל אחד יוכל לעשות שלוחה במערכת שלו ולהעלות לשם את ההגדרות הרלוונטיות וע"י זה יוכל ג"כ להשתמש בשירות. א"כ אעדכן פה בפורום.
בהצלחה