Zid Assistant
Overview
Zid Assistant is the WhatsApp, Instagram and web chat desk of a Zid store. Products, orders, abandoned carts and customers come in from Zid by themselves, and the assistant answers customers around the clock in their own language, on MonoChat's own AI models: there is no AI key to enter.
Shipping, returns and your own questions are answered only from the policies and questions you approve. Whenever a person is needed, the assistant hands the conversation over to your team or takes a message.
Highlights
- Products in the chat. Customers ask for a product, a size or a colour and get product cards with the photo, the price and Buy and Details buttons. Buy opens the product page in your Zid store.
- "Where is my order?" answered. The assistant finds the order by its number or the customer's phone and gives its status, the shipping company and the tracking link that Zid holds.
- Order updates. Customers are told when an order ships, is delivered or is cancelled, once for each change.
- Cash-on-delivery confirmation. A new order paid on delivery gets Confirm order and Cancel order buttons on WhatsApp. Your team sees the answer and changes the order in Zid; when nobody answers, your team gets a callback. Orders already confirmed in Zid are not asked again.
- Abandoned carts. Carts left at checkout in Zid get up to three reminders with the link back to the cart.
- Back in stock, returns and campaigns work as in Shop Assistant.
Connect Zid
Zid opens a store to an app through a private app that the store approves. Its tokens come from Zid Bridge, Zid's own tool for private apps, so you need no server of your own.
- In the Zid Partner Dashboard (
partners.zid.sa), open Apps › All Apps › Create Application and create a private app for your store named MonoChat. Give it read access to orders, products, customers, abandoned carts and store details. - Sign up at Zid Bridge (
bridge.zid.dev), register the app with its client ID and client secret (under API keys in the app's General settings), and put the redirect and callback URLs that Zid Bridge gives you into the app's settings. - Activate the app on your store and approve its permissions. If Zid asks for the Direct Integration (APIs) add-on, the store subscribes to it first. Zid Bridge then shows the tokens once: copy the Raw JSON.
- In MonoChat, open the Shop desk, go to Shop connection and choose Zid under Your web shop runs on.
- Enter the Client ID, the Client secret and the Redirect URL that Zid Bridge gave you, and paste the Raw JSON into Tokens from Zid Bridge.
- Click Test connection, then Sync now.
The client secret and the tokens stay on the server and are shown masked. Zid asks apps to renew their tokens on a schedule, so the app renews them every 10 months by itself; that is what the client secret and the redirect URL are for. If Zid no longer accepts the tokens (the app was deactivated or its permissions changed), the connection screen and the sync show a reconnect error: activate the app again through Zid Bridge and paste the new tokens. Zid Bridge keeps your app's client ID and client secret, not its tokens.
What comes from Zid
| Data | How often | What the app keeps |
|---|---|---|
| Orders | Every 10 minutes (adjustable under Sync every (minutes)) | Number, status, items, total, payment method, shipping company, tracking number and tracking link |
| Abandoned carts | Every 10 minutes | Customer, phone, items, total and the link back to the cart |
| Products | Every hour, and with every Sync now | Name, description, category, brand, photos, link, variants with price, sale price and stock |
| Customers | Once a day | Name, phone and email |
The first sync reads the orders of the last 30 days and the abandoned carts that reminders can still reach (7 days by default). The shop currency is filled in from the first order when it is empty. The sync stays within Zid's limit of 60 requests a minute.
- The app only reads from Zid; it writes nothing back. A cancellation or a status change is made by your team in Zid.
- Changes in Zid reach MonoChat with the next sync, not at once: the app does not receive Zid's webhooks yet.
- The owner, or a user with a custom role named manager, changes the settings, tests the Zid connection and loads or removes the sample data. Every agent works the desk and can start a sync.