בונה צ'אטבוט בעברית

מדריך מקיף לבניית צ'אטבוטים מבוססי AI עם תמיכה מלאה בעברית. הסקיל הזה מכסה אינטגרציות עם פלטפורמות (וואטסאפ, טלגרם, אתרים), דפוסי שפה עבריים, רכיבי ממשק RTL, ועיצוב זרימות שיחה למשתמשים דוברי עברית.

רשמי מול לא רשמי

בעברית יש הבדל ברור בין רגיסטר רשמי ללא רשמי. בחרו לפי קהל היעד:

לא רשמי (מומלץ לרוב הבוטים לצרכנים):

• גוף שני יחיד: את/ה
• משפטים קצרים
• ביטויים מדוברים: "מה קורה?", "אין בעיה", "סבבה"

רשמי (מומלץ לממשלה, בנקאות, משפטי):

• גוף שני רבים או סביל
• משפטים מלאים בדקדוק תקין
• ביטויים רשמיים: "כיצד נוכל לסייע?", "בבקשה המתן/י"

תגובות מודעות מגדר

בעברית, פעלים ותארים מוטי מגדר. טפלו בזה בחוכמה:

אסטרטגיה 1: שאלו בתחילת השיחה ותזכרו

בוט: "היי! לפני שנתחיל, איך לפנות אליך?"
אפשרויות: [זכר] [נקבה] [לא משנה לי]

אסטרטגיה 2: ניסוח ניטרלי מבחינת מגדר

-- במקום: "אתה/את מוזמן/מוזמנת להמשיך"
-- כתבו: "ניתן להמשיך" או "אפשר להמשיך"

-- במקום: "רוצה לראות?"
-- כתבו: "לראות עוד אפשרויות?"

אסטרטגיה 3: סימון לוכסן (נפוץ בהייטק הישראלי)

"את/ה מוזמן/ת לבדוק את האפשרויות"

עיצוב תאריכים ושעות בצ'אט

# פורמט תאריכים להודעות צ'אט
# תקן ישראלי: DD/MM/YYYY או DD.MM.YYYY
# בשיחה: "יום שלישי, 14 במרץ"

# פורמט שעות: שעון 24 שעות הוא הסטנדרט בישראל
# "בשעה 14:30", לא "2:30 PM"

# זמן יחסי בעברית
RELATIVE_TIME_HE = {
    "just_now": "עכשיו",
    "minutes_ago": "לפני {n} דקות",
    "hours_ago": "לפני {n} שעות",
    "yesterday": "אתמול",
    "days_ago": "לפני {n} ימים",
    "today": "היום",
    "tomorrow": "מחר",
}

הגדרה דרך Cloud API

ה-Cloud API של וואטסאפ (ה-API הרשמי של מטא) הוא הגישה המומלצת לעסקים ישראליים:

1. צרו חשבון עסקי של מטא ב-business.facebook.com
2. הגדירו חשבון WhatsApp Business ב-Meta Business Suite
3. צרו אפליקציה ב-Meta Developers והוסיפו את מוצר WhatsApp
4. קבלו מספר טלפון: מספרים ישראליים (+972) נתמכים
5. ייצרו access token לקריאות API

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

וואטסאפ דורש תבניות שאושרו מראש להודעות יוצאות. הגישו תבניות בעברית דרך Meta Business Suite:

# דוגמה לתבנית: אישור הזמנה
# שם תבנית: order_confirmation_he
# שפה: he
# גוף: "שלום {{1}}, ההזמנה שלך מספר {{2}} התקבלה בהצלחה. סכום: ₪{{3}}. צפי למשלוח: {{4}}."

import requests

def send_template_message(phone_number: str, template_data: dict):
    """שליחת הודעת תבנית בוואטסאפ בעברית."""
    url = f"https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages"

    payload = {
        "messaging_product": "whatsapp",
        "to": phone_number,  # פורמט E.164: 972501234567
        "type": "template",
        "template": {
            "name": "order_confirmation_he",
            "language": {"code": "he"},
            "components": [
                {
                    "type": "body",
                    "parameters": [
                        {"type": "text", "text": template_data["customer_name"]},
                        {"type": "text", "text": template_data["order_id"]},
                        {"type": "text", "text": template_data["amount"]},
                        {"type": "text", "text": template_data["delivery_date"]},
                    ]
                }
            ]
        }
    }

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

    response = requests.post(url, json=payload, headers=headers)
    return response.json()

הודעות אינטראקטיביות

וואטסאפ תומך בכפתורים ורשימות אינטראקטיביות שעובדים מצוין עם עברית:

