Overview

OpenWeather provides fast and elegant access to weather forecasts, nowcasts, and historical data globally. This enables businesses to integrate with CleverTap for targeted campaigns. CleverTap and OpenWeather integration allows you to fetch the user's location and weather updates in real time and send personalized campaigns to your users. For instance, retail companies can send localized notifications recommending weather-appropriate products such as umbrellas during rainy seasons. This document is a comprehensive guide for integrating OpenWeather with CleverTap.

Prerequisites

You must have the following for this integration:

• An OpenWeather account
• API key for OpenWeather. To get the API, contact your OpenWeather account manager.
• A CleverTap account

📘

Note

Ensure that you are tracking user coordinates (latitude and longitude) as user attributes on CleverTap.

Integrate CleverTap with OpenWeather

This process involves the following three major steps:

1. Get the API key from OpenWeather.
2. Set Up CleverTap dashboard.

Get API Key from OpenWeather

You need to generate an API key from the OpenWeather dashboard to integrate with CleverTap:

1. Log in to your OpenWeather dashboard.
2. Select My API Keys from the dropdown list from your account. You can also select the API keys tab directly.
3. Enter your API key name under the Create Key field and click Generate. OpenWeather also creates a default API key when you log in to the dashboard for the first time.

Set Up CleverTap Dashboard

To set up CleverTap dashboard:

1. Go to Settings > Setup > Linked Content and click + Linked Content.

2. Enter the following details:

3. (Optional) Click Test Linked Content to ensure that the Linked Content is set up correctly.
4. Fill in the required mapping according to your requirements, or click Auto-fill Objects with Responses. Once you do this, click Test & Save changes to proceed with the campaign creation.

Here is an example of the response:

{
  "coord": {
    "lon": -94.04,
    "lat": 33.33
  },
  "weather": [
    {
      "id": 803,
      "main": "Clouds",
      "description": "broken clouds",
      "icon": "04d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 305.36,
    "feels_like": 311.36,
    "temp_min": 303.15,
    "temp_max": 305.36,
    "pressure": 1014,
    "humidity": 62,
    "sea_level": 1014,
    "grnd_level": 1003
  },
  "visibility": 10000,
  "wind": {
    "speed": 1.54,
    "deg": 340
  },
  "clouds": {
    "all": 75
  },
  "dt": 1720188172,
  "sys": {
    "type": 1,
    "id": 6094,
    "country": "US",
    "sunrise": 1720177934,
    "sunset": 1720229345
  },
  "timezone": -18000,
  "id": 4736096,
  "name": "Texarkana",
  "cod": 200
}

Create a Campaign on CleverTap

Once you set up the Linked Content on CleverTap, you can now run personalized campaigns from the CleverTap dashboard. OpenWeather will be available in Push, SMS, Email, WhatsApp, Web Push, and Webhook campaigns. In our case, the retail company wants to send a personalized email campaign recommending weather-appropriate products such as umbrellas during rainy seasons and so on. To do so:

1. Go to Campaigns and click + Campaigns.
2. Select Emails from the list of messaging channels.
3. Click Go To Editor from the What section and select Email with Rich Media template to create an email campaign.
4. Click the icon and select the Linked Content tab.
5. Slect the API you configured while setting up the Linked Content on the CleverTap dashboard.
6. Map the API Parameters to attributes in the users' profile and click Apply.

7. Create the campaign message using the Linked Content as shown in the following image:

{% if Linked.OpenWeather-Demo.weather[0].main == "Clouds"%}
  Hey! it looks cloudy, are you ready for the monsoons? Avail 50% off on all monsoon gear.
{% else %}
   Avail early bird discounts on all monsoon gear.
{% endif %}

8. Define all the campaign sections and click Publish. You can also send a test campaign before publishing it to a broader audience.