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}"
}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-ים להקצאת מספרים ולהעברה.