בקצרה: ה‑API של Mumble מאפשר לשלוח הודעות WhatsApp, ליצור לקוחות ולנהל רשימות מהמערכת שלכם. יוצרים מפתח בפרופיל טכני, ושולחים אותו בכל בקשה ב‑header בשם Mumble-Api-Key. לחיבורים פשוטים בלי קוד, Make או Zapier נוחים יותר.
הגדרה ראשונית
- לחצו הגדרות בתפריט ועברו לפרופיל טכני.
- בחלק מפתח API, לחצו על כפתור יצירת המפתח. אם כבר יש מפתח, לחצו Copy.
- שמרו את המפתח במקום מאובטח, למשל במשתני סביבה. אל תשמרו אותו במסמך משותף או ב‑Git.
- בכל בקשה שלחו שני headers:
Mumble-Api-Key: YOUR_TOKEN_HEREContent-Type: application/json
כתובת הבסיס: https://app.mumble.co.il/mumbleapi/. המפתח הוא כמו סיסמה. אם הוא דלף, פנו לתמיכה של Mumble כדי להחליף אותו, כי אין אפשרות להחליף אותו מהממשק.
שליחת הודעות
| מה שולחים | נקודת קצה | מתי זה עובד |
|---|---|---|
| טקסט חופשי | POST /send-text-message |
רק כשחלון השיחה פתוח |
| תמונה, וידאו או קובץ | POST /send-media-message |
רק כשחלון השיחה פתוח |
| הודעה מוכנה | POST /send-template |
תמיד |
| הודעה מוכנה עם משתנים | POST /send-template-text-variable |
תמיד |
| בדיקה אם החלון פתוח | GET /is-active-conv |
תמיד |
- טלפון:
customer_phoneבפורמט בינלאומי, בלי + ובלי 0, למשל972501234567. - הודעה מוכנה:
template_idהוא המזהה (UUID) של ההודעה, לא השם שלה. מקבלים אותו מ‑GET /get-templates. - משתנים: שולחים מערך
variable, באותו סדר כמו{{1}},{{2}}בהודעה.
הדרך המומלצת: בדקו קודם עם is-active-conv. אם החלון פתוח, שלחו טקסט חופשי. אם הוא סגור, שלחו הודעה מוכנה. פרמטרים ודוגמאות לכל נקודה נמצאים בתיעוד ה‑API המלא.
מגבלות ועלויות
- מכסה חודשית: מספר הקריאות תלוי בחבילה. הצריכה מופיעה בעמוד הראשי, במד כמות API שנשלחו. פירוט בעמוד המחירים.
- קצב שליחה: עד 5 בקשות בשנייה, 100 בדקה ו‑2,000 בשעה בנקודות השליחה. מעבר לזה מתקבלת שגיאה 429. השהו בין הודעות ונסו שוב אחרי המתנה.
- עלות ב‑Meta: כמו שליחה מהממשק, Meta מחייבת על כל הודעה שנמסרת. ראו תשלום ל‑Meta ועלויות שליחה.
- מגבלות שליחה של Meta: כמה לקוחות אפשר לפנות אליהם בהודעות מוכנות ב‑24 שעות. ראו מגבלות שליחה ב‑WhatsApp.
שאלות נפוצות
אני מקבל 401 בכל בקשה
כנראה המפתח נשלח כ‑Authorization: Bearer. שלחו אותו ב‑header בשם Mumble-Api-Key.
מתקבלת שגיאת Customer not found, למרות שהלקוח קיים
המספר לא בפורמט הנכון. ראו פורמט מספרי טלפון בינלאומי.
מתקבלת התשובה Conversation is closed
חלון השיחה סגור. שלחו הודעה מוכנה במקום טקסט חופשי.
הודעת מרקטינג נכשלה עם שגיאה 131049
Meta מגבילה כמה הודעות מרקטינג לקוח אחד מקבל. אל תנסו לשלוח שוב מיד.