מה זה קריאות API לפייסבוק?
קריאת הAPI לפייסבוק מאפשרת לנו לשלוח הודעה מתוך הבוט שלנו לצורך שליחת הודעה ללקוח.
כאן תמצאו פירוט על הקריאות הקיימות והאפשרויות שפייסבוק נותנת.
מה צריך כדי לקרוא לפייסבוק?
- מספר בתוך החשבונות וואטסאפ שאומת ע"י SMS או הודעה קולית – ממנו נשלחות ההודעות.
- ACCESS_TOKEN פעיל – איתו מזדהים בפני פייסבוק כדי שהקריאה תאושר, (על יצירת Token ניתן לראות כאן)
שימו לב: שכשקוראים לפייסבוק מתוך ChatRace אין צורך בToken, הToken נשלח ע"י ChatRace
- מספר טלפון ID – ממנו שולחים את ההודעה, ניתן לקבל את המזהה באזור meta for developers
מבנה הקריאה
נתונים קבועים לכל קריאה
(במקרה של קריאה מתוך ChatRace אין צורך לצרף את הנתונים הקבועים)
כתובת השרת:
https://graph.facebook.com/v18.0/מספר_טלפון_ID/messages
headers – כותרות
“Authorization”: “Bearer ACCESS_TOKEN”
“Content-Type”: “application/json”
body – גוף הקריאה
“to”: “PHONE_NUMBER”
“messaging_product”: “whatsapp”
נתונים משתנים
כאן נביא לכם את מבנה הJSON שצריך לצרף בכל קריאה לפי סוג ההודעה שאתם רוצים לשלוח.
שימו לב! במקרה ואתם לא עושים את הקריאה מתוך ChatRace יש להכניס בקריאה גם את הנתונים הקבועים
שליחת הודעת טקסט
הודעה זו היא הודעת טקסט פשוטה
{
"recipient_type": "individual",
"type": "text",
"text": {
"preview_url": false,
"body": "MESSAGE_CONTENT"
}
}
preview_url מגדיר אם להציג תצוגה מקדימה של אתר במקרה של שליחת הודעה עם URL
דוגמא להודעה עם תצוגה מקדימה:
שליחת מדיה
נדרש מדיה ID, שמקבלים אחרי העלאה של קובץ
ניתן לראות כאן, איך מעלים מדיה
{
"recipient_type": "individual",
"type": "image",
"image": {
"id" : "MEDIA-OBJECT-ID"
}
}
שליחת תגובת אימוג'י להודעה
מגיב באימוג'י להודעה
דוגמא להודעה עם תגובת אימוג'י "\u2764\ufe0f" (לב אדום)
יש צורך לספק את הID של ההודעה שמתקבלת בWebhook
וכן קוד אימוג'י (ניתן לקבל פה קוד אימוג'י)
{
"recipient_type": "individual",
"type": "reaction",
"reaction": {
"message_id": "wamid.HBgLM...",
"emoji": "\uD83D\uDE00"
}
}
שליחת מיקום
שולח מיקום בוואטסאפ
יש לספק קווי אורך ורוחב
{
"type": "location",
"location": {
"longitude": LONG_NUMBER,
"latitude": LAT_NUMBER,
"name": LOCATION_NAME,
"address": LOCATION_ADDRESS
}
}
שליחת כרטיס איש קשר
שולח איש קשר
אין חובה במילוי כל הפרטים על האיש קשר, אך מומלץ לא לשלוח נתונים ריקים כלומר, פרמטר שאתם לא משתמשים בו תמחקו.
{
"type": "contacts",
"contacts": [{
"addresses": [{
"street": "STREET",
"city": "CITY",
"state": "STATE",
"zip": "ZIP",
"country": "COUNTRY",
"country_code": "COUNTRY_CODE",
"type": "HOME"
},
{
"street": "STREET",
"city": "CITY",
"state": "STATE",
"zip": "ZIP",
"country": "COUNTRY",
"country_code": "COUNTRY_CODE",
"type": "WORK"
}],
"birthday": "YEAR_MONTH_DAY",
"emails": [{
"email": "EMAIL",
"type": "WORK"
},
{
"email": "EMAIL",
"type": "HOME"
}],
"name": {
"formatted_name": "NAME",
"first_name": "FIRST_NAME",
"last_name": "LAST_NAME",
"middle_name": "MIDDLE_NAME",
"suffix": "SUFFIX",
"prefix": "PREFIX"
},
"org": {
"company": "COMPANY",
"department": "DEPARTMENT",
"title": "TITLE"
},
"phones": [{
"phone": "PHONE_NUMBER",
"type": "HOME"
},
{
"phone": "PHONE_NUMBER",
"type": "WORK",
"wa_id": "PHONE_OR_WA_ID"
}],
"urls": [{
"url": "URL",
"type": "WORK"
},
{
"url": "URL",
"type": "HOME"
}]
}]
}
קריאה מתוך ChatRace
על מנת לבצע קריאות API לפייסבוק ישירות מתוך ChatRace יש לפעול לפי ההוראות הבאות
- יש להוסיף action של קריאה חיצונית
- להכניס בURL את המילה "echo"
- להגדיר את סוג הקריאה כPOST
- להכניס בBody את הJSON של ההודעה אותה אתם רוצים לשלוח כפי שפורט למעלה
אין צורך להכניס פרמטר "to" ההודעה תישלח ללקוח הספציפי שאיתו מתנהלת השיחה
