DO.EWS.03 Info

An alert is a collection of information that EWS can share with SP System to take anticipatory actions.

The Info object shall contain descriptive elements aligned with the Common Alerting Protocol (CAP) v1.2. This ensures semantic interoperability and consistent interpretation of alert messages across systems.

Normative Reference: OASIS Common Alerting Protocol (CAP) v1.2 https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2.html

Attribute	Type	Cardinality	Description
language	CD.COM.14: language_code	0...1	Unique identifier of the alert message
category	CD.EWS.01 category	1...1	Hazard or event type (e.g., MET, GEO).
event	DT.COM.02 string	1...1	The type of the subject event of the alert message
reponse_type	CD.EWS.08 response_type	0...1	The type of action recommended for the target audience
urgency	CD.EWS.06 urgency	0...1	Timeframe for response (e.g., Immediate, Expected).
severity	CD.EWS.02 alert_severity	0...1	Severity level (e.g., Extreme, Severe, Moderate, Minor).
certainty	CD.EWS.07 certainty	0...1	Likelihood of occurrence (e.g., Observed, Likely, Possible).
audience	DT.COM.02 string	0...1	The text describing the intended audience of the alert message
effective	DF.COM.STRING.01 date_time	0...1	Time when the alert becomes effective.
event_code	DT.COM.02 string	0...1	A system-specific code identifying the event type of the alert message
onset	DF.COM.STRING.01 date_time	0...1	The expected time of the beginning of the subject event of the alert message
expires	DF.COM.STRING.01 date_time	0...1	Expiration time of the alert.
sender_name	DT.COM.02 string	0...1	The text naming the originator of the alert message
headline	DT.COM.02 string	0...1	Brief summary of the alert.
description	DT.COM.02 string	0...1	Detailed description of the event and its potential impact.
instruction	DT.COM.02 string	0...1	Recommended protective actions.
web	DT.COM.02 string	0...1	A full, absolute URI for an HTML page or other text resource with additional or reference information regarding this alert.
contact	DT.COM.02 string	0...1	The text describing the contact for follow-up and confirmation of the alert message
parameter	DT.COM.02 string	0...1	A system-specific additional parameter associated with the alert message
area	DO.COM.07 Place	0...*	the area impacted by the hazard
resource	DO.EWS.04 Resource	0...*	to send message in different format like video, audio or image
created_at	DF.COM.STRING.01 date_time	0...1	The date of the creation of the alert

        {
          "language": "en-US",
          "category": [
            "Met"
          ],
          "event": "Flash Flood",
          "responseType": [
            "Prepare"
          ],
          "urgency": "Immediate",
          "severity": "Severe",
          "certainty": "Likely",

          "headline": "Flash Flood Warning",
          "description": "Heavy rainfall may cause flash flooding.",
          "instruction": "Move to higher ground.",

          "effective": "2026-06-22T10:00:00Z",
          "expires": "2026-06-22T18:00:00Z",

          "area": [
            {
              "areaDesc": "Bekaa Governorate",

              "polygon": [
                "33.85,35.45 33.95,35.45 33.95,35.55 33.85,35.55 33.85,35.45"
              ],

              "geocode": [
                {
                  "valueName": "ADMIN_CODE",
                  "value": "LB-BI"
                }
              ]
            },
            {
              "areaDesc": "Baalbek District",

              "geocode": [
                {
                  "valueName": "SPMIS_DISTRICT_ID",
                  "value": "DISTRICT_101"
                }
              ]
            }
          ]
        }
      
  

To note, if the SP MS is triggering an SMS or notification :

1- Screen-Reader and Text-to-Speech (TTS) Optimization: When a Social Protection system triggers an SMS or digital notification, the text is often processed by assistive technologies. EWS must ensure that the text payloads in the Info object (DO.EWS.03) are optimized for these tools.

2- Pronunciation & Phonetics: Avoid abbreviations. For example, instead of "Evac via HWY 9", the instruction field must read "Evacuate via Highway 9".

3- Sequential Information: The instruction field must prioritize the most critical action in the very first sentence so screen-reader users do not have to listen to a lengthy meteorological description before learning what action to take.