במפתחים > אישורים, צור אסימון עבור האינטגרציה messages:write. העתק אותו בעת היצירה, שמור אותו ב-backend והגדר את חיבור ה‑WhatsApp בלוח הבקרה לפני השליחה.
מפתח API
API לחיבור WhatsApp למערכות וליישומים שלך.
אינטגרציה של CRM, ERP, אפליקציות ומערכות פנימיות ל‑WhatsApp באמצעות REST API של WPP Marketing. שלח טקסט ומדיה, בדוק הודעות ועקוב אחרי מסירות דרך webhooks. השתמש גם ב‑MCP כדי לשלב את הזרימות שלך עם ה‑Official API. לְהַכִּיר את MCP.
מתי להשתמש
השתמש ב-API להודעות כאשר המערכת שלך צריכה לשלוח הודעות WhatsApp.
השתמש ב‑CRM שלך כדי להתחיל תקשורת, ב‑ERP שלך כדי לשלוח עדכון או באפליקציה שלך כדי להודיע ללקוח. הלוגיקה של מתי לשלוח נשארת במערכת שלך; ה‑API מבצעת את השליחה דרך החיבור המוגדר בחשבון. לאוטומציות מסחריות מוכנות לשימוש, השתמש ב‑Events API.
השתמש ב‑POST /send-text לטקסט או ב‑POST /send-media למדיה. בחיבור הרשמי, טקסט ותמונה משתמשים בתבניות המוגדרות; אודיו, וידאו ומסמכים דורשים הודעה שהתקבלה מהלקוח בתוך 24 השעות האחרונות.
HTTP 200 מציין קבלה, לא מסירה. עם messages:read, השתמש ב-GET /messages ובדוק את הסטטוסים הזמינים עבור הערוץ.
רשום את כתובת ה-HTTPS והפעל אירועים בלוח הבקרה. השתמש ב-webhooks:read כדי לשאול ניסיונות ב-GET /webhooks; נקודת הקצה הזו מציגה משלוחים, היא אינה רושמת מנויים.
מהטוקן ועד המשלוח הראשון כלול.
על השרת שלך החלף את SEU_TOKEN באישורים ואת המספר במקבל המורשה לבדיקת הנושא. השתמש במפתח ייחודי לכל שליחה והשתמש באותו מפתח רק כאשר אתה חוזר על אותה בקשה.
בדוק את סטטוס ה‑HTTP וגוף התשובה. עבור 401 בדוק את הטוקן ואת תוקפו; עבור 403 בדוק את הסקופים ותנאי החשבון. עבור 409 בדוק האם המפתח כבר שומש לתוכן אחר. עבור 429 כבד את Retry-After לפני ניסיון חוזר.
לאחר מכן בדוק את GET /messages עם messages:read או עקוב אחר ה‑webhooks המוגדרים. אישור המסירה תלוי בתשובת הערוץ.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'טקסט, מדיה, היסטוריה ומעקב אחר שליחויות.
השתמשו ב‑REST endpoints כדי לשלב את WhatsApp באפליקציה שלכם. ה‑WPP Marketing API משתמשת בחיבור המוגדר בחשבון; כדי לעבוד עם ה‑Official WhatsApp API, הגדרו את אותו החיבור בלוח הבקרה. עיינו ב‑OpenAPI כדי לראות את הפורמטים, התחומים (scopes), הגבולות והתשובות של כל פעולה.
POST
/send-text
שולח הודעת טקסט למספר WhatsApp.
Texto
POST
/send-media
שלח תמונה, שמע, וידאו או מסמך באמצעות כתובת URL ציבורית עם HTTPS, בהתאם לפורמט ולתנאי החיבור. שמע משתמש באותו נקודת קצה.
Mídia
GET
/messages
בדוק את היסטוריית ההודעות שנשלחו עם סטטוס ודף.
Histórico
GET
/webhooks
בדוק אספקות webhook לפי אירוע, תוצאת HTTP, ניסיונות ועמודיות.
Webhooks
DOC
Swagger / OpenAPI
תיעוד אינטראקטיבי עם חוזים, דוגמאות, שדות חובה ותשובות צפויות.
Docs
הפרדה טכנית
בחר/י את הפיצ'ר המתאים לכל שלב של האינטגרציה.
שלחו הודעות באמצעות ה‑Messaging API, הפעילו אוטומציות עסקיות באמצעות ה‑Events API וקבלו החזרות דרך webhooks. היישום שלכם יכול לשלב תכונות אלה לפי הזרימה הנדרשת.
החיבור הרשמי הוא ערוץ התקשורת; ממשק ה‑API של WPP Marketing הוא הממשק שבו משתמש המערכת שלכם. עיינו בדרישות ב־ API רשמית של WhatsApp וקיום משותף.
המערכת שלך קוראת ל‑WPP Marketing כדי לשלוח הודעות טקסט או מדיה ולשאול היסטוריות הודעות והספקות של webhooks.
המערכת שלך שולחת אירועים מסחריים כגון הזמנה נוצרה, תשלום מאושר, משלוח או עגלה ננטשה.
הבינו את האירועים והאוטומציות הזמינותWPP Marketing שולח אירועים סטנדרטיים של יצירה, משלוח, קריאה ושגיאה ל-URL שאתם מספקים.
צפו באירועי החזרה ובעקבות משלוחיםהשתמש בתיעוד האינטראקטיבי כדי לאמת payloads, אימות ותשובות לפני פריסה בסביבת הייצור.
הטוקנים צריכים להישאר ב-backend. אל תחשפו אישורי גישה בדפי ציבור, באפליקציות צד-לקוח או במאגרים.
ב-/send-text וב-/send-media, Idempotency-Key מאפשר לשחזר את אותה בקשה עם תגובה מוצלחת עד 48 שעות. שימוש חוזר במפתח עם תוכן שונה מחזיר 409. בלי המפתח, חזרה על הקריאה עלולה לשכפל את השליחה. יש לציית לכותרות RateLimit ו-Retry-After; מגבלות הבקשות שונות מהמניין של התוכנית.
אישורת אחת לכל אינטגרציה, עם ההרשאות הנדרשות.
בלוח הבקרה, תן שם לטוקן, בחר את ההיקפים (scopes) וקבע תוקף אופציונלי. הטוקן המלא מוצג רק פעם אחת ביצירה. הרשימה מאפשרת לבדוק שימוש אחרון, תוקף ולבטל גישה בעת הצורך.
בעת החלפת אישור, עדכן את הסוד בשרת שלך ובטל את האישור הקודם. אין להשתמש בטוקן של ספק WhatsApp במקום אישור ה-API.
מאפשר שליחת טקסט ומדיה. העניקו רק לאינטגרציות שצריכות להתחיל שליחה.
הם מאפשרים לעיין, בהתאמה, בהיסטוריית ההודעות ובמסירות ה‑webhook. אישור שליחה אינו מקבל הרשאות אלו באופן אוטומטי.
מאפשר לדווח על לקוחות, סליקות והזמנות דרך Events API לאוטומציות המוגדרות בחשבון.
בוחן הגדרות שמורות, אוטומציות, ספירות ורישומים אחרונים לאבחון. עשוי לכלול נתונים אישיים ותוכן הודעות: הענק גישה רק לאינטגרציות ולתמיכה מורשים. בדיקה זו אינה בודקת את חיבור הספק בשידור חי.
MCP ו-API הרשמית של WhatsApp.
חברו כלי בינה מלאכותית לתפעול ה‑WhatsApp שלכם עם MCP של WPP Marketing. שלבו את WhatsApp בזרמי העבודה של העוזרים והסוכנים שלכם, תוך שימוש ב‑API הרישמית כחיבור הודעות.
MCP מחבר את הזרימות של הסוכנים שלך לאינטגרציה; ה‑API של ההודעות מבצעת את השליחויות והחיבור הרשמי עוקב אחר הכללים של WhatsApp. זה לא הופך את ה‑MCP לצ'אטבוט מקומי ולא מחליף את הגדרת החשבון. הצוות מנחה את הפעולות ואת דרישות האינטגרציה עבור מקרה השימוש שלך.
השתמש ב‑MCP כנתיב אינטגרציה בין כלי AI ל‑WhatsApp, להשלמת הזרימות של המערכות והצוות שלך.
דברו עם הצוות שלנו על כלי ה‑IA שבו אתם משתמשים ועל הפעולות שברצונכם לחבר ל‑WhatsApp. עברו על הדרישות וההיקף המתאים לפעילות שלכם.
לדבר על אינטגרציית MCPמוכן לשלב את המערכת שלך עם WPP Marketing?
פתח את Swagger כדי לעיין ב-endpoints של Messaging API, בדוגמאות payload, באימות bearer token ובתגובות הצפויות. עבור אירועים בחנות ומשוב על אספקה, ראה גם Events API ו Webhooks de status.