Webhooks ואירועים בזמן אמת

קבלו callbacks מיידיים של HTTP כאשר שיחות מגיעות או הודעות SMS נוחתות על המספרים הווירטואליים שלכם. בנו אוטומציות, הפעילו סוכני AI, והשתלבו עם כל backend בזמן אמת.

כך פועלים ה-Webhooks של Israelnumber

כאשר מתרחש אירוע במספר הווירטואלי שלכם — שיחה נכנסת מגיעה, שיחה נענית, או SMS מתקבל — Israelnumber שולחת בקשת HTTP POST לכתובת URL שציינתם. השרת שלכם מקבל את מטען האירוע, מעבד אותו, ומגיב עם HTTP 200. ללא polling, ללא עיכוב.

זהו המנגנון שמפעיל אינטגרציות של סוכני קול מבוססי AI: ה-webhook מספק את השיחה לנקודת הקצה של מערכת ה-AI שלכם ברגע שמתקשר מחייג למספר שלכם.

הפניית אירועים

Israelnumber מפעילה את אירועי ה-webhook הבאים. הגדירו את כתובת ה-URL היעד לכל מספר דרך לוח הבקרה או נקודת הקצה DID Forward Setting (/customer/did_management/).

אירועהפעלהשדות מפתח במטען
incoming_callשיחה נכנסת מגיעה למספר הווירטואלי שלכםdid_number, caller_id, timestamp
call_answeredהשיחה נענית ביעד ההעברהdid_number, caller_id, destination, timestamp
call_endedשיחה במספר זה מסתיימתdid_number, caller_id, duration_sec, timestamp
sms_receivedSMS נכנס מגיע למספר התומך ב-SMSfrom, to, message, timestamp

דוגמאות מטען ומטפל Webhook

דוגמאות מטען הנשלחות על ידי Israelnumber ומטפל Express.js המעבד גם אירועי שיחה וגם אירועי SMS.

מטען שיחה נכנסת (גוף HTTP POST):

{
  "event":      "incoming_call",
  "did_number": "+447911123456",
  "caller_id":  "+19175550100",
  "timestamp":  "2024-11-15T14:32:00Z"
}

מטען SMS נכנס (גוף HTTP POST):

{
  "event":     "sms_received",
  "from":      "+19175550100",
  "to":        "+447911123456",
  "message":   "Hello, is this line active?",
  "timestamp": "2024-11-15T14:33:12Z"
}

מטפל Webhook ב-Express.js — מטפל גם בשיחות וגם ב-SMS:

// npm install express
const express = require("express");
const app = express();
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

app.post("/israelnumber/webhook", (req, res) => {
  const payload = req.body;

  switch (payload.event) {

    case "incoming_call":
      console.log(`Inbound call on ${payload.did_number} from ${payload.caller_id}`);
      // → Route to AI agent, trigger IVR, log to CRM, etc.
      break;

    case "call_ended":
      console.log(`Call ended. Duration: ${payload.duration_sec}s`);
      // → Update billing records, trigger follow-up automation
      break;

    case "sms_received":
      console.log(`SMS from ${payload.from}: "${payload.message}"`);
      // → Forward to support desk, trigger auto-reply, log to CRM
      break;

    default:
      console.log("Unknown event:", payload.event);
  }

  // Always respond 200 to acknowledge receipt
  res.status(200).send("OK");
});

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

עוד מדריכי API

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

כיצד מגדירים כתובת URL של webhook עבור המספר שלי?

ניתן להגדיר כתובת URL של webhook דרך לוח הבקרה של Israelnumber בעת הגדרת הגדרות ההעברה של המספר שלכם, או באופן פרוגרמטי באמצעות נקודת הקצה DID Forward Setting (/customer/did_management/) על ידי ציון כתובת ה-URL שלכם כיעד call_type_value. אשרו את הערך המדויק של call_type עבור ניתוב webhook מול מדריך ה-API שלכם או צוות הפיתוח לפני הסתמכות עליו בקוד ייצור.

באיזו שיטת HTTP משתמשת Israelnumber עבור webhooks?

Israelnumber שולחת אירועי webhook כבקשות HTTP POST עם גוף בפורמט JSON או form-encoded המכיל את סוג האירוע והנתונים הרלוונטיים. נקודת הקצה שלכם צריכה להגיב עם HTTP 200 כדי לאשר קבלה.

האם אני יכול להשתמש ב-webhooks כדי לחבר סוכן קול מבוסס AI?

כן. זהו אחד ממקרי השימוש המרכזיים. כאשר שיחה נכנסת מגיעה, ה-webhook מופעל ונקודת הקצה של סוכן ה-AI שלכם מקבלת את פרטי השיחה באופן מיידי. בשילוב עם העברת SIP, זה מאפשר לסוכני AI לענות לשיחות ברגע שהן מגיעות.

התחילו לבנות עם Webhooks כבר היום

קבלו את מפתח ה-API החינמי שלכם והתחילו לקבל אירועי שיחה ו-SMS בזמן אמת.