API ל-SMS — הגדרת ניתוב SMS נכנס
נתבו SMS נכנס במספרים המקומיים התומכים ב-SMS שלכם למספר טלפון אחר, כתובת דוא"ל, או כתובת URL של webhook — ניתן להגדרה מלאה דרך API. אין צורך בפלטפורמת SMS נפרדת.
כך פועלת העברת SMS ב-Israelnumber
מספרים וירטואליים התומכים ב-SMS יכולים להעביר כל הודעה נכנסת לאחד משלושה סוגי יעדים.
|
| ||||
| |||||
תחביר העברת SMS ל-Webhook
הגדירו זאת בחשבון שלכם תחת Forward Type ← API, עם שדה API URL. ה-placeholders מוחלפים בערכים חיים בכל הודעה נכנסת — כללו אותם בדיוק כפי שמוצג, כולל הסוגריים המסולסלים.
https://example.com/api?from={CallerID}&text={SMS_TEXT}&to={SMS_DST_ADDR}
✓ {CallerID} — מספר הטלפון של השולח | ✓ {SMS_TEXT} — תוכן הטקסט של ה-SMS |
✓ {SMS_DST_ADDR} — מספר היעד של הנמען | |
דוגמה עם שולח 1234567890, הודעה Hello, נמען 0987654321:
https://example.com/api?from=1234567890&text=Hello&to=0987654321
דוגמאות קוד
כל נקודות הקצה משתמשות ב-HTTP POST. התאמתו תחילה כדי לקבל את ה-id וה-account_token של החשבון שלכם.
// Requires: npm install node-fetch form-data
const fetch = require("node-fetch");
const FormData = require("form-data");
const BASE = "https://newsip.israelnumber.com";
// ── Step 1: Login ───────────────────────────────────────────
async function login() {
const f = new FormData();
f.append("username", "YOUR_ACCOUNT_NUMBER");
f.append("password", "YOUR_PASSWORD");
const r = await fetch(`${BASE}/api/login/`, { method: "POST", body: f });
return r.json(); // → { id, account_token }
}
// ── Step 2: Create an SMS forwarding config ─────────────────
// Forward incoming SMS on a DID to an email address
async function addSmsForwardToEmail(id, token, did, destEmail) {
const f = new FormData();
f.append("action", "add");
f.append("did", did);
f.append("dest_email", destEmail);
f.append("id", id);
f.append("token", token);
const r = await fetch(`${BASE}/api/sms`, { method: "POST", body: f });
return r.json();
}
// ── Step 3: Run ─────────────────────────────────────────────
(async () => {
const { id, account_token } = await login();
const result = await addSmsForwardToEmail(
id,
account_token,
"+447911123456", // your SMS-enabled virtual number
"alerts@yourdomain.com"
);
console.log("SMS forwarding configured:", result);
})();# Step 1 — Login and capture id + token
LOGIN=$(curl -s -X POST https://newsip.israelnumber.com/api/login/ \
-d "username=YOUR_ACCOUNT_NUMBER" \
-d "password=YOUR_PASSWORD")
ID=$(echo "$LOGIN" | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")
TOKEN=$(echo "$LOGIN" | python3 -c "import sys,json; print(json.load(sys.stdin)['account_token'])")
# Step 2 — Add SMS forwarding to another SMS number
curl -s -X POST https://newsip.israelnumber.com/api/sms \
-d "action=add" \
-d "did=+447911123456" \
-d "dest_sms=+19175550100" \
-d "id=$ID" \
-d "token=$TOKEN"
# Step 3 — List all SMS forwarding configs on the account
curl -s -X POST https://newsip.israelnumber.com/api/sms \
-d "action=list" \
-d "id=$ID" \
-d "token=$TOKEN"עוד מדריכי API
|
| ||||
|
|
שאלות נפוצות — API ל-SMS
האם אני יכול לקבל SMS על מספר מקומי וירטואלי?
כן, על מספרים וירטואליים התומכים ב-SMS. בעת ההזמנה, חפשו מספרים עם סוג DID של SMS או Mobile voice+SMS. ניתן להעביר SMS נכנס למספר SMS אחר, כתובת דוא"ל, או כתובת URL של webhook.
כיצד פועלת העברת ה-SMS ל-webhook החדשה?
הגדירו את Forward Type ל-API בחשבון שלכם וספקו כתובת API URL באמצעות התבנית https://example.com/api?from={CallerID}&text={SMS_TEXT}&to={SMS_DST_ADDR}. כל placeholder מוחלף בערכים חיים כאשר מגיע SMS, ונקודת הקצה שלכם מקבלת בקשת HTTP בזמן אמת.
האם אני יכול להעביר SMS ליותר מיעד אחד?
כל ערך SMS Config קשור ל-DID ויעד ספציפיים. כדי להעביר למספר יעדים, השתמשו ב-SMS Config API כדי לנהל תצורות נפרדות, או נתבו לנקודת קצה webhook יחידה ופזרו משם.
אילו מדינות תומכות ב-SMS על מספרים וירטואליים?
תמיכת SMS משתנה לפי מדינה וסוג מספר. בדקו את סוגי ה-DID הזמינים במדינת היעד שלכם לפני ההקצאה כדי לוודא שמספרי SMS או Mobile voice+SMS מוצעים שם.
התחילו להגדיר ניתוב SMS כבר היום
קבלו את מפתח ה-API החינמי שלכם והגדירו את כלל העברת ה-SMS הראשון שלכם תוך דקות.