API ו-SDK

כל דוגמאות ה-API במקום אחד

כאן מרוכזות כל הדוגמאות המרכזיות ל-Phone Agent: שליחה מקומית דרך הטלפון, שליחה גלובלית לארה״ב וקנדה, ודוגמאות קוד ל-curl, Python, Node.js ואוטומציה.

curl Python Node.js Agent / Automation Local + Global

התחילו מהגדרת המפתח קפיצה ל-SMS גלובלי

1. הגדרת גישה

לשליחה דרך קוד משתמשים במפתח אישי מהאזור האישי. באתר הרגיל אין צורך במפתח ידני, אבל באוטומציה / Agent / שרת חיצוני כן.

שליחה מקומית דרך הטלפון משתמשת ב-API הקיים שלכם, ושולחת דרך הטלפון המחובר.

שליחה גלובלית מיועדת כרגע לארה״ב וקנדה בלבד עם +1, מחויבת מהארנק, ולא דורשת התקנה על טלפון.

2. SMS מקומי דרך הטלפון

מתאים לשליחה לישראל דרך המספר והחבילה של הטלפון המחובר.

curl

# 1. הגדירו את משתני הסביבה
export PHONE_AGENT_API="https://api.phoneagent.co.il"
export PHONE_AGENT_TOKEN="YOUR_API_KEY"

# 2. שלחו הודעה מקומית דרך הטלפון המחובר
curl -X POST "$PHONE_AGENT_API/v1/sms" \
  -H "Authorization: Bearer $PHONE_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"+972500000000","text":"שלום, ההזמנה שלך אושרה."}'

# 3. תשובה צפויה
# {"id":"msg_8f3c12","status":"queued","to":"+972500000000"}

Pythonrequests

import os, requests

API   = os.environ["PHONE_AGENT_API"]
TOKEN = os.environ["PHONE_AGENT_TOKEN"]

r = requests.post(
    f"{API}/v1/sms",
    headers={"Authorization": f"Bearer {TOKEN}"},
    json={"to": "+972500000000",
          "text": "שלום"},
    timeout=10,
)
r.raise_for_status()
print(r.json())

Node / JSfetch

const API   = process.env.PHONE_AGENT_API;
const TOKEN = process.env.PHONE_AGENT_TOKEN;

const res = await fetch(`${API}/v1/sms`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+972500000000",
    text: "שלום",
  }),
});

console.log(await res.json());

3. SMS גלובלי דרך הארנק

מתאים כרגע לארה״ב ולקנדה בלבד עם +1. השליחה יוצאת דרך ה-API שלנו, לא דרך הטלפון המחובר.

כדי לשלוח במסלול הזה צריך יתרה בארנק. אם השליחה נכשלת, היתרה מזוכה חזרה אוטומטית.

curl גלובלי

# שליחה גלובלית לארה״ב / קנדה בלבד
export PHONE_AGENT_API="https://phoneagent.co.il/api/sender"
export PHONE_AGENT_TOKEN="YOUR_API_KEY"

curl -X POST "$PHONE_AGENT_API/api/v1/messages" \
  -H "Authorization: Bearer $PHONE_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel":"sms_global","to":"+14155550123","text":"Hello David, your appointment is confirmed for 3:30 PM."}'

# הערות:
# - נתמך כרגע רק למספרים בארה״ב/קנדה עם +1
# - החיוב יורד מהארנק הנטען מראש
# - אין צורך בהתקנה או חיבור טלפון למסלול הזה

Pythonglobal

import requests

url = "https://phoneagent.co.il/api/sender/api/v1/messages"
token = "YOUR_API_KEY"

r = requests.post(
    url,
    headers={
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json",
    },
    json={
        "channel": "sms_global",
        "to": "+14155550123",
        "text": "Hello from Python automation",
    },
    timeout=10,
)

r.raise_for_status()
print(r.json())

Node / JSglobal

const res = await fetch("https://phoneagent.co.il/api/sender/api/v1/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel: "sms_global",
    to: "+14155550123",
    text: "Hello from Node automation",
  }),
});

console.log(await res.json());

4. אוטומציה, Agent ושרתים

אותו API יכול לעבוד מתוך backend, webhook, cron, כלי פנימי או Agent שמחליט מתי ומה לשלוח.

Automation / Agent

# דוגמה לשרת / Agent שבוחר לשלוח גלובלית או מקומית
payload = {
  "channel": "sms_global",   # או sms למסלול המקומי
  "to": "+14155550123",
  "text": "Your package is on the way"
}

headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json",
}

# Agent יכול:
# - לבחור ערוץ
# - למשוך היסטוריה / אנשי קשר דרך היכולות הנוספות
# - לשלוח רק אחרי בדיקות ו-business rules