שילוב WhatsApp Business API באפליקציה הניידת שלך

שילוב WhatsApp Business API באפליקציה הניידת שלך

אנו משלבים את WhatsApp Cloud API באפליקציות ניידות — מהלוגיקה של השרת ועד לממשק המשתמש. זה לא על התקנת אפליקציית WhatsApp Business בטלפון, אלא על חיבור ל-Cloud API של Meta עם תבניות מאושרות מראש, webhooks ואימות חשבון עסקי. לצוות שלנו יש ניסיון של 5+ שנים: מאות אינטגרציות מוצלחות, טיפול בעד 500 הודעות בשנייה, עם זמן תגובה ממוצע של פחות מ-200 אלפיות השנייה.

תרחיש טיפוסי: לקוח רוצה לשלוח הודעות עדכון סטטוס הזמנה דרך WhatsApp ולקבל הודעות נכנסות ממשתמשים. ללא ארכיטקטורה נכונה, אתה מסתכן בחסימת החשבון שלך עקב הפרות מדיניות של Meta. אנו עוזרים להימנע מכך, וחוסכים עד 70% בעלויות שליחת הודעות המוניות בהשוואה ל-SMS.

איך עובד שילוב WhatsApp Cloud API

Meta העבירה את ה-API לענן — אין צורך לארח שרת משלך. שליחת הודעה מתבצעת באמצעות בקשת POST ל-Graph API:

POST https://graph.facebook.com/v19.0/{PHONE_NUMBER_ID}/messages
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "380991234567",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": {
      "code": "ru"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "Иван"
          },
          {
            "type": "text",
            "text": "#98765"
          },
          {
            "type": "text",
            "text": "сегодня с 14:00 до 18:00"
          }
        ]
      }
    ]
  }
}

תבניות (POST https://graph.facebook.com/v19.0/{PHONE_NUMBER_ID}/messages Authorization: Bearer {ACCESS_TOKEN} Content-Type: application/json { "messaging_product": "whatsapp", "to": "380991234567", "type": "template", "template": { "name": "order_shipped", "language": { "code": "ru" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Иван" }, { "type": "text", "text": "#98765" }, { "type": "text", "text": "сегодня с 14:00 до 18:00" } ] } ] } } ) הן חובה להודעות יוצאות ראשוניות. טקסט חופשי ניתן לשלוח רק בתוך 24 שעות מההודעה האחרונה של המשתמש (חלון שירות). כל תבנית נבדקת על ידי Meta ובדרך כלל מאושרת תוך 1–3 ימי עסקים. אנו מבטיחים שכל התבניות יעברו את הבדיקה בניסיון הראשון אם המדיניות נשמרת.

קטגוריות תבניות והגבלות

תבניות שיווק דורשות הסכמה מפורשת של המשתמש. שליחה ללא הסכמה מפרה את מדיניות Meta ומסכנת את השעיית החשבון. אנו תמיד מיישמים מנגנון איסוף הסכמה ישירות באפליקציה.

Cloud API לעומת On-Premises: מה לבחור?

ה-Cloud API מושק פי 3 מהר יותר מאשר On-Premises בשל היעדר צורך בתשתית עצמית. עבור רוב הפרויקטים, אנו ממליצים על Cloud API.

איך להגדיר Webhooks להודעות נכנסות?

Webhooks (קריאות חוזרות) הם המפתח לקבלת הודעות משתמשים וסטטוסי מסירה. ההגדרה כוללת את השלבים הבאים:

1. צור נקודת קצה בשרת שלך שמקבלת בקשת POST.
2. רשום את ה-URL במסוף המפתחים של Meta.
3. טפל בבקשת האימות GET (MARKETING).
4. הגדר עיבוד של הודעות נכנסות וסטטוסים.

השרת האחורי מקבל POST כמו:

// Входящее сообщение от пользователя
{
  "entry": [
    {
      "changes": [
        {
          "value": {
            "messages": [
              {
                "from": "380991234567",
                "type": "text",
                "text": {
                  "body": "Когда будет доставка?"
                },
                "timestamp": "1711440000"
              }
            ]
          }
        }
      ]
    }
  ]
}

// Статус доставки исходящего сообщения
{
  "statuses": [
    {
      "id": "wamid.XXXXX",
      "status": "delivered",
      "timestamp": "1711440060",
      "recipient_id": "380991234567"
    }
  ]
}

חשוב: נקודת הקצה חייבת להגיב ל-POST תוך פחות מ-5 שניות — אחרת Meta תנסה שוב ובסופו של דבר תשבית את ה-webhook. אנו מתכננים את נקודת הקצה עם עיבוד אסינכרוני כדי לעמוד במגבלת הזמן. לפי התיעוד של WhatsApp Cloud API, מגבלת הזמן לא תעלה על 5 שניות.

למה חלון ה-24 שעות קריטי?

WhatsApp Cloud API מאפשר שליחת הודעות בטקסט חופשי רק בתוך 24 שעות מההודעה האחרונה של המשתמש. לאחר חלון זה, ניתן לשלוח רק הודעות תבנית. אם מתעלמים מכך, המשתמש לא יקבל תגובה בזמן, מה שפוגע בחוויית הלקוח. האפליקציה הניידת צריכה להציג את מצב החלון ולהנחות את הנציג לבחור תבנית אם החלון סגור.

// iOS — загрузка истории диалога
struct WhatsAppConversation: Identifiable, Decodable {
    let id: String
    let contactPhone: String
    let contactName: String?
    let lastMessage: WhatsAppMessage
    let unreadCount: Int
    let windowExpiresAt: Date? // 24-часовое окно
}

// Отображение статуса окна
var isWithinServiceWindow: Bool {
    guard let expires = windowExpiresAt else {
        return false
    }
    return Date() < expires
}

אם hub.challenge — ממשק המשתמש צריך להציג אזהרה ששליחת הודעות בטקסט חופשי אינה אפשרית, ולהציע לבחור תבנית.

אימות חשבון עסקי

WhatsApp Business API דורש Business Manager מאומת ב-Meta. התהליך: צור Meta Business Manager → אמת את העסק (מסמכים) → צור חשבון WhatsApp Business → קבל מספר טלפון. לא ניתן להשתמש במספר בו זמנית באפליקציית WhatsApp Business — רק ב-API.

האימות אורך 5 עד 14 ימים. זהו שלב חוסם — ניתן לפתח במקביל באמצעות ארגז חול לבדיקות (קבוצה מוגבלת של מספרים). אנו עוזרים להכין מסמכים מראש כדי לזרז את התהליך. שימוש ב-WhatsApp במקום SMS יכול לחסוך עד 70% בעלויות שליחת הודעות המוניות.

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

• ניתוח דרישות ועיצוב אינטגרציה
• יצירה ורישום של תבניות הודעות ב-Meta
• פיתוח מטפל webhook בצד השרת מאפס או שילוב עם השרת האחורי הקיים
• בניית ממשק משתמש נייד לצ'אט נציג עם תמיכה בחלון שירות
• הגדרת חתימת קוד, התראות push ל-iOS/Android
• שילוב עם App Store Connect ו-Google Play Console
• תיעוד שימוש ב-API והעברת גישה
• בדיקות בארגז חול והשקה לייצור

לוחות זמנים משוערים

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

בקש ייעוץ על שילוב WhatsApp Business API — צור קשר כדי להעריך את הפרויקט שלך.