# Shopify WhatsApp App Setup & Documentation | Wazenta

> **Document Type**: Technical Setup Guide & API Reference  
> **Source URL**: https://wazenta.com/docs  
> **Markdown Source**: https://wazenta.com/docs.md  
> **App Version**: 1.3.36  
> **Compatibility**: Shopify Online Store 2.0 (All Themes)  
> **Author**: Wazenta Engineering Team  
> **Support**: wazentasupport@gmail.com  

---

## 1. Executive Overview

Wazenta is a modular conversion toolkit that connects Shopify storefront visitors with merchant sales and customer support teams directly on WhatsApp. 

Unlike legacy BSP (Business Solution Provider) integrations that charge $0.05 to $0.15 per conversation via the Meta Cloud API, Wazenta uses direct `wa.me` deep linking:
- **Zero API Per-Message Fees**: Unlimited conversations with customers without billing surcharges.
- **Theme Code Integrity**: 100% powered by Shopify Online Store 2.0 Theme App Embeds (`whatsapp-floating.liquid` and `whatsapp-button.liquid`). Zero liquid files are permanently modified or left behind upon app removal.
- **Sub-Second Performance**: Pure vanilla CSS and lightweight GPU-accelerated transforms ensuring INP < 200ms and CLS = 0.00.

---

## 2. 4-Step Installation & Quick Setup

### Step 1: Install & Authenticate
1. Add Wazenta from the Shopify App Store or via `https://wazenta.com/`.
2. Review and grant mandatory Shopify OAuth scopes:
   - `read_themes`, `write_themes` (for App Embed configuration)
   - `read_products` (for PDP prefill mapping)
   - Session storage managed via Prisma ORM.

### Step 2: Configure WhatsApp Numbers & Greeting
1. Open **Wazenta App Dashboard** in your Shopify Admin.
2. In **Widget Settings**, enter your primary business phone number including the country code (e.g., `+1` for USA, `+44` for UK, `+91` for India).
3. Set your custom greeting tooltip:
   > *"👋 Hi there! Have questions about sizing or delivery? Chat with us!"*
4. Choose button position: **Bottom-Right** (recommended) or **Bottom-Left**.

### Step 3: Activate Shopify Theme App Embed
1. Click the **Activate in Theme Editor** deep-link inside the Wazenta dashboard, or navigate to:
   `Shopify Admin -> Online Store -> Themes -> Customize -> App Embeds`.
2. Locate **Wazenta WhatsApp Widget** and toggle the switch to **ON**.
3. Click **Save** in the top right corner of the Shopify Theme Editor.

### Step 4: Configure Product Page (PDP) Button (Basic & Pro Plans)
1. In the Shopify Theme Editor, open any **Default Product** template.
2. Under **Product Information**, click **Add Block**.
3. Select **Wazenta WhatsApp Button**.
4. Drag and place it directly beneath the native **Add to Cart** or **Buy It Now** button.
5. Save changes.

---

## 3. Product Page Dynamic Variable Injection

When a shopper clicks the PDP WhatsApp button, Wazenta automatically pre-fills the message using dynamic Liquid attributes:

| Variable | Description | Example Output |
| :--- | :--- | :--- |
| `{{ product.title }}` | Exact title of current product | *Minimalist Leather Tote Bag* |
| `{{ current_variant.sku }}` | Active variant SKU | *SKU-LTB-BLK-01* |
| `{{ current_variant.title }}` | Selected color / size | *Black / Large* |
| `{{ canonical_url }}` | Direct link to the product | `https://store.com/products/leather-tote` |

### Default Customer Message Format:
```text
Hello! I am interested in purchasing {{ product.title }} (Variant: {{ current_variant.title }}, SKU: {{ current_variant.sku }}).
Product Link: {{ canonical_url }}
Do you have this in stock for immediate dispatch?
```

---

## 4. Multi-Agent Team Routing (Pro Plan)

Route customer chats based on user intent before opening WhatsApp:
- **Sales Specialists**: Pre-purchase sizing, bulk order discounts, specifications.
- **Customer Care**: Order status, tracking numbers, returns, and refunds.
- **Technical Support**: Troubleshooting, instructions, and compatibility.

### Agent Configuration Fields:
- Agent Name (e.g., *Sarah - Sizing Expert*)
- Direct WhatsApp Phone Number
- Online Status Indicator (`● Online`, `● Offline`, or `⚡ Away`)
- Custom Agent Welcome Message

---

## 5. Automated Interactive FAQ Widget

Pre-answer common questions directly inside the floating popup before a chat is initiated:
1. Shipping timelines and international delivery rates.
2. Return and exchange policies.
3. Accepted payment methods and COD (Cash on Delivery) availability.
4. Sizing charts and product care instructions.

If the answer doesn't satisfy the buyer, a 1-click **"Chat with Support"** button instantly connects them to a live human agent.

---

## 6. Official Resources
- Website: https://wazenta.com
- Pricing: https://wazenta.com/plans
- Public FAQ: https://wazenta.com/faq
- Partner Program: https://wazenta.com/partners
- Support Email: wazentasupport@gmail.com
