# Apple News messages

An Apple News message is a push notification that links to an Apple News story and is delivered via the Apple News app on iOS and macOS.

Apple News is available to select publishers. See [Publishing on Apple News](https://developer.apple.com/news-publisher/). If you are interested in sending Apple News messages, [contact Airship Sales](https://www.airship.com/contact-us/).

## Appearance and behavior

An Apple News message appears in the same banner format as a push notification. When creating the message, you will enter the text that will appear in the notification. Clicking or tapping the notification opens its associated story in the News app on iOS or macOS. Apple News messages are displayed upon receipt and are not [Persistent](https://www.airship.com/docs/reference/glossary/#persistent).

![Apple News messages](https://www.airship.com/docs/images/content-apple-news_hu_a2bcb6d2631aa2ea.webp)

## Configure the Apple News channel

To configure the channel for your project, you will need your Apple News Publisher:

* Channel ID
* API key
* API key secret

You can find the channel ID and API key in the Settings tab in [News Publisher](https://www.icloud.com/newspublisher/). The API key secret is shown only when it is first issued.

In Airship:

1. Next to your project name, select the dropdown menu (
), then **Settings**.
1. Under **Channels**, select **Apple News**. 
1. Enter a channel name and your News Publisher channel ID, API key, and API key secret. The Apple News channel name is used for preview purposes in the Airship dashboard.
1. Check the box for each of the supported countries you have configured in your News Publisher channel settings.
1. Click **Save**.

 > **Note:** * Your News Publisher channel ID has no relation to an Airship [Channel ID](https://www.airship.com/docs/reference/glossary/#channel_id).
> *  We validate the country selection when you click **Send Now** or **Send When Live** as the final step in creating an Apple News message. If a country selected here is not configured in your News Publisher channel settings, you will see an error in the dashboard when attempting to send to that country.


## Create an Apple News message

Send a push notification that links to an Apple News story:

1. Select the **Create** dropdown menu (
), then **Apple News**.

1. Enter the push notification text you want to accompany the Apple News story, limited to 130 characters. The preview updates as you compose your message. The *Channel Name* entered when [setting up the channel](#configure-the-apple-news-channel) appears in bold.
   ![Apple News messages](https://www.airship.com/docs/images/compose-apple-news_hu_471f97b970e27fc2.webp)

1. Click **Select a story** and select from the list. Story information displayed:

   * **Title**
   * **Share URL:** If the story has a canonical URL, it is displayed here
   instead of the share URL.
   * **Status:** Only *Live* or *Processing* stories may be selected. If an
   article is processing, the message will be sent when processing is
   complete. A story that was retracted cannot be selected.

1. (Optional) Select recipient countries. Available countries are dependent on the selections made when [setting up the channel in Airship](#configure-the-apple-news-channel), not necessarily the countries you have configured with Apple.
   
   Select *Choose*, then choose from the *Select a country* menu. Repeat for additional countries.

1. Confirm the message appearance and content in the preview.

1. Click **Send Now**. If the selected story is still processing, the button will instead be labeled **Send When Live**.

> **Note:** We validate the country selection when **Send Now** is clicked. If a country selected here is not configured in your Apple News publisher channel settings, you will see the error "Country not available" when attempting to send to that country.
> 
> To edit country selection:
> 
> 1. Next to your project name, select the dropdown menu (
> ), then **Settings**.
> 1. Under **Channels**, select **Apple News**.
> 1. Under **Supported Countries**, edit your selections.
> 1. Select **Save**.
> 
> See [Configure Apple News](#configure-the-apple-news-channel).


## View Apple News history

Go to **Messages**, then **Apple News**. One year of Apple News history is listed, newest first.

The table displays the message text, Apple News story title, recipient countries, and the date, time, and time zone when the composer steps were completed by clicking **Send Now**/**Send When Live**. Hover over the story title to see its canonical URL, or click to follow the link.

![Apple News messages](https://www.airship.com/docs/images/messages-apple-news_hu_b23d08cd7ea6781d.webp)

> **Note:** * After sending an Apple News notification, a delivery request is sent to Apple. Because Airship does not manage the delivery process, the *Send Requested* date and time may differ from the actual delivery date and time.
> * Projects that have been inactive for over 30 days will have all message history removed.