wa-bridge הוא גשר שמעביר הודעות WhatsApp מתור הודעות (Supabase) אל WhatsApp דרך ספק השליחה kailai.tech. אתה לא שולח דרך הממשק הזה — הממשק הוא לניהול ומעקב. ההודעות עצמן נשלחות אוטומטית.

זרימת הודעה (מקצה לקצה)

הודעה נכנסת לתור  →  הגשר מושך כל דקה  →  שולח דרך kailai  →  WhatsApp
   (whatsapp_outbox)      (round-robin בין טוקנים)     (5/דק' + השהיה)

1. הכנסה לתור: הודעה מתווספת לטבלה whatsapp_outbox ב-Supabase (סטטוס pending).
2. שליפה: כל 60 שניות הגשר קורא GET /pending-messages — זה תופס את ההודעות אטומית (מסמן claimed) כדי שלא יישלחו פעמיים.
3. שליחה: כל הודעה נשלחת דרך kailai. הטוקנים בשימוש לסירוגין (round-robin): הודעה 1→טוקן 1, הודעה 2→טוקן 2, וכן הלאה.
4. Failover: אם הטוקן התורן נכשל או מיצה 5 הודעות בדקה — עוברים לטוקן הבא. אם כולם נכשלו, ההודעה מסומנת failed.
5. דיווח: הגשר מעדכן בחזרה POST /message-status/{id} עם sent/failed, וגם זוכר מקומית (הגנה כפולה מפני שליחה כפולה).

כניסה

הממשק ב-https://wa.yotaro.online, מוגן בסיסמה. (גישה חלופית מאובטחת: SSH tunnel ל-127.0.0.1:8088.)

ניהול טוקנים

• כל טוקן הוא טריגר הודעה פעיל ב-kailai. הטוקנים מוצגים ממוסכים (6 ספרות אחרונות).
• הוספה: הדבק טוקן בשדה "הדבק טוקן חדש" → "הוסף". נכנס לתוקף מיד.
• הסרה: כפתור "הסר" ליד הטוקן.
• הסדר קובע את ה-round-robin. שינויים שורדים restart (נשמרים בשרת).

קבוצות לפי טוקן

• הכרטיס "קבוצות לפי טוקן" מציג לכל טוקן את כל הקבוצות שהוא יכול לשלוח אליהן — שם + מזהה (@g.us), עם כפתור "העתק ID".
• קבוצה שמסומנת "משותפת" (כתום) זמינה ביותר מטוקן אחד — שליחה אליה תעבוד מכל אחד מהם (חשוב ל-round-robin).
• קבוצה שיש רק לטוקן אחד — אם ב-round-robin היא תיפול לטוקן אחר, השליחה תיכשל אצלו ותעבור ב-failover לטוקן שכן חבר.
• כפתור "רענון" מושך מ-kailai מחדש (אחרת cache של דקה).

לוגים חיים

• מתעדכנים כל 2 שניות. רואים כל מחזור poll, כל שליחה (sent/FAILED) עם היעד והטוקן ששימש, ושגיאות.
• הלוג מוגבל ל-500 שורות אחרונות ונמחק ב-restart של הגשר (מעקב חי, לא היסטוריה). הרשומה הקבועה לכל הודעה נשמרת בשרת ובתור עצמו.
• תוכן ההודעה עצמו לא מוצג בלוג (פרטיות) — רק יעד וסטטוס.

הגשר רק קורא מהתור. כדי שהודעה תישלח, צריך להוסיף שורה לטבלה whatsapp_outbox ב-Supabase (פרויקט klrsogrwpbkrshpubhao). הטבלה מוגנת ב-RLS וצמודה ל-service_role — ההכנסה נעשית מצד ה-backend שלך (Supabase client / SQL / מערכת אוטומציה), לא דרך הגשר.

מבנה הודעה בתור

{
  "to_type":   "phone" | "group",   // phone = איש פרטי, group = קבוצה
  "to":        "0501234567"  |  "120363049493915403@g.us"  |  "צוות מכירות",
  "message":   "טקסט ההודעה",        // או null אם משתמשים בתבנית
  "variables": null | { "name":"דוד", "order_id":"12345" }  // לתבנית
}

• איש פרטי: to_type:"phone", to = מספר טלפון.
• קבוצה: to_type:"group", to = מזהה קבוצה (@g.us, מומלץ — לא תלוי בשינוי שם) או שם מדויק. את ה-ID אפשר להעתיק מ"קבוצות לפי טוקן" למעלה.
• תבנית: אם לטריגר ב-kailai יש תבנית מוגדרת — מלא variables במקום message.
• הסטטוס מתחיל pending; הגשר מעביר ל-claimed → sent/failed.

דוגמה: INSERT דרך Supabase REST (service_role)

curl -X POST 'https://klrsogrwpbkrshpubhao.supabase.co/rest/v1/whatsapp_outbox' \
  -H "apikey: <SERVICE_ROLE_KEY>" \
  -H "Authorization: Bearer <SERVICE_ROLE_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "to_type":"group", "to":"120363049493915403@g.us",
        "message":"הזמנה #12345 יצאה למשלוח" }'

הקצוות שהגשר משתמש בהם (לידיעה)

• GET /functions/v1/pending-messages?limit=100 · header x-api-key · תופס ומחזיר את התור.
• POST /functions/v1/message-status/{id} · header x-api-key · מדווח sent/failed.

שליחה מהירה של אותה הודעה להרבה נמענים — במיוחד מספרים פרטיים שלא כתבו לבוט קודם — היא הדרך המהירה ביותר לחסימה (notAuthorized).

הגנות שתמיד פעילות (הגשר + kailai):

• מקסימום 5 הודעות בדקה לכל טוקן. עודף נדחה לחלון הבא.
• השהיה אקראית של 3–6 שניות בין כל שתי הודעות.

הגנות מומלצות (בהגדרות הבוט ב-kailai → טריגרים):

• מניעת כפילות (60ש): חוסם שליחה חוזרת של אותו טריגר לאותו נמען בדקה.
• תקרה שעתית (3 לשעה לנמען): מגן מפני הצפת לקוח בודד.
• בחסימה kailai מחזיר success:false עם error_code (dedup_window/hourly_cap) ו-retry_after_seconds.