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}

דוגמה עם שולח 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 הראשון שלכם תוך דקות.