RealOffice.AIמחובר · עונה תוך שניות

    היום

    איך שולחים הודעת וואטסאפ מהמערכת שלנו?

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

    תמיכה למפתחים · AI

    בקריאת POST אחת. שולחים ל-/api/whatsapp/send-template את המספר, שם התבנית והפרמטרים, ומפתח ה-API מזהה את המשרד שלכם.

    ה-API לוואטסאפ של RealOffice.AI הוא REST API מעל WhatsApp Business API הרשמי של Meta. שולחים תבניות וואטסאפ והודעות טקסט, מתזמנים שליחה, מנהלים אנשי קשר וקמפיינים וקוראים שיחות ותמלולים. רוצים שעוזר AI יעבוד עם נתוני המשרד במקום קוד? Office MCP.

    מההרשמה להודעה הראשונה

    1. 1יוצרים מפתח API

      ב-app.realoffice.ai פותחים את התפריט Integration ואז API Accounts, יוצרים חשבון API ומעתיקים את המפתח. אפשר להגביל אותו לכתובת IP אחת.

    2. 2בוחרים מספר וואטסאפ

      GET /api/whatsapp/accounts מחזיר את מספרי הוואטסאפ של המשרד. שומרים את ה-id ושולחים אותו כ-whatsappAccountId. בלי השדה, ההודעה יוצאת מהמספר הפעיל הראשון.

    3. 3שולחים תבנית

      הודעה ראשונה ללקוח יוצאת כתבנית שאושרה ב-Meta, דרך POST /api/whatsapp/send-template. תבניות וואטסאפ

    4. 4ממשיכים בטקסט חופשי

      כשהלקוח עונה נפתח חלון של 24 שעות, ובו שולחים טקסט רגיל עם POST /api/whatsapp/send-message.

    שליחת תבנית וואטסאפ

    המפתח עובר בכותרת Authorization: Bearer או בכותרת X-API-Key. פרמטרים של התבנית נשלחים כמילון: body-1, body-2 לפי הסדר, או body-name לתבנית עם משתנים בשם. לתבנית עם כותרת מדיה או כפתורים שולחים במקומם componentsJson במבנה של Meta.

    curl -X POST https://api.realoffice.ai/api/whatsapp/send-template \
  -H "Authorization: Bearer $REALOFFICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "972501234567",
    "templateName": "appointment_reminder",
    "language": "he",
    "parameters": { "body-1": "Dana", "body-2": "10:00" }
  }'

    הודעת טקסט בתוך חלון 24 השעות

    טקסט חופשי עובר רק אם הלקוח כתב למספר ב-24 השעות האחרונות. זה כלל של WhatsApp, ומחוץ לחלון שולחים תבנית. הגוף פשוט: to, message ו-whatsappAccountId אופציונלי.

    curl -X POST https://api.realoffice.ai/api/whatsapp/send-message \
  -H "Authorization: Bearer $REALOFFICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "972501234567",
    "message": "Thanks Dana, see you tomorrow at 10:00",
    "whatsappAccountId": "YOUR_WHATSAPP_ACCOUNT_ID"
  }'

    כל ה-endpoints

    כתובת הבסיס היא https://api.realoffice.ai/api. כל הקריאות, חוץ מבדיקת התקינות, דורשות מפתח API, וכל תשובה מגיעה במעטפת JSON אחידה.

    WhatsApp

    • GET/api/whatsapp/accountsמספרי הוואטסאפ של המשרד, עם מזהה, מספר טלפון וסטטוס.
    • GET/api/whatsapp/accounts/{accountId}פרטי מספר וואטסאפ אחד.
    • GET/api/whatsapp/templates?accountId=כל התבניות של המספר מ-Meta, כולל סטטוס אישור. accountId אופציונלי.
    • GET/api/whatsapp/templates/{templateId}תבנית אחת לפי מזהה.
    • POST/api/whatsapp/templatesיצירת תבנית חדשה ושליחתה לאישור Meta: name, category, language, bodyText ושדות אופציונליים לכותרת ולתחתית.
    • DELETE/api/whatsapp/templates/{templateId}/{templateName}מחיקת תבנית.
    • POST/api/whatsapp/send-templateשליחת תבנית: to, templateName, language, parameters או componentsJson, whatsappAccountId.
    • POST/api/whatsapp/send-messageשליחת טקסט חופשי בתוך חלון 24 השעות: to, message, whatsappAccountId.
    • POST/api/whatsapp/schedule-templateתזמון תבנית לשעה מקומית של המספר, עם scheduledSendTimeLocal.

    אנשי קשר ותגיות

    • GET/api/contactsרשימת אנשי הקשר עם התגיות שלהם.
    • GET/api/contacts/{contactId}איש קשר אחד.
    • POST/api/contactsיצירת איש קשר.
    • PUT/api/contacts/{contactId}עדכון איש קשר לפי מזהה.
    • PUT/api/contacts/phone/{phoneNumber}עדכון איש קשר לפי מספר טלפון.
    • POST/api/contacts/searchחיפוש אנשי קשר עם מסננים.
    • POST/api/contacts/syncסנכרון אנשי קשר ממערכת חיצונית.
    • POST/api/contacts/{contactId}/tagsהוספת תגיות לאיש קשר.
    • DELETE/api/contacts/{contactId}/tagsהסרת תגיות מאיש קשר.
    • GET/api/contacts/tagsכל התגיות של המשרד.
    • POST/api/contacts/tagsיצירת תגית.

    קמפיינים

    • GET/api/campaignsכל הקמפיינים של המשרד.
    • GET/api/campaigns/{campaignId}פרטי קמפיין.
    • POST/api/campaignsיצירת קמפיין: מספר, תבנית, תגיות יעד ותגיות להחרגה, וקצב שליחה.
    • POST/api/campaigns/{campaignId}/startהפעלת קמפיין.
    • POST/api/campaigns/{campaignId}/stopעצירת קמפיין.
    • POST/api/campaigns/{campaignId}/scheduleתזמון קמפיין.
    • POST/api/campaigns/{campaignId}/add-tasksהוספת נמענים לקמפיין רציף שכבר רץ.
    • GET/api/campaigns/{campaignId}/progressהתקדמות השליחה.
    • GET/api/campaigns/{campaignId}/tasksהנמענים והסטטוס של כל אחד.
    • GET/api/campaigns/{campaignId}/respondersמי ענה לקמפיין, עם ההודעה האחרונה שלו.

    שיחות ותמלולים

    • GET/api/conversationsסיכום השיחות האחרונות של המשרד.
    • GET/api/conversations/{phoneNumber}היסטוריית ההודעות בוואטסאפ עם מספר טלפון.
    • GET/api/conversations/{phoneNumber}/summaryמספר ההודעות, תאריך ראשון ואחרון ותצוגה מקדימה של ההודעה האחרונה.
    • GET/api/transcriptions/recentתמלולי השיחות האחרונים.
    • POST/api/transcriptions/searchחיפוש תמלולים עם מסננים.
    • GET/api/transcriptions/{transcriptionId}תמלול אחד.

    סוכני AI

    • GET/api/agentsהסוכנים של המשרד.
    • GET/api/agents/{agentId}סוכן אחד.
    • POST/api/agents/{agentId}/activateהפעלת סוכן על שיחה, מחזיר מזהה הפעלה.

    תקינות

    • GET/api/healthמצב השירות, בלי מפתח API.
    • GET/api/health/pingבדיקה מהירה שה-API עונה.

    כללים שכדאי להכיר

    • חלון 24 השעותטקסט חופשי נמסר רק בתוך 24 שעות מההודעה האחרונה של הלקוח. לפני כן, או אחרי, שולחים תבנית מאושרת.
    • מגבלת קצבעד 100 בקשות בדקה ו-1,000 בשעה מכל כתובת IP. מעבר לזה מתקבלת תשובה 429, ומנסים שוב אחרי המתנה.
    • מעטפת תשובה אחידהכל תשובה כוללת success, data, message, errors ו-timestamp. בשגיאה success הוא false ו-message מסביר מה קרה.
    • כמה מספרי וואטסאפבלי whatsappAccountId ההודעה יוצאת מהמספר הפעיל הראשון. בתזמון, כשיש כמה מספרים פעילים, חובה לציין את המספר.
    • מפתח לכל מערכתלכל חשבון API מפתח משלו, עם אפשרות להגבלת IP. חשבון מושבת מקבל 403, ומפתח שהוחלף מפסיק לעבוד מיד.
    • יומן קריאותבקשות השליחה והתשובות להן נשמרות, ואפשר לראות אותן באפליקציה במסך API Messages.

    שאלות של מפתחים

    איך מקבלים גישה ל-API לוואטסאפ?

    צריך משרד ב-RealOffice.AI עם מספר וואטסאפ מחובר. את המפתח יוצרים באפליקציה במסך API Accounts. WhatsApp Business API

    אפשר לשלוח הודעה ללקוח שעוד לא כתב לנו?

    כן, רק בתבנית שאושרה ב-Meta, דרך send-template. טקסט חופשי אפשר לשלוח רק אחרי שהלקוח כתב, בתוך 24 שעות.

    איך מעבירים משתנים לתבנית?

    בשדה parameters, כמילון עם מפתחות כמו body-1 ו-header-1, או body-name לתבנית עם משתנים בשם. לתבניות מורכבות שולחים componentsJson במבנה של Meta.

    אפשר לתזמן הודעת וואטסאפ דרך ה-API?

    כן. POST /api/whatsapp/schedule-template מקבל את אותם שדות כמו שליחת תבנית, ועוד scheduledSendTimeLocal בשעון המקומי של המספר. הודעות מתוזמנות

    איפה רואים את כל השדות של כל קריאה?

    בתיעוד Swagger של ה-API, בכתובת https://api.realoffice.ai/swagger.

    מה ההבדל בין ה-API ל-Office MCP?

    ה-API מיועד לקוד שלכם: שליחה, תזמון וסנכרון. Office MCP נותן לעוזרי AI כמו Claude או Cursor לקרוא את נתוני המשרד ולעדכן את ה-CRM. Office MCP

    בואו נדבר

    RealOffice.AI

    היי, כאן הסוכן של RealOffice.AI. השאירו פרטים ונחזור אליכם עם הדגמה על העסק שלכם.

    מעדיפים לדבר עכשיו? 053-5908627 · sales@realoffice.ai