חשבון ואינטגרציות

חיבור מערכת חיצונית או עוזר

צרו מפתח עם הרשאות מוגבלות ב-Pro או Agency, פרסמו תוכן עדכני או חברו עוזר.

לפני שמתחילים

Webhook מקבל הודעות על מסרים נכנסים משירות WhatsApp. הגדרתו בשרת היא באחריות מפעיל האינטגרציה. משתמשי הלוח אינם צריכים לשנות הגדרות שרת. MCP מאפשר לעוזר לבקש כלי חשבון.

מה לעשות

להודעות נכנסות פתחו הגדרות ומצאו כתובת Webhook.
בחרו העתקה לקבלת הכתובת המדויקת של סביבת החשבון שלכם.
בקשו מהמפעיל להגדיר אירועים נכנסים למכשיר הרצוי עם הכתובת הזו.
ארגנו הודעת בדיקה נכנסת ממספר שלכם אחרי שהמפעיל מאשר שהמערכת מוכנה.
בדקו את התוצאה הצפויה, למשל תגובה אוטומטית תואמת או הודעת קבוצה חדשה שנרשמה כשפעיל יומן.
לחיבור עוזר היכנסו דרך מסך ההרשאה שפותח לקוח ה-MCP שלכם.
בדקו את היישום הנקוב ואת החשבון לפני אישור גישה.
לשילוב שליחה, פתחו הגדרות ← שילובים חיצוניים. צרו מפתח בעל שם לחשבון מחובר אחד ולקבוצות שנבחרו במפורש. שמרו את המפתח מיד; הוא מוצג פעם אחת בלבד. העתיקו את כתובת הבסיס של ה-API.
דוגמה: הגדירו את Abacus.AI ליצירת תוכן עדכני בכל אחד משמונת מועדי הפרסום היומיים באזור הזמן America/Sao_Paulo. שלחו כל פרסום לשלוש קבוצות מורשות עם Idempotency-Key חדש. השתמשו שוב במפתח רק בניסיון חוזר של אותה בקשה בדיוק.
השמיטו את scheduled_at להוספה מיידית לתור, או השתמשו בחותמת זמן מוחלטת עם -03:00 או Z (UTC), עד 30 יום מראש. המעבד בודק מדי דקה; scheduled_at מציין את המועד המוקדם ביותר שבו ניתן לשלוח, ללא הבטחת מסירה בשנייה מדויקת.
בדקו את מצב המשימה ואת התוצאות לכל קבוצה לפני ניסיון חוזר. בטלו רק שליחות שטרם שוגרו. בטלו בהגדרות את תוקפו של מפתח שנחשף, ואז צרו ושמרו תחליף; משימות ישנות אינן מתחדשות עם מפתח חדש.

דוגמה מעשית

בקשות עם מצייני מקום; החליפו את המזהים ובחרו תאריך עתידי לפני שליחה. בקשות אלה מפרסמות הודעות אמיתיות. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

איך לבדוק שהפעולה הצליחה

קבלת המשימה ותוצאות הקבוצות שהתקבלו מאשרות קבלה בשער. הן אינן מאשרות מסירה או קריאה. משימות מתוזמנות עשויות להיחסם אם הגישה, המפתח, החשבון או הרשאות הקבוצות משתנים.

מה כדאי לדעת

עוזרים יכולים לקרוא רשומות זמינות ולשלוח טקסט לפי בקשה. קראו את מדריך כלי העוזר לפני בקשת שליחה.
השתמשו בלוח לפעולות עריכה שאינן זמינות דרך MCP.
הגישה ל-API כלולה בתוכניות Pro ו-Agency חודשיות או שנתיות. Starter מחייבת שדרוג. המפתחות מתירים רק את החשבון והקבוצות שנבחרו; החלפת חשבון WhatsApp חוסמת שליחה. לעולם אל תשתפו פרטי גישה לשרת.
טקסט תומך ב-4,096 תווים; כיתובים ב-1,024. העלו JPEG, PNG או WebP עד 5 MiB בשדות multipart בשם payload ו-image. כתובות URL לתמונות מרוחקות אינן מתקבלות.
משימה חדשה מחזירה HTTP 202. ניסיון חוזר זהה עם אותו Idempotency-Key מחזיר את המשימה המקורית עם HTTP 200; תוכן שונה עם אותו מפתח מחזיר 409. פסק זמן אחרי שיגור עלול להשאיר תוצאה לא מאושרת; אל תשלחו מחדש אוטומטית עם מפתח אחר.

בעיות נפוצות

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

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

קבלת עזרה נוספת

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

פתיחת התכונה