מודול שילוב מסנג'רים Bitrix עבור טלגרם, וואטסאפ, וייבר

local/modules/vendor.messenger/
├── lib/
│   ├── Channel/
│   │   ├── TelegramChannel.php
│   │   ├── WhatsappChannel.php
│   │   └── ChannelInterface.php
│   ├── NotificationRouter.php # Выбор канала для отправки
│   ├── TemplateEngine.php # Шаблонизатор сообщений
│   └── SubscriptionManager.php # Управление подписками
└── install/db/install.sql

טבלת local/modules/vendor.messenger/ ├── lib/ │ ├── Channel/ │ │ ├── TelegramChannel.php │ │ ├── WhatsappChannel.php │ │ └── ChannelInterface.php │ ├── NotificationRouter.php # Выбор канала для отправки │ ├── TemplateEngine.php # Шаблонизатор сообщений │ └── SubscriptionManager.php # Управление подписками └── install/db/install.sql — קישור משתמש-ערוץ:

כיצד פועל קישור חשבון Telegram?

1. המשתמש לוחץ על "קישור Telegram" בחשבון האישי.
2. המערכת יוצרת קוד חד-פעמי וקישור b_messenger_subscription.
3. המשתמש נכנס לבוט ושולח https://t.me/yourbot?start=CODE123.
4. הבוט דרך Webhook מקבל את ההודעה, מוצא את הרשומה לפי קוד בטבלת /start CODE123, ושומר את b_messenger_link_token ב-chat_id.

כל התהליך אורך 2–3 שניות.

CREATE TABLE b_messenger_link_token (
    TOKEN varchar(32) NOT NULL,
    USER_ID int NOT NULL,
    CHANNEL varchar(50) NOT NULL,
    EXPIRES_AT datetime NOT NULL,
    PRIMARY KEY (TOKEN)
);

Webhook להודעות נכנסות

Telegram שולח עדכונים לכתובת URL כמו b_messenger_subscription. ב-Bitrix, זה מטופל דרך handler מותאם אישית:

// local/api/telegram/webhook/index.php
$update = json_decode(file_get_contents('php://input'), true);
if (isset($update['message'])) {
    \Vendor\Messenger\TelegramWebhookHandler::handle($update);
}

ה-handler מנתח את ההודעה הנכנסת: אם זה CREATE TABLE b_messenger_link_token ( TOKEN varchar(32) NOT NULL, USER_ID int NOT NULL, CHANNEL varchar(50) NOT NULL, EXPIRES_AT datetime NOT NULL, PRIMARY KEY (TOKEN) ); — מקשר את החשבון. אם זו בקשת טקסט — מעביר אותה ללוגיקת הצ'אט (אם מיושם צ'אטבוט תמיכה).

שליחת הודעות

הודעות מקושרות לאירועי Bitrix דרך אירועי דוא"ל או ישירות דרך handlers:

\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'sale',
    'OnSaleStatusOrder',
    [NotificationRouter::class, 'onOrderStatusChange']
);

המתודה /api/telegram/webhook/ קובעת את הערוץ המתאים למשתמש, מרכיבה הודעה מתבנית, ושולחת אותה. עבור Telegram:

$response = \Bitrix\Main\Web\HttpClient::post(
    "https://api.telegram.org/bot{$token}/sendMessage",
    json_encode([
        'chat_id' => $chatId,
        'text' => $message,
        'parse_mode' => 'HTML',
    ]),
    ['Content-Type' => 'application/json']
);

תיעוד Telegram Bot API: https://core.telegram.org/bots/api

תבניות הודעות: מבנה והגדרה

תבניות הודעות לכל אירוע ולכל ערוץ מאוחסנות בטבלת // local/api/telegram/webhook/index.php $update = json_decode(file_get_contents('php://input'), true); if (isset($update['message'])) { \Vendor\Messenger\TelegramWebhookHandler::handle($update); } . נתמכים משתנים כמו /start TOKEN, \Bitrix\Main\EventManager::getInstance()->addEventHandler( 'sale', 'OnSaleStatusOrder', [NotificationRouter::class, 'onOrderStatusChange'] ); , onOrderStatusChange. עריכת תבניות זמינה בחלק הניהולי.

עבור Telegram, נתמך עיצוב HTML ($response = \Bitrix\Main\Web\HttpClient::post( "https://api.telegram.org/bot{$token}/sendMessage", json_encode([ 'chat_id' => $chatId, 'text' => $message, 'parse_mode' => 'HTML', ]), ['Content-Type' => 'application/json'] ); , b_messenger_template, {{order_id}}). עבור WhatsApp, רק כוכביות להדגשה ({{status}}).

תור שליחת הודעות

שליחה למסנג'רים מתבצעת בצורה אסינכרונית דרך תור בטבלת {{tracking_number}}. זה מגן מפני חסימת התהליך הראשי בעיכובי רשת של ממשקי המסנג'רים ומאפשר ניסיונות חוזרים בשגיאות זמניות:

משימת cron מעבדת את התור כל דקה, ומנסה שוב ניסיונות שנכשלו עם השהיה אקספוננציאלית.

מה כלול בפתרון

• ניתוח תהליכים עסקיים שלכם ובחירת ערוצים.
• עיצוב ארכיטקטורה: טבלאות, handlers, תבניות.
• פיתוח שילוב עם Telegram ו-WhatsApp (בסיסי).
• הגדרת תור שליחה עם ניסיונות חוזרים.
• יצירת 5–7 תבניות הודעות לאירועים שלכם (הזמנה, תשלום, משלוח).
• תיעוד תפעולי והדרכה למנהל המערכת שלכם.
• 30 ימי תמיכה לאחר ההשקה.
• ניהול פרויקט ותקשורת דרך Slack/Telegram.

כמה זמן אורך הפיתוח?

תמחור

התמחור שלנו מותאם להיקף ולדרישות שלכם. צרו קשר להערכה חינמית.

המודול מספק החזר השקעה מהיר על ידי הפחתת עלויות תמיכה והגברת רכישות חוזרות.

הניסיון שלנו

עם למעלה מ-10 שנות ניסיון בפיתוח Bitrix ויותר מ-100 פרויקטים מוצלחים, כולל 50+ מודולים מותאמים אישית למסחר אלקטרוני ומסנג'רים, אנו מספקים פתרונות חזקים וניתנים להרחבה שעסקים בכל הגדלים סומכים עליהם.

קבלו ייעוץ לפרויקט שלכם — נעריך את ההיקף ונציע את הפתרון האופטימלי. אנו מבטיחים פעילות יציבה של המודול תחת עומס ותמיכה מהירה.