Skip to main content

​
Introduction

Open Weather is a team of IT experts and data scientists practicing deep weather data science. For every point on the globe, OpenWeather provides historical, current, and forecasted weather data via fast APIs.

​
MoEngage and Open Weather

The MoEngage and Open Weather integration lets you enrich and personalize your marketing campaigns. You can fetch the user’s location and weather data on the fly and send personalized campaigns in real time. For example, an ecommerce brand can nudge users to buy:
  • Sunglasses, when the weather at the user’s location is sunny.
  • An umbrella, when there is a high likelihood of rain.
MoEngage push notification preview using personalized weather content

​
Integration

Prerequisites
  • An Open Weather account.
  • Access to your Open Weather API key. Contact your Open Weather account manager for a compatible API key. For more information, see Open Weather API.
  • You are tracking each user’s coordinates (latitude and longitude) as user attributes in MoEngage.

​
Available APIs

You can use the following Open Weather APIs within your MoEngage campaigns:
  1. Current weather data
  2. Hourly forecast — 4 days
  3. One Call API
  4. Daily forecast — 16 days
  5. Climate forecast — 30 days
  6. 5-day weather forecast
  7. Road risk API

​
Steps

The example below shows three message variants based on the current weather conditions at the user’s coordinates. We use the Current Weather API through MoEngage Content APIs to fetch the weather details.

​
Step 1: Add a Content API on MoEngage

  1. Navigate to Settings > Advanced settings > Content API. Click + Add content API in the upper-right corner of the Content API screen. MoEngage Content API screen with the Add content API button highlighted
  2. Add the Current Weather API details. API URL 
    https://api.openweathermap.org/data/2.5/weather?lat={{UserAttribute['latitude']}}&lon={{UserAttribute['longitude']}}&appid=<your open weather API key>
    Parameters Your parameters auto-populate. Update the values with personalized variables — type @ and select the variable. MoEngage parameter editor showing latitude and longitude mapped to user attributes
  3. Click Save.
  4. The Open Weather API now appears in your Content APIs list. MoEngage Content APIs list with the new Open Weather API listed
Click Test on the Content API to validate the response before using it in a campaign.

​
Step 2: Use the Content API in MoEngage campaigns

You can now use this Content API in your campaigns. For more information, see Content APIs.
  1. On step 2 of campaign creation, type @.
  2. In the personalization pop-up, select the Open Weather Content API you configured in Step 1. MoEngage personalization editor with the Open Weather Content API being inserted
  3. Use the MoEngage Templating Language to parse the API response and define your campaign content based on local weather. For example:
    • If local weather is Sunny → “Get a sunscreen”.
    • If local weather is Rain → “Get an umbrella”.
Sample API response: 
{
  "coord": {
    "lon": -122.08,
    "lat": 37.39
  },
  "weather": [
    {
      "id": 800,
      "main": "Clear",
      "description": "clear sky",
      "icon": "01d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 282.55,
    "feels_like": 281.86,
    "temp_min": 280.37,
    "temp_max": 284.26,
    "pressure": 1023,
    "humidity": 100
  },
  "visibility": 10000,
  "wind": {
    "speed": 1.5,
    "deg": 350
  },
  "clouds": {
    "all": 1
  },
  "dt": 1560350645,
  "sys": {
    "type": 1,
    "id": 5122,
    "message": 0.0139,
    "country": "US",
    "sunrise": 1560343627,
    "sunset": 1560396563
  },
  "timezone": -25200,
  "id": 420006353,
  "name": "Mountain View",
  "cod": 200
}
Print the output in the template, or use Personalized Previews to preview. If the API response returns Rain as the weather description, the user receives the push message “It’s raining. Get an umbrella”.