מודל החיוב בארה"ב

מסמך זה מתאר את מודל החיוב עבור תעבורת RCS לעסקים אצל ספקים אמריקאים.

סקירה כללית של סיווגי חיוב בארה"ב

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

  • הודעה עשירה (דו-כיוונית)
  • הודעת מדיה עשירה (דו-כיוונית)

ניתן לשלב מספר סוגים של הודעות לסשן אחד. למידע נוסף על סשנים, ראה חיוב סשנים (פיילוט) .

עיין בסעיפים הבאים לקבלת מפרטים מפורטים.

הערה על טרמינולוגיה

כדי לתאר את כיוון תעבורת המסרים, ספקי שירותי תקשורת בארה"ב משתמשים בדרך כלל בטרמינולוגיה של MT/MO. מונחים אלה תואמים לטרמינולוגיה של A2P/P2A המשמשת בכל תיעוד RCS for Business:

  • MT (Mobile Terminated) הוא A2P (Application-to-Person) : הודעה שנשלחת על ידי העסק.
  • MO (מובייל מקורו) הוא P2A (אדם לאפליקציה) : הודעה או פעולה שיזום המשתמש.

חיוב אירועים בין סוכן לאדם (A2P/MT)

סעיף זה מכסה את לוגיקת החיוב עבור הודעות שנשלחו על ידי סוכן (כלומר, הודעות A2P או MT).

הודעות עשירות (A2P)

הודעה מסווגת כהודעה עשירה אם היא מכילה רק שילוב של האלמנטים הבאים:

לוגיקת חיוב עבור הודעות עשירות

הודעה עשירה מחויבת על סמך פלחים.

  • גודל מקטע : מקטע אחד = 160 בתים של טקסט מקודד UTF-8.
  • חישוב : אורך ההודעה הכולל בפורמט UTF-8 בייט מחולק ב-160 ותמיד מעוגל כלפי מעלה למספר השלם הקרוב ביותר.
  • אי הכללות : נתוני הטקסט והפוסט החוזר בתוך תשובות או פעולות מוצעות אינם כלולים בספירת הפלחים.
  • דוגמה : הודעת טקסט בגודל 300 בייט מכילה 2 מקטעים (300 / 160 = 1.875, מעוגל כלפי מעלה ל-2).

ספירת בתים

חלק מתווי יוניקוד (כמו אמוג'י או אותיות עם הטעמה) הם מרובי בייטים, כך שספירת הבייטים הכוללת של UTF עשויה להיות שונה מספירת התווים.

כדי לבדוק את ספירת הבייטים המדויקת של הודעה, הקלד או הדבק אותה למטה.

הודעות מדיה עשירה (A2P)

הודעה מסווגת כהודעת מדיה עשירה אם היא מכילה לפחות אחד מהבאים:

לוגיקת חיוב עבור הודעות מדיה עשירה

הודעת מדיה עשירה מחויבת כאירוע יחיד בתעריף קבוע.

  • החיוב זהה ללא קשר לאורך הטקסט, מספר הכרטיסים או גודל קובץ המדיה.
  • פילוח אינו חל.

דוגמאות לתגובת API של A2P

דוגמאות אלה מציגות את השדה richMessageClassification בתגובת קריאה מוצלחת של RBM API עבור הודעות שנשלחו על ידי הסוכן.

דוגמה לתגובת API עבור RICH_MESSAGE 

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 5
  }
}

דוגמה לתגובת API עבור RICH_MEDIA_MESSAGE 

{
  "name": "...",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "contentMessage": {
     ...
  },
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

חיוב אירועים מאדם לסוכן (P2A/MO)

סעיף זה מכסה חיוב עבור הודעות ופעולות שיזם משתמש (כלומר, הודעות P2A או MO).

הודעות עשירות (P2A)

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

לוגיקת חיוב : חיוב על סמך פלחים. לפרטים על חישובי ספירת פלחים ראו לוגיקת חיוב עבור הודעות עשירות .

הודעות מדיה עשירה (P2A)

הודעה מסווגת כהודעת מדיה עשירה אם היא מכילה קובץ שהועלה (תמונה, וידאו, אודיו).

לוגיקת חיוב : מחויב כאירוע יחיד בתעריף קבוע. פילוח אינו חל.

קליקים לפעולה מוצעת

לחיצה של משתמש על כל פעולה מוצעת יוצרת אירוע לחיוב אחד הנקרא לחיצה על פעולה מוצעת. (פעולות מוצעות עשויות לכלול מזהה נתוני פוסט-בחזור במטען ההודעה.)

לוגיקת חיוב : יוצר אירוע לחיוב אחד לכל קליק.

מקרה מיוחד: שיתוף מיקום

שיתוף איתור ייחודי בכך שהוא יוצר שני אירועי חיוב נפרדים של P2A:

דוגמאות לתגובת P2A Webhook

דוגמאות אלה מציגות את השדה richMessageClassification ב-webhooks שנשלחו לסוכן עבור אירועים ביוזמת המשתמש.

דוגמה ל-webhook עבור RICH_MESSAGE שנשלח על ידי משתמש 

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "text": "Hello, world!",
  "richMessageClassification": {
    "classificationType": "RICH_MESSAGE",
    "segmentCount": 1
  }
}

דוגמה ל-webhook עבור RICH_MEDIA_MESSAGE שנשלח על ידי משתמש 

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2025-05-22T20:03:35.474764Z",
  "userFile": "...",
  "payload": "...",
  "richMessageClassification": {
    "classificationType": "RICH_MEDIA_MESSAGE"
  }
}

דוגמה ל-webhook עבור SUGGESTED_ACTION_CLICK 

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "suggestionResponse": {
        "text": "Click here",
        "postbackData": "...",
        "type": "ACTION"
    },
    "richMessageClassification": {
        "classificationType": "SUGGESTED_ACTION_CLICK"
    }
}

דוגמה ל-webhook עבור הודעת מיקום

זהו האירוע השני לחיוב בתהליך שיתוף מיקום , שנשלח לאחר שהמשתמש משתף את מיקומו מהמפה.

{
    "agentId": "...",
    "senderPhoneNumber": "...",
    "messageId": "...",
    "sendTime": "...",
    "location": {
      "latitude": 37.422000,
      "longitude": -122.084056
    },
    "richMessageClassification": {
        "classificationType": "RICH_MESSAGE",
        "segmentCount": 1
    }
}

חיוב סשן (פיילוט)

בעוד שמודל החיוב הקיים בארה"ב גובה תשלום עבור הודעות בודדות, פיילוט החיוב של סשנים מציג דרך לקבץ שיחות שלמות בין משתמש למותג ו/או בין מותג למשתמש לאירוע לחיוב יחיד: p2a_session או a2p_session .

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

הערות טכניות ויישום

  • פלחים מיועדים למטרות חיוב בלבד : הודעות ארוכות מועברות כיחידה אחת למכשיר המשתמש. ספירת הפלחים היא חישוב וירטואלי למטרות חיוב; היא אינה משפיעה על אופן מסירת ההודעות או הצגתן למשתמש.
  • סיווג אוטומטי : סיווג ההודעות הוא אוטומטי לחלוטין בהתבסס על תוכן ההודעה ואינו ניתן לעקיפה ידנית.
  • פריסה : מודל החיוב בארה"ב הופעל בפלטפורמת RCS for Business ב-15 ביולי 2025. מתאריך זה ואילך, הדיווחים ותגובות ה-API של גוגל משקפים את הסיווגים החדשים.