> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Airship

> Connect Airship to storekit to send push notifications, SMS, and in-app messages based on order events. Power lifecycle messaging and re-engagement campaigns.

Airship is a customer engagement platform for push notifications, SMS, and in-app messaging. The storekit integration sends customer and order data to power your messaging campaigns.

## Setup

1. Log in to your Airship account
2. Go to **Settings** → **Project Details**
3. Copy your **App Key** and **App Secret**
4. In storekit, go to **Settings** → **Integrations**
5. Enter your Airship credentials
6. Save changes

## Synced Data

When a customer places an order or submits feedback, the following data is sent to Airship:

### Customer Profile

| Field        | Description            |
| ------------ | ---------------------- |
| `email`      | Customer email address |
| `first_name` | First name             |
| `last_name`  | Last name              |
| `phone`      | Phone number           |

### Order Attributes

| Attribute          | Description              |
| ------------------ | ------------------------ |
| `order_count`      | Total orders placed      |
| `total_spent`      | Lifetime spend           |
| `last_order_date`  | Most recent order date   |
| `last_order_value` | Most recent order amount |
| `store_id`         | Store ID                 |
| `store_name`       | Store name               |

### Events

| Event             | Trigger                        |
| ----------------- | ------------------------------ |
| `order_placed`    | Customer completes an order    |
| `order_accepted`  | Order is accepted by the store |
| `order_ready`     | Order is ready for pickup      |
| `order_delivered` | Order is delivered             |

### Customer Feedback

When customers submit reviews, feedback is automatically synced to Airship with:

| Field       | Description                                            |
| ----------- | ------------------------------------------------------ |
| `type_id`   | Feedback sentiment (1=positive, 2=negative, 3=neutral) |
| `source_id` | Always set to 1 (website)                              |
| `unit_id`   | Your Airship unit ID                                   |
| `comments`  | Customer review text and additional ratings            |
| `ratings`   | Food rating, Service rating, and NPS score             |

**Rating Categories:**

* **Food** - Quality and taste rating (1-5 stars)
* **Service** - Staff and service rating (1-5 stars)
* **NPS** - Net Promoter Score calculated from overall rating (0-10 scale)
* **Atmosphere** - Included in comments section
* **Value for money** - Included in comments section

Feedback is classified as:

* **Positive** (type\_id: 1) - 4-5 star ratings
* **Negative** (type\_id: 2) - 1-2 star ratings
* **Neutral** (type\_id: 3) - 3 star ratings

<Note>
  Review data is synced in real-time when customers submit feedback. All rating categories are properly mapped to ensure accurate sentiment analysis in Airship.
</Note>

## Use Cases

### Order Updates

Send real-time push notifications for order status:

1. Create automation triggered by `order_accepted`
2. Send push: "Your order has been confirmed!"
3. Create automation for `order_ready`
4. Send push: "Your order is ready for pickup"

### Promotional Push

Drive orders with targeted push notifications:

1. Segment by `last_order_date` > 7 days
2. Send push with limited-time offer
3. Deep link to your ordering page

### Location-Based Messaging

For customers near your store:

1. Set up geofence around your location
2. Trigger message when customer enters zone
3. Promote lunch specials or happy hour

### Re-engagement

Win back lapsed customers:

1. Segment: no order in 30+ days
2. Send personalised push with offer
3. Follow up with email if no response

### Feedback-Based Campaigns

Respond to customer feedback automatically:

1. Segment by negative feedback (1-2 stars)
2. Send personalised apology with discount code
3. Track redemption to measure recovery

Or reward positive feedback:

1. Segment by positive feedback (4-5 stars)
2. Thank customers with loyalty points
3. Encourage them to share on social media

## Channel Priority

Configure which channels to use for different message types:

| Message Type  | Recommended Channel |
| ------------- | ------------------- |
| Order updates | Push notification   |
| Promotions    | Push + Email        |
| Surveys       | Email               |
| Urgent alerts | SMS                 |

## Related

<CardGroup cols={2}>
  <Card title="Customer Data" icon="users" href="/guides/marketing/customer-data">
    View and export customer data
  </Card>

  <Card title="Customer Feedback" icon="star" href="/guides/marketing/customer-feedback">
    Collect customer reviews
  </Card>
</CardGroup>