Webhooks ושילובי HTTP

חברו את שירותי Israelnumber למערכת ה-backend שלכם. העבירו SMS נכנס לנקודת קצה מסוג HTTP באמצעות ה-API המתועד להגדרות SMS או דרך פורטל החשבון, והשתמשו ב-API המתועד למספרים (DID) כדי להקצות מספרים ולהגדיר יעדי העברה נתמכים.

מה זמין כיום

Israelnumber תומכת בהעברת SMS-to-webhook נכנס כיכולת API מתועדת. הגדירו את היעד פרוגרמטית דרך POST /api/sms באמצעות השדה webhook_url, או הגדירו את אותו יעד בפורטל החשבון תחת סוג העברה ← API. כאשר מגיע SMS, הפלטפורמה מחליפה את מציני-המקום הנתמכים בשולח, תוכן ההודעה, ומספר היעד החיים, ופונה לכתובת ה-URL שלכם.

הפניית ה-API של Postman שסופקה מתעדת גם קריאות להקצאת מספרים (DID) ולניהול העברה. היא אינה מתעדת מערכת webhook כללית לאירועי שיחה עם אירועים כגון incoming_call, call_answered, או call_ended, ולכן עמוד זה אינו מציג אירועים אלו כתכונות API בייצור.

הפניה ל-Webhooks ולשילובים

הבחנה ברורה בין פונקציונליות API מתועדת, הגדרות דרך הפורטל, וקריאות חזרה (callback) כלליות שאינן נתמכות.

יכולתכיצד זה עובדסטטוס
SMS ← Webhookהגדירו את יעד ה-webhook דרך POST /api/sms באמצעות webhook_url, או הגדירו את אותו יעד תחת סוג העברה ← API בפורטל החשבון.זמין כעת
הגדרת webhook ל-SMS דרך APIהגדירו או שנו פרוגרמטית את כתובת ה-webhook ל-SMS דרך POST /api/sms באמצעות השדה המתועד webhook_url.API מתועד
הקצאת מספרים (DID) והעברההשתמשו בקריאות ה-API המתועדות כדי להציג רשימה, לשייך, לנהל, להגדיר העברה, ולשחרר מספרים וירטואליים.API מתועד
Webhooks כלליים לאירועי שיחהקריאות חזרה בעלות שם למחזור חיים, כגון incoming_call, call_answered, ו-call_ended, אינן מוגדרות בהפניית ה-Postman שסופקה.לא מתועד

SMS נכנס ← Webhook

הגדירו את היעד פרוגרמטית דרך POST /api/sms באמצעות webhook_url, או הגדירו את אותו יעד בחשבון ה-Israelnumber שלכם תחת סוג העברה ← API. כללו את מציני-המקום בדיוק כפי שמוצג, כולל הסוגריים המסולסלים.

דוגמת הגדרה דרך ה-API:

POST https://newsip.israelnumber.com/api/sms
x-auth-token: YOUR_SESSION_X_AUTH_TOKEN
Content-Type: application/json

{
  "action": "add",
  "id": "YOUR_ACCOUNT_ID",
  "token": "YOUR_ACCOUNT_TOKEN",
  "did": "YOUR_SMS_ENABLED_DID",
  "webhook_url": "https://example.com/israelnumber/sms?from={CallerID}&text={SMS_TEXT}&to={SMS_DST_ADDR}"
}
הגדרה ל-webhook בלבד: ניתן להשמיט את dest_sms ואת dest_email. השתמשו ב-x-auth-token של ה-session שנוצר בכותרת הבקשה לאחר ה-Login.

תבנית כתובת ה-webhook:

https://example.com/israelnumber/sms?from={CallerID}&text={SMS_TEXT}&to={SMS_DST_ADDR}
מציני-מקום נתמכים: {CallerID} = מספר הטלפון של השולח  ·  {SMS_TEXT} = תוכן הודעת ה-SMS  ·  {SMS_DST_ADDR} = מספר היעד ב-Israelnumber. בצעו קידוד URL נכון לערכים באפליקציה שלכם לפני עיבוד או אחסון נוסף.

דוגמת בקשה לאחר החלפת מציני-המקום:

https://example.com/israelnumber/sms?from=1234567890&text=Hello&to=0987654321

דוגמת נקודת קצה ב-Node.js / Express:

// npm install express
const express = require("express");
const app = express();

app.get("/israelnumber/sms", (req, res) => {
  const sender = req.query.from;
  const message = req.query.text;
  const destination = req.query.to;

  console.log("Inbound SMS", {
    from: sender,
    to: destination,
    text: message
  });

  // הלוגיקה שלכם כאן:
  // - יצירת כרטיס פנייה (ticket) במערכת ה-CRM
  // - הפעלת אוטומציה
  // - שליחת ההודעה לתהליך AI
  // - שמירתה באפליקציה שלכם

  res.status(200).send("OK");
});

app.listen(3000, () => console.log("Listening on port 3000"));

ניתוב קול שונה מ-Webhooks של SMS

ניתן להשתמש ב-API המתועד למספרים (DID) כדי להקצות מספרים ולשנות יעדי העברת שיחות נתמכים. דוגמת ה-API שסופקה מדגימה call_type=2 עם כתובת IP של טראנק ב-call_type_value.

אין להתייחס ל-API להעברה זה כהוכחה לקיומו של webhook כללי לאירועי שיחה מסוג HTTP או webhook למדיה קולית בשידור חי. יכולות אלו אינן מוגדרות בהפניית ה-Postman שסופקה. השתמשו רק בסוגי יעדי העברה הנתמכים על ידי חשבון ה-Israelnumber והגדרות הטלפוניה שלכם.

מדריכי API נוספים

שאלות נפוצות — Webhooks

האם ניתן להעביר SMS נכנס ל-webhook שלי?

כן. הגדירו את היעד פרוגרמטית דרך POST /api/sms באמצעות webhook_url, או פתחו את הגדרות העברת ה-SMS בפורטל החשבון, בחרו סוג העברה ← API, והזינו כתובת URL המכילה {CallerID}, {SMS_TEXT}, ו-{SMS_DST_ADDR}. Israelnumber מחליפה את מציני-המקום הללו בערכים חיים בעת העברת ההודעה.

האם ניתן להגדיר את כתובת ה-webhook ל-SMS דרך ה-API?

כן. ה-API של Postman שסופק מתעד הגדרת webhook ל-SMS דרך POST /api/sms באמצעות השדה webhook_url. ניתן להגדיר את אותו יעד גם בפורטל החשבון תחת סוג העברה ← API.

האם Israelnumber מספקת אירועי webhook מסוג incoming_call, call_answered, ו-call_ended?

שמות אירועים ומבני נתונים כלליים אלו אינם מתועדים בהפניית ה-API של Postman שסופקה, ולכן אין להסתמך עליהם כתכונות ייצור מתועדות.

האם ניתן לחבר מספר וירטואלי לסוכן קול מבוסס AI?

כן, כאשר פלטפורמת ה-AI מסוגלת לקבל שיחות דרך יעד העברה הנתמך על ידי חשבון ה-Israelnumber והגדרות הטלפוניה שלכם. דוגמת ה-API שסופקה מדגימה העברה לכתובת IP של טראנק. זהו נושא נפרד מתכונת ה-SMS-to-webhook המתוארת בעמוד זה.

בנו שילובי HTTP עם Israelnumber

השתמשו כבר היום ב-API המתועד ל-SMS-to-webhook יחד עם ה-API-ים להקצאת מספרים ולהעברה.