def send_interactive_buttons(phone_number: str):
    """שליחת כפתורים אינטראקטיביים בעברית."""
    payload = {
        "messaging_product": "whatsapp",
        "to": phone_number,
        "type": "interactive",
        "interactive": {
            "type": "button",
            "body": {
                "text": "איך אפשר לעזור לך היום?"
            },
            "action": {
                "buttons": [
                    {
                        "type": "reply",
                        "reply": {"id": "check_order", "title": "בדיקת הזמנה"}
                    },
                    {
                        "type": "reply",
                        "reply": {"id": "support", "title": "תמיכה טכנית"}
                    },
                    {
                        "type": "reply",
                        "reply": {"id": "hours", "title": "שעות פעילות"}
                    }
                ]
            }
        }
    }

    return send_whatsapp_message(payload)

טיפול ב-Webhook

from flask import Flask, request, jsonify
import hmac
import hashlib

app = Flask(__name__)

@app.route("/webhook", methods=["GET"])
def verify_webhook():
    """אימות webhook של וואטסאפ."""
    mode = request.args.get("hub.mode")
    token = request.args.get("hub.verify_token")
    challenge = request.args.get("hub.challenge")

    if mode == "subscribe" and token == VERIFY_TOKEN:
        return challenge, 200
    return "Forbidden", 403

@app.route("/webhook", methods=["POST"])
def handle_webhook():
    """עיבוד הודעות נכנסות מוואטסאפ."""
    # אימות חתימה
    signature = request.headers.get("X-Hub-Signature-256", "")
    body = request.get_data()
    expected = "sha256=" + hmac.new(
        APP_SECRET.encode(), body, hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(signature, expected):
        return "Invalid signature", 403

    data = request.get_json()
    for entry in data.get("entry", []):
        for change in entry.get("changes", []):
            if change["field"] == "messages":
                for message in change["value"].get("messages", []):
                    handle_incoming_message(message)

    return jsonify({"status": "ok"}), 200

הגדרת BotFather

1. פתחו את @BotFather בטלגרם
2. שלחו /newbot ועקבו אחרי ההוראות
3. הגדירו תיאור בעברית: /setdescription ושלחו טקסט בעברית
4. הגדירו תפריט פקודות בעברית:

/setcommands

start - התחל שיחה
help - עזרה
menu - תפריט ראשי
order - הזמנה חדשה
status - סטטוס הזמנה
language - שפה / Language

מקלדות Inline בעברית

from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update
from telegram.ext import Application, CommandHandler, CallbackQueryHandler

async def start(update: Update, context):
    """שליחת הודעת פתיחה בעברית עם מקלדת inline."""
    keyboard = [
        [
            InlineKeyboardButton("הזמנה חדשה", callback_data="new_order"),
            InlineKeyboardButton("בדיקת סטטוס", callback_data="check_status"),
        ],
        [
            InlineKeyboardButton("שאלות נפוצות", callback_data="faq"),
            InlineKeyboardButton("דבר/י עם נציג", callback_data="human_agent"),
        ],
        [
            InlineKeyboardButton("English", callback_data="lang_en"),
        ],
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)

    await update.message.reply_text(
        "שלום!\n\nאני הבוט של [שם העסק]. איך אפשר לעזור?",
        reply_markup=reply_markup,
    )

פריסת בועות צ'אט RTL

/* מכולת צ'אט RTL */
.chat-container {
  direction: rtl;
  display: flex;
  flex-direction: column;
  height: 100vh;
  font-family: 'Heebo', 'Assistant', sans-serif;
}

/* הודעת משתמש (צד ימין ב-RTL) */
.message-user {
  align-self: flex-start; /* ב-RTL, flex-start הוא ימין */
  background-color: #dcf8c6;
  border-bottom-right-radius: 4px;
  color: #111;
}

/* הודעת בוט (צד שמאל ב-RTL) */
.message-bot {
  align-self: flex-end; /* ב-RTL, flex-end הוא שמאל */
  background-color: #fff;
  border-bottom-left-radius: 4px;
  color: #111;
  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
}

/* שדה קלט */
.chat-input {
  flex: 1;
  padding: 10px 14px;
  border: 1px solid #ddd;
  border-radius: 24px;
  font-size: 14px;
  direction: rtl;
  text-align: right;
}

/* כפתור שליחה */
.chat-send-btn {
  background: #25d366;
  color: #fff;
  border: none;
  border-radius: 50%;
  width: 40px;
  height: 40px;
  cursor: pointer;
  transform: scaleX(-1); /* היפוך אייקון שליחה ל-RTL */
}

אינדיקטור הקלדה בעברית

function TypingIndicator({ isTyping }: { isTyping: boolean }) {
  if (!isTyping) return null;

  return (
    <div className="message-bubble message-bot typing-indicator">
      <span className="typing-text">מקליד/ה...</span>
      <span className="typing-dots">
        <span className="dot" />
        <span className="dot" />
        <span className="dot" />
      </span>
    </div>
  );
}

לוגיקת יישור הודעות

// זיהוי כיוון טקסט להודעות מעורבות עברית/אנגלית
function detectDirection(text: string): 'rtl' | 'ltr' {
  const rtlRegex = /[\u0590-\u05FF\u0600-\u06FF]/;
  const ltrRegex = /[a-zA-Z]/;

  for (const char of text) {
    if (rtlRegex.test(char)) return 'rtl';
    if (ltrRegex.test(char)) return 'ltr';
  }

  return 'rtl'; // ברירת מחדל RTL לאפליקציות עבריות
}

זיהוי כוונה (Intent Detection)

המורפולוגיה המורכבת של עברית מאתגרת את זיהוי הכוונות. אסטרטגיות מרכזיות:

# כוונות נפוצות בעברית עם ביטויים לדוגמה
HEBREW_INTENTS = {
    "greeting": [
        "שלום", "היי", "הי", "בוקר טוב", "ערב טוב",
        "מה קורה", "מה נשמע", "אהלן",
    ],
    "farewell": [
        "ביי", "להתראות", "שלום", "יום טוב", "לילה טוב",
    ],
    "help": [
        "עזרה", "אני צריך עזרה", "אני צריכה עזרה",
        "תעזור לי", "תעזרי לי", "איך עושים",
    ],
    "order_status": [
        "איפה ההזמנה", "סטטוס הזמנה", "מתי מגיע",
        "עדכון משלוח", "מספר מעקב",
    ],
    "complaint": [
        "לא מרוצה", "בעיה", "תלונה", "לא עובד",
        "שירות גרוע", "רוצה להתלונן",
    ],
    "human_agent": [
        "נציג", "אדם אמיתי", "תעביר לנציג",
        "לדבר עם מישהו", "אני רוצה לדבר עם בנאדם",
    ],
}

חילוץ ישויות (Entity Extraction)

חילוץ ישויות ספציפיות לישראל מטקסט עברי:

import re

def extract_israeli_entities(text: str) -> dict:
    """חילוץ ישויות ישראליות מטקסט עברי."""
    entities = {}

    # מספרי טלפון ישראליים
    phone_patterns = [
        r'05\d[\s-]?\d{3}[\s-]?\d{4}',   # נייד: 050-1234567
        r'0[2-9][\s-]?\d{3}[\s-]?\d{4}',  # קווי: 02-1234567
        r'\+972[\s-]?\d{1,2}[\s-]?\d{3}[\s-]?\d{4}',  # בינלאומי
    ]
    for pattern in phone_patterns:
        matches = re.findall(pattern, text)
        if matches:
            entities.setdefault("phone_numbers", []).extend(matches)

    # סכומים בשקלים
    nis_patterns = [
        r'₪\s?[\d,]+(?:\.\d{2})?',
        r'[\d,]+(?:\.\d{2})?\s?(?:₪|שקל|שקלים|ש"ח|שח)',
    ]
    for pattern in nis_patterns:
        matches = re.findall(pattern, text)
        if matches:
            entities.setdefault("amounts_nis", []).extend(matches)

    # תאריכים ישראליים (DD/MM/YYYY)
    date_patterns = [
        r'\d{1,2}[/.]\d{1,2}[/.]\d{2,4}',
        r'\d{1,2}\s+ב?(?:ינואר|פברואר|מרץ|אפריל|מאי|יוני|יולי|אוגוסט|ספטמבר|אוקטובר|נובמבר|דצמבר)',
    ]
    for pattern in date_patterns:
        matches = re.findall(pattern, text)
        if matches:
            entities.setdefault("dates", []).extend(matches)

    # תעודת זהות (9 ספרות)
    tz_matches = re.findall(r'(?<!\d)\d{9}(?!\d)', text)
    if tz_matches:
        entities["teudat_zehut"] = tz_matches

    return entities

ניתוח סנטימנט לעברית

# מילון סנטימנט פשוט לעברית
HEBREW_SENTIMENT = {
    # חיובי
    "מעולה": 1.0, "מצוין": 1.0, "נהדר": 0.9, "אהבתי": 0.9,
    "טוב": 0.6, "נחמד": 0.5, "תודה רבה": 0.7, "ממליץ": 0.8,
    "מרוצה": 0.8, "אחלה": 0.8, "סבבה": 0.5, "בומבה": 0.9,

    # שלילי
    "גרוע": -0.9, "נורא": -0.9, "מאכזב": -0.8,
    "רע": -0.7, "לא טוב": -0.6, "בעיה": -0.5,
    "לא עובד": -0.7, "לא מרוצה": -0.8, "אכזבה": -0.8,
}

def analyze_hebrew_sentiment(text: str) -> dict:
    """ניתוח סנטימנט בסיסי בעברית באמצעות מילון."""
    scores = []
    for expression, score in sorted(
        HEBREW_SENTIMENT.items(), key=lambda x: len(x[0]), reverse=True
    ):
        if expression in text:
            scores.append(score)

    if not scores:
        return {"sentiment": "neutral", "score": 0.0}

    avg = sum(scores) / len(scores)
    sentiment = "positive" if avg > 0.2 else "negative" if avg < -0.2 else "neutral"
    return {"sentiment": sentiment, "score": round(avg, 2)}

עץ תפריט בעברית

CONVERSATION_FLOWS = {
    "main_menu": {
        "message": "שלום! איך אפשר לעזור?\nבחר/י אחת מהאפשרויות:",
        "options": {
            "1": {"label": "הזמנה חדשה", "next": "new_order"},
            "2": {"label": "בדיקת סטטוס", "next": "check_status"},
            "3": {"label": "שאלות נפוצות", "next": "faq"},
            "4": {"label": "דבר/י עם נציג", "next": "human_handoff"},
        },
    },
    "new_order": {
        "message": "מעולה! בוא/י נתחיל הזמנה.\nמה תרצה/י להזמין?",
        "type": "free_text",
        "next": "order_quantity",
        "back": "main_menu",
    },
    "faq": {
        "message": "שאלות נפוצות:\n\n1. שעות פעילות\n2. מדיניות החזרות\n3. אזורי משלוח\n4. אמצעי תשלום",
        "options": {
            "1": {"label": "שעות", "response": "א'-ה': 9:00-17:00\nו': 9:00-13:00\nשבת: סגור"},
            "2": {"label": "החזרות", "response": "ניתן להחזיר עד 14 יום מהרכישה עם חשבונית."},
            "3": {"label": "משלוחים", "response": "שולחים לכל הארץ. רגיל: 5-7 ימים. מהיר: 1-2 ימים."},
            "4": {"label": "תשלום", "response": "ויזה, מאסטרקארד, ביט, פייבוקס, העברה, תשלומים."},
        },
        "back": "main_menu",
    },
}

טיפול ב-Fallback

FALLBACK_RESPONSES = [
    "לא הצלחתי להבין. אפשר לנסח אחרת?",
    "סליחה, לא הבנתי. נסה/י שוב או הקלד/י 'תפריט'.",
    "לא בטוח/ה שהבנתי. אפשר לבחור מהאפשרויות או לכתוב 'עזרה'.",
]

# אחרי 3 ניסיונות כושלים
CONFUSED_RESPONSE = (
    "נראה שאני מתקשה להבין. בוא/י ננסה אחרת.\n"
    "הקלד/י מספר מהתפריט, או 'נציג' לשיחה עם אדם."
)

העברה לנציג אנושי

async def handoff_to_human(user_id: str, context: dict):
    """העברת שיחה לנציג אנושי."""
    handoff_message = (
        "תודה על הסבלנות. מעביר/ה אותך לנציג אנושי.\n"
        "זמן המתנה משוער: {wait_time} דקות.\n\n"
        "כל מה שכתבת עד עכשיו יועבר לנציג."
    )

    ticket = {
        "user_id": user_id,
        "channel": context.get("channel", "web"),
        "language": "he",
        "conversation_history": context.get("history", []),
    }

    await support_queue.add(ticket)
    return handoff_message.format(wait_time=await support_queue.estimated_wait())

הסקיל הזה כולל סקריפטים בתיקיית scripts/:

• whatsapp-webhook-handler.py: מטפל webhook מלא ל-WhatsApp Cloud API עם אימות חתימה, ניתוב הודעות ותבניות תגובה בעברית
• telegram-bot-scaffold.py: בוט טלגרם מוכן עם תמיכה בעברית, מקלדות inline, ניהול מצב שיחה ומטפלי פקודות

ומסמכי עזר בתיקיית references/:

• hebrew-chatbot-phrases.md: ביטויים שיחתיים בעברית לבוטים, מאורגנים לפי קטגוריות עם תעתיקים
• whatsapp-business-api-guide.md: מדריך הגדרת WhatsApp Business API לעסקים ישראליים