שליחת SMS דרך ה-API

במדריך הבא נעבור שלב אחרי שלב כיצד מבצעים שליחת SMS באמצעות API ב smoove.

שלב 1: הגדרת מספר שולח

• היכנסו להגדרות המערכת.
•  טלפון השולח - הזינו את מספר הטלפון לשליחה.
• שמרו את ההגדרה.
• אשרו את המספר דרך הקישור שיישלח ב-SMS.
• שמרו שוב לאחר האישור.

שלב 2: יצירת מפתח API

• ריחוף מעל אייקון התפריט (צד שמאל למעלה) ← מפתחות API ופיקסלים.
• צרו מפתח חדש עם הרשאות מלאות.
• הגדירו הקשר (לדוגמה: שליחת SMS מהאתר).
• שמרו את המפתח.
• עברו ל-Swagger דרך כפתור 'קישור לשידור'.

* הגדרת ה"הקשר" מסייעת בזיהוי ומעקב אחר מקור הפעולות.
כאשר נוצר איש קשר באמצעות מפתח API, מקור ההרשמה שלו ייקבע בהתאם לערך שהוגדר בשדה "הקשר" של אותו מפתח.

שלב 3: שליחת SMS

• השתמשו בפונקציה Create and Send an SMS Campaign.
• שיטת השליחה: POST.
• מבנה הבקשה: JSON.

פרמטרים עיקריים

• From Number – מספר שולח.
  *שימו לב, המספר חייב להיות זהה למספר שהגדרנו בטלפון השולח.
• Body – תוכן ההודעה.
• ToMembersByCell – רשימת מספרי הטלפון לשליחה.

הגדרות נוספות

• TTS – הודעה קולית (בתשלום).
• SendNow: קיימות שתי אפשרויות
  1. true: שליחה מיידית
  2. false: יצירה ללא שליחה

* ניתן לתזמן שליחה עתידית ע"י בחירה באופציה true והגדרת תאריך השליחה.

תגובות מהשרת

• 200 – הצלחה
• 404 – כישלון
• מתקבל גם מזהה הודעה (ID) למעקב.

שימוש ב-API Key

• יש להוסיף את המפתח:
  - ב Query String
  - או ב Header

בדיקה במערכת

• הודעות מתוזמנות יוצגו כמתוזמנות.
• הודעות מיידיות יוצגו כנשלחו.

הערות:

• חובה להשתמש ב-POST.
• יש לוודא שמספר השולח מאושר.