# Events

***

## Introduction

Events in marketing platforms represent specific actions performed either by the **customer** or a **stakeholder** during the customer’s purchase journey. These events serve as **data points** that enable businesses to draw meaningful insights about customer behavior and interactions, empowering them to trigger timely and relevant responses.

***

## Characteristics of Events

1. **Source of Data**: Events are streamed from various systems like:
   * **E-commerce platforms** (e.g., Shopify, Magento).
   * **Logistics partners** (e.g., FedEx, DHL).
   * **Third-party applications** (e.g., payment gateways, loyalty systems).
2. **Action-Oriented**: They are directly linked to an action performed by a user or a stakeholder, providing valuable insights into the customer journey.
3. **Dynamic and Real-Time**: Events are sent in real-time as **webhooks**, notifying the marketing platform instantly about a specific action or change.
4. **Event Data**: Each event contains associated details such as:
   * **Event type** (e.g., "Add to Cart").
   * **Timestamp**.
   * **Customer information** (e.g., name, email, purchase details).
   * **Action-specific details** (e.g., product IDs, order numbers).

Within LimeChat, events can be broadly Categorised into two types:

1. Shopify Events
2. Customer Events

***

## Shopify Events

To receive events from Shopify you do not have to do anything. When a brand downloads our app, they will automatically subscribe to the event webhooks from the Customer.

To add an event as a trigger, click on ‘Add a Trigger’ in the first node of an Automation Flow. Shopify Events are denoted with the Shopify Logo along with the event name.

![Screenshot 2024-12-16 at 4.08.04 AM.png](https://prod-files-secure.s3.us-west-2.amazonaws.com/7a099a4b-9d25-4c8c-8175-4ea980187a7e/c58fa256-94f9-4aa2-8f34-c1f995b5169f/Screenshot_2024-12-16_at_4.08.04_AM.png)

![Screenshot 2024-12-16 at 4.08.20 AM.png](https://prod-files-secure.s3.us-west-2.amazonaws.com/7a099a4b-9d25-4c8c-8175-4ea980187a7e/167e1e77-bb87-4124-ac75-9cd0875241de/Screenshot_2024-12-16_at_4.08.20_AM.png)

***

## Examples of Shopify Events

#### Examples of Shopify Events:

1. Shopify Checkout Create: Triggers when a checkout is created, majorly used for Abandoned Checkout Flows.
2. Shopify Checkout Update: Triggers when checkout details are updated.
3. Shopify Order Fulfilled: Triggered when an order is fulfilled, meaning the items have been shipped to the customer. It provides information about the fulfillment status, tracking numbers, and shipping details.
4. Shopify Customer Create: Triggers when a new customer account is created in the store. It provides details about the newly created customer, such as name, email address, and any additional information provided during account creation
5. Shopify Order Update: Triggers when an existing order is updated. It could include changes such as order status updates, adjustments to order details, or changes in shipping information
6. Shopify Order Create: Triggers when a new order is created in the store. It provides information about the newly created order, including details such as order number, customer information, and purchased items
7. Shopify Order Cancelled: Triggers when an order is cancelled, either by the customer or the merchant. It provides information about the cancelled order and the reason for cancellation, if available
8. Shopify Order Partially Fulfilled: Triggered when an order is split into multiple orders and an individual set of that order is fulfilled.

***

## FAQ's

<details>

<summary>What are events in marketing platforms?</summary>

Events are specific customer or stakeholder actions (e.g., adding a product to the cart, order fulfillment) that provide data for automated marketing actions.

</details>

<details>

<summary>How are events used in LimeChat?</summary>

Events are used to trigger automation flows, personalize customer interactions, and optimize engagement through real-time insights.

</details>

<details>

<summary>What details are included in an event?</summary>

Each event typically contains:

* **Event type** (e.g., "Order Fulfilled").
* **Timestamp** of the action.
* **Customer details** (e.g., name, email).
* **Action-specific data** (e.g., order number, product ID

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://limechatai.gitbook.io/limechat-product-guide/whatsapp-marketing/flows/events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
