תפוצה: רשימות וקמפיינים

רשימות תפוצה

רשימה מכילה טלפון ועד שישה שדות דינמיים df1–df6 (למשל שם פרטי, עיר, תאריך תור).

curl -X POST https://smsprovider-web.vercel.app/api/v1/lists \
  -H "Authorization: Bearer $BATLER_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "לקוחות VIP", "contacts": [{"phone": "0501234567", "df1": "דנה"}, {"phone": "0527654321", "df1": "יוסי"}]}'

• מספרים לא תקינים מוחזרים ב-rejected עם סיבה; כפולים מאוחדים.
• הוספה/הסרה: POST / DELETE https://smsprovider-web.vercel.app/api/v1/lists/{id}/contacts (עד 10,000 בקריאה).
• בפורטל אפשר לייבא CSV או Excel עם מיפוי עמודות.

שליחת קמפיין

POST https://smsprovider-web.vercel.app/api/v1/campaigns
{
  "list_id": "5b0d2a8e-1d7c-4a35-9a7e-3c1a3b5e9f00",
  "from": "MyBrand",
  "body": "היי {{df1}}, מבצע סוף עונה: 20% הנחה! [shop]",
  "links": { "shop": "https://example.com/sale" },
  "unsubscribe": "link",
  "schedule_at": "2026-11-05T09:00:00+02:00"
}

• {{df1}}…{{df6}} מוחלפים בערך של כל איש קשר.
• אנשי קשר שביקשו הסרה ומספרים ברשימה השחורה מסוננים אוטומטית; skip_recent_days (1–14) מדלג על מי שקיבל הודעה לאחרונה.
• העלות נשמרת מראש (סגמנטים × נמענים) ומוצגת בתשובה ב-credits_reserved.
• ביטול לפני מועד השליחה: POST https://smsprovider-web.vercel.app/api/v1/campaigns/{id}/cancel — הקרדיטים משתחררים.

קישורים ומעקב קליקים

כל קישור בהודעה עובר דרך המקצר שלנו: כתבו [link-id] בטקסט והעבירו links: { "link-id": "https://…" }. כל נמען מקבל קישור קצר ייחודי, כך שאפשר לראות מי לחץ ומתי (GET https://smsprovider-web.vercel.app/api/v1/campaigns/{id}/clicks, webhook link.clicked). תצוגות מקדימות של WhatsApp/iMessage ובוטים לא נספרים כקליק. הקישור המקוצר (כ-30 תווים) נספר באורך ההודעה.

הסרה מרשימת דיוור (חובה בהודעות שיווקיות)

אפשר למקם את קישור ההסרה בתוך הטקסט עם [unsubscribe]. אירוע blacklist.added נשלח על כל הסרה.