מערכת פידבוט מאפשרת שליחה דרך API באמצעות Webhooks פשוטים.
חברתנו מציגה פתרון API מלא, המאפשר לכם לחבר את מערכת ה-CRM שלכם (לדוגמה), ולייצר טריגרים פשוטים שיגיעו ללקוחיתכם באופן ישיר ואישי בואטספ.
אופן ההתממשקות הוא קל ופשוט.
נתחיל. ראשית, יש לשלוח בקשת POST לכתבות הבאה:
https://addnewmessages-bmb77ejh3a-uc.a.run.app
ה- Headers צריכים להכיל את הערכים הבאים:
הtoken הוא מזהה ייחודי שיספוק למשתמש לאחר רכישת רישיון הפרימיום
1) Key: Content-Type , Value: application/json
2) Key: 'auth' , Value:{token}
לאחר מכן, יש להעתיק את המבנה מטה ל-Body.
בדוגמה הבאה, הבקשה תבצע שליחה למספר הבא: 972586666644 עם המלל " Hello world".
יש לשים לב, שהמספר חייב לכלול את קידומת המדינה (בישראל הקידמות היא 972).
{ "token":"XXXXX", "messages":[
{ "message":"Hello world", "phone":"972586666644", "invalidationTime":"1685662968767",
"imagePath":"https://cdn.pixabay.com/photo/2015/04/23/22/00/tree-736885_1280.jpg", }
] }
יצויין, כי ה- Body צריך להיות מסוג raw.
הערות ומושגים:
- Token הוא המזהה הייחודי שמתקבל ביחד עם התקנת התוכנה.
- Messages הוא מערך של אובייקטים שמכיל את ההודעות אותן נרצה שהתוכנה תמשוך. מבנה כל אובייקט במערך יכיל:
- message – טקסט ההודעה.
- phone – מספר הטלפון שאליו תשלח ההודעה.
- invalidationTime (אופציונלי) – אפשרות להגדיר תוקף לשליחת ההודעה, במידה והתוקף עבר ההודעה לא תשלח. (אמור להיות אובייקט מסוג TimeStamp).
- imagePath (אופציונלי) – אפשרות לצרף תמונה להודעה, הערך שצריך לשלוח הינו קישור לתמונה.
- בתוכנה יש לבחור את האופציה "מצב שרת" , ההודעות הקיימות בשרת ימשכו לתוכנה ובאופן אוטומטי תתחיל שליחת ההודעות.
הודעות שגיאה אפשריות וטיפול בהן:
MISSING_PARAMS (2)
USER_NOT_AUTHORIZED (99)