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

# Connect Your Shopify or WooCommerce Store to Soneka

> Sync your Shopify or WooCommerce store with Soneka to automate order notifications, recover abandoned carts, and let customers browse and buy in WhatsApp.

Connecting your e-commerce store to Soneka turns WhatsApp into a full sales and support channel for your customers. Once synced, Soneka pulls in your orders, contacts, and product catalog, then lets you build automated flows for the moments that matter most — a customer abandons a cart, an order ships, or a buyer has a post-purchase question. Customers can browse your products, complete checkout, and pay without ever leaving WhatsApp.

## Install the Integration

<Tabs>
  <Tab title="Shopify">
    <Steps>
      <Step title="Find Soneka in the Shopify App Store">
        Go to the [Shopify App Store](https://apps.shopify.com) and search for **Soneka**. Click **Add app**.
      </Step>

      <Step title="Authorize OAuth Access">
        Shopify will display the list of permissions Soneka requests (orders, customers, products, webhooks). Click **Install app** to grant access and complete the OAuth handshake.
      </Step>

      <Step title="You're Redirected to Soneka">
        After install, you'll land in your Soneka dashboard with the Shopify connection active. Initial sync of your orders, contacts, and catalog begins automatically and typically completes within a few minutes.
      </Step>
    </Steps>
  </Tab>

  <Tab title="WooCommerce">
    <Steps>
      <Step title="Install the Soneka Plugin">
        In your WordPress admin, go to **Plugins → Add New** and search for **Soneka for WooCommerce**. Click **Install Now**, then **Activate**.
      </Step>

      <Step title="Connect via OAuth">
        Navigate to **WooCommerce → Settings → Soneka** and click **Connect to Soneka**. You'll be prompted to log in to your Soneka account and authorize the connection.
      </Step>

      <Step title="Initial Sync">
        Once authorized, Soneka registers order and customer webhooks on your WooCommerce store and pulls in your existing product catalog. The sync runs in the background — you'll see a progress indicator in **Soneka → Settings → Integrations → WooCommerce**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What Gets Synced

After a successful connection, the following data flows between your store and Soneka:

| Data                 | Direction      | Details                                                      |
| -------------------- | -------------- | ------------------------------------------------------------ |
| Orders               | Store → Soneka | New, updated, and cancelled orders in real time via webhooks |
| Customers / Contacts | Store → Soneka | Customer name, email, phone, and order history               |
| Product Catalog      | Store → Soneka | Title, price, images, variants, and inventory status         |
| Order Status Updates | Store → Soneka | Triggers for payment confirmed, shipped, delivered, refunded |

<Note>
  Contact phone numbers must be in E.164 format (e.g., `+447911123456`) to match against WhatsApp accounts. Soneka automatically normalizes numbers where country code information is available.
</Note>

## Automated Flows

Once your store is connected, you can activate pre-built flow templates or build custom ones in **Soneka → Flows**.

### Cart Abandonment Recovery

<Steps>
  <Step title="Enable the Template">
    Go to **Flows → Templates → Cart Abandonment** and click **Use Template**.
  </Step>

  <Step title="Set the Delay">
    Choose how long after abandonment Soneka waits before sending the first message (default: 1 hour). You can add follow-up messages at 24 hours and 72 hours.
  </Step>

  <Step title="Customize the Message">
    Edit the message copy and optionally include a direct checkout link. Soneka automatically inserts the customer's first name and a link to their specific cart.
  </Step>

  <Step title="Activate">
    Toggle the flow **On**. Soneka listens for the `checkout/create` webhook and fires the sequence automatically.
  </Step>
</Steps>

### Order Confirmations and Shipping Updates

Soneka ships with ready-made templates for:

* **Order Confirmed** — fires immediately after payment is captured.
* **Order Shipped** — fires when tracking information is added.
* **Out for Delivery** — fires when the carrier updates status.
* **Delivered** — fires on delivery confirmation, optionally followed by a review request.

Activate each template individually under **Flows → Templates → Order Lifecycle**. Each message includes the order number, item summary, and a link to the tracking page.

## Catalog Browsing in Chat

Soneka supports WhatsApp's native **Multi-Product Messages (MPM)** and **Single-Product Messages (SPM)**, powered by your synced catalog.

<Accordion title="Sending a product catalog in chat">
  In any conversation, click the **Catalog** icon in the message composer. Browse or search your synced products, select one or more items, and click **Send**. The customer receives an interactive product card with image, price, and an Add to Cart button — all inside WhatsApp.
</Accordion>

<Accordion title="Triggering catalog messages in flows">
  In the Flow builder, add a **Send Product** action and select up to 30 products (MPM) or 1 product (SPM). Use dynamic filters (e.g., "most viewed by this contact" or a specific collection) to personalize recommendations.
</Accordion>

<Tip>
  Keep your catalog in sync by enabling **Auto-sync** in **Settings → Integrations → Shopify / WooCommerce → Catalog Sync**. Soneka will re-pull catalog updates every 6 hours and whenever a product webhook fires.
</Tip>

## Checkout via Payment Links

Customers can complete purchases without leaving WhatsApp using embedded payment links.

<CardGroup cols={2}>
  <Card title="Razorpay" icon="indian-rupee-sign">
    Connect your Razorpay account under **Settings → Payments → Razorpay**. Soneka generates a short payment link for any cart or order and sends it in chat. Supports UPI, cards, net banking, and wallets.
  </Card>

  <Card title="Stripe" icon="stripe">
    Connect Stripe under **Settings → Payments → Stripe**. Soneka creates a Stripe Checkout session link and sends it to the customer. Supports cards and local payment methods based on your Stripe configuration.
  </Card>
</CardGroup>

Payment confirmations automatically update the order status in your Shopify or WooCommerce store and trigger the Order Confirmed flow in Soneka.

## Available Webhook Events

Soneka listens for the following store events and can trigger flows or notifications on any of them:

* `order/created` — new order placed
* `order/paid` — payment confirmed
* `order/fulfilled` — order shipped
* `order/cancelled` — order cancelled
* `order/refunded` — refund issued
* `checkout/create` — checkout started (cart abandonment trigger)
* `customer/create` — new customer registered
* `product/update` — product changed (catalog sync trigger)

You can view recent webhook deliveries and retry failed events in **Settings → Integrations → \[Store] → Webhook Logs**.