WhatsApp Business API: אינטגרציה, התראות, צ'אטבוטים

$response = Http::withToken(env('WHATSAPP_ACCESS_TOKEN'))
    ->post("https://graph.facebook.com/v19.0/{$phoneNumberId}/messages", [
        'messaging_product' => 'whatsapp',
        'to' => $phone,
        'type' => 'template',
        'template' => [
            'name' => 'order_confirmation',
            'language' => ['code' => 'ru'],
            'components' => [
                [
                    'type' => 'body',
                    'parameters' => [
                        ['type' => 'text', 'text' => $orderId],
                        ['type' => 'text', 'text' => $orderTotal . ' $']
                    ]
                ]
            ]
        ]
    ]);

תבניות הודעות. עבור התראות יוצאות, יש להשתמש בתבניות מאושרות מראש. התבנית נוצרת ב-Meta Business Manager ועוברת בדיקה (בדרך כלל 24–48 שעות). טקסט מותאם אישית בהודעות יוצאות אסור—רק בתוך חלון הסשן של 24 שעות.

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

Http::withToken($token)->post($url, [
    'messaging_product' => 'whatsapp',
    'to' => $phone,
    'type' => 'text',
    'text' => ['body' => "Ваш заказ отправлен, трек-номер: {$trackNumber}"]
]);

Webhook להודעות נכנסות. אימות ועיבוד:

if ($request->has('hub_challenge')) {
    if ($request->hub_verify_token === env('WHATSAPP_VERIFY_TOKEN')) {
        return response($request->hub_challenge);
    }
}

$body = $request->json()->all();
foreach ($body['entry'] as $entry) {
    foreach ($entry['changes'] as $change) {
        $messages = $change['value']['messages'] ?? [];
        foreach ($messages as $message) {
            dispatch(new ProcessWhatsAppMessageJob($message));
        }
    }
}

כפתורים אינטראקטיביים. מאפשרים קבלת אישורים מהלקוח ללא הזנת טקסט:

[
    'type' => 'interactive',
    'interactive' => [
        'type' => 'button',
        'body' => ['text' => 'Ваш заказ готов к выдаче. Подтвердите получение:'],
        'action' => [
            'buttons' => [
                ['type' => 'reply', 'reply' => ['id' => "confirm_{$orderId}", 'title' => 'Получил ✓']],
                ['type' => 'reply', 'reply' => ['id' => "problem_{$orderId}", 'title' => 'Проблема']]
            ]
        ]
    ]
]

איך תהליך האינטגרציה עובד?

1. ניתוח—אנו לומדים את התהליכים העסקיים הנוכחיים שלכם ומזהים תרחישי התראות.
2. עיצוב—אנו מפתחים את הארכיטקטורה: webhooks, תורים, תבניות.
3. הטמעה—אנו מגדירים Cloud API או BSP וכותבים קוד אינטגרציה.
4. בדיקות—אנו מוודאים שליחה, קבלה וטיפול בשגיאות.
5. השקה—אנו מעלים לסביבת ייצור ומנטרים את הימים הראשונים.

מה כלול בעבודה

• הגדרת WhatsApp Business API (ישיר או דרך BSP).
• יצירת תבניות הודעות להזמנות, תשלומים, סטטוסים.
• הטמעת webhook לעיבוד הודעות נכנסות.
• אינטגרציה עם ה-CRM או האתר שלכם.
• תיעוד API והוראות למנהלים.
• הכשרת עובדים על המערכת.
• תמיכה ל-30 יום לאחר ההשקה.
• זמינות מובטחת של 99.9% לאינטגרציה.
• מפתחי WhatsApp API מוסמכים בצוות.

לוחות זמנים

אינטגרציה בסיסית (התראות + הודעות נכנסות) אורכת 3 עד 5 ימים. פרויקט מלא עם צ'אטבוט ותרחישים מותאמים אישית אורך 7 עד 14 ימים. העלות מחושבת באופן אישי—צרו קשר להערכה.

טעויות נפוצות באינטגרציה של WhatsApp Business API

• שימוש במספר שכבר מקושר לחשבון וואטסאפ אישי. נדרש מספר חדש.
• הגדרת webhook שגויה—טוקן אימות לא מוגדר.
• שליחת תבניות לא מאושרות בהודעות יוצאות.
• התעלמות ממגבלות קצב ה-API (לדוגמה, 10k הודעות ביום).
• חוסר טיפול בשגיאות (לדוגמה, כאשר Meta API לא זמין).

השוואת סוגי הודעות

קבלו ייעוץ לפרויקט שלכם—אנו נעריך את המשימה ונציע פתרון אופטימלי. הזמינו אינטגרציה ואנו ניצור קשר תוך שעה.

למידע נוסף בתיעוד ה-API הרשמי.