- Register or log in with the customer’s email address.
- Complete Bot Settings and business details.
- Add at least one visible product.
- Choose a WhatsApp connection method.
- Use Test Bot before speaking to real customers.
Help Centre
How can we help?
Clear answers for setting up products, AI replies, WhatsApp, orders, payments and customer conversations.
Quick start
Add your business
Complete contact, payment and policy details.
Add products
Save accurate prices, stock, descriptions and photos.
Set the AI
Choose languages, tone, reply length and instructions.
Connect & test
Connect WhatsApp, then send a real customer-style question.
All help topics
Use the dashboard Test Bot for quick checks, then test the connected WhatsApp number before going live. Ask natural questions such as “How much is Netflix?”, “What sizes do you have?” and “Can I see a photo?”
Select New chat when you want to clear the current conversation context. This does not reset the AI quota.
Open the customer dashboard and find Chatbot Control. The switch must show On before the chatbot can answer customers.
- Turn Chatbot Control on.
- Confirm at least one product shows the green Visible status.
- Confirm the WhatsApp connection shows Connected.
- Check that the current time is inside the saved business hours.
- Save any changes, then send a new test message.
Add a clear name, unique SKU, category, description, exact price and stock quantity. Add sizes, colours or service duration inside the description when relevant.
- Turn on Visible so the bot can use the product.
- Product images can be up to 2 MB.
- Never place hidden instructions inside product descriptions.
Only products with the green Visible status are shared with the chatbot. This protects draft, private or unfinished products from being shown to customers.
- Open Inventory in the customer dashboard.
- Find the required product and check the Status column.
- If it is hidden, select Edit, turn on Visible, and save the product.
- Confirm the product row now shows the green Visible label.
- Start a new test chat and ask about that product by name.
Save the product again and confirm it is visible. New product data should be used immediately, even when a previous chat remembers an older value.
Customer Feedback lets the business owner save genuine review photos and send them when a customer asks for reviews, feedback, proof or customer photos.
- Open Customer Feedback in the dashboard.
- Select the related product so the chatbot knows which feedback belongs to it.
- Upload a JPG, JPEG or PNG image up to 2 MB.
- Add a short, honest caption and turn on Visible.
- Save the feedback photo.
- When a customer asks for reviews, the chatbot selects visible feedback for the product being discussed.
- The photo is sent directly as WhatsApp media, followed by a short caption—not as a web link.
It reviews the products and descriptions saved in the dashboard, then drafts professional bot instructions for that business. Review the draft before saving it.
The bot supports English, Sinhala, Singlish, Tamil and Tanglish. With language set to Auto, it replies in the customer’s language and writing style, including mixed-language messages.
Product and brand names can remain in their original language.
Choose Friendly, Formal, Casual or Sales-focused tone. Reply length can be Short, Normal or Detailed.
Allow occasional emojis means the AI may use a suitable emoji when natural; it does not force an emoji into every reply.
The bot sends your saved away message instead of running the AI. Away messages do not consume AI replies. The default timezone is Asia/Colombo, and overnight schedules such as 18:00–02:00 are supported.
Open Bot Settings and complete Business Details, Payment Details, Contact Details, Delivery Policy and Return Policy. Save the settings, then start a new test chat.
Connect with QR is the quickest option. A private session is created only after you choose QR, and you scan the code with WhatsApp.
WhatsApp Business API is Meta’s official business connection and is better for approved, scalable use. It requires Meta app details, a phone-number ID, business-account ID, access token and webhook setup.
- Confirm QR is the selected connection method.
- Select Create or Reconnect Session.
- Wait for the QR code, then scan it from WhatsApp → Linked devices.
- Keep the page open until the status shows Connected.
If it still fails, contact the administrator and include the customer email and the time of the connection attempt.
- Open Meta for Developers and select your app.
- From the left menu, open WhatsApp → API Setup.
- Select the correct business portfolio and WhatsApp phone number.
- Copy the value shown under Phone number ID.
- Copy the value shown under WhatsApp Business Account ID. It may also be labelled WABA ID.
- Paste both values into CodzeeyAI → WhatsApp → WhatsApp Business API and save.
- Open Meta Business Settings → Users → System users.
- Select Add, enter a name such as “CodzeeyAI WhatsApp”, and choose the Admin system-user role.
- Select the system user, choose Assign assets, and give it access to your Meta app and WhatsApp account.
- Select Generate new token and choose your Meta app.
- Select Never for token expiration when Meta offers that option.
- Enable whatsapp_business_messaging and whatsapp_business_management. Add business_management if Meta requires it for your assigned business assets.
- Generate the token, copy it once, paste it into CodzeeyAI and save.
- Open Meta for Developers and select the same app used for WhatsApp.
- Open App settings → Basic.
- Find App secret and select Show.
- Confirm your Facebook password or two-factor authentication if requested.
- Copy the secret, paste it into CodzeeyAI and save.
You do not get these values from Meta. CodzeeyAI supplies the Callback URL and the matching Verify Token.
- In the CodzeeyAI customer dashboard, open WhatsApp → WhatsApp Business API → Webhook Setup.
- Copy the displayed Callback URL. It must start with https://.
- Copy the displayed Verify Token. If CodzeeyAI asks you to create one, use a private random value of at least 32 characters and save it before continuing.
- Open your app in Meta for Developers.
- Open WhatsApp → Configuration and select Edit beside Webhook.
- Paste the CodzeeyAI Callback URL and the exact same Verify Token, then select Verify and save.
- After the webhook is verified, stay on WhatsApp → Configuration.
- Under Webhook fields, find messages.
- Select Subscribe. The status must show Subscribed.
- Return to CodzeeyAI and confirm the connection details are saved.
- Send a message from a different WhatsApp number to your connected business number.
The typing indicator must finish before the message is sent. Ask the administrator to confirm the typing delay continues to the final reply step.
- Test first with typing delay switched off.
- Use 1–3 seconds for a natural delay.
- Confirm the AI generated a reply before the typing indicator starts.
Turn on Allow chatbot orders. The bot collects the selected product, quantity and the fields you require, then asks the customer to confirm before saving the order.
For physical products you can request name, phone and address. For digital products, use Custom Fields to request only email and WhatsApp number. Cash on delivery is a separate optional switch and is off by default.
Ask for the same order ID, email address or WhatsApp number saved with the order. The lookup node must query the customer’s own orders table and return a clear status.
When enabled, a receipt image is saved as Pending and the owner is notified. An administrator or owner reviews it and selects Approve or Reject. The bot then sends one status message.
Use the message ID as a unique key so the same receipt cannot create repeated records or repeated replies.
Customer Leads creates a simple follow-up list from people who show interest in a product or service. It helps the business owner find potential buyers without reading every conversation again.
When Lead Capture is on, the system can save the customer’s available name, WhatsApp number, interested product, conversation source, latest enquiry and the date of contact. It can classify buying intent as:
- Hot: asks about purchasing, payment, delivery or availability.
- Warm: asks detailed product questions but has not confirmed a purchase.
- Cold: makes a general enquiry with little buying intent.
The owner can open Customer Leads in the dashboard, filter the list, read the saved interest and follow up personally. Updating a lead’s status does not automatically place an order.
When the customer asks for a person, repeatedly gets stuck, makes a complaint or the AI has low confidence, the chat is marked Paused. The owner receives the transcript and collected details, and the bot stops replying until the owner resumes it.
Human Handoff is off by default for new customers.
Ad Campaign Replies give customers an immediate, product-specific answer after they click a Facebook, Instagram or WhatsApp advertisement. This prevents the chatbot from replying with unrelated information or the complete product catalogue.
- Open Ad Campaign Replies in the dashboard.
- Enter a clear campaign name and select the channel: Facebook, Instagram or WhatsApp.
- Add the expected opening question or phrase—for example, “I need more information about the Netflix offer.”
- Select the related visible product.
- Write the preferred welcome reply and save the campaign rule.
- Test by sending the same opening message shown in the advertisement.
When a new message matches the saved campaign phrase, the chatbot uses the campaign welcome reply and continues the conversation using the selected product’s current price, description, stock and image.
The Setup Wizard shows the essential steps needed before real customers use the chatbot.
- Open Setup Wizard from the customer dashboard.
- Add accurate products, prices, descriptions, stock and images.
- Select Generate Auto-fill with AI, review the Bot Instructions and save them.
- Complete reply style, business, payment and automation settings.
- Choose a WhatsApp connection method and finish the connection.
- Use Test Bot with real customer-style questions before going live.
Free access is designed for initial setup and testing. It includes:
- 20 Test Bot replies
- 20 WhatsApp AI replies
- Up to 3 products and 3 product images
- Up to 2 Ad Campaign Replies
- 1 successful Auto-fill with AI generation
- Up to 3 payment-receipt submissions
The dashboard displays the remaining reply balances and shows an upgrade notice when a free limit is reached.
A package is applied automatically after its WooCommerce order reaches Completed. Processing, On hold, Pending payment and Cancelled orders do not activate package allowances.
When another eligible package is completed, its WhatsApp replies and Test Bot replies are added to the remaining paid balances. Its validity days extend the current active validity period.
Open Overview. The highlighted Current Plan card shows your plan name, WhatsApp AI replies remaining, Test Bot replies remaining, progress and package status.
Auto-fill usage is shown separately under Bot Settings → Assistant, because instruction generation and customer replies have separate allowances.
Select Refresh in the dashboard header to reload the latest products, stock, reply balances, orders, payment receipts, leads, handoffs, WhatsApp status and saved settings.
Use it after changing an order, approving a receipt, completing a package purchase or updating data from another browser tab.
Open Bot Diagnostic to check whether the main customer-chatbot requirements are ready. It reviews configuration such as products, bot settings, connection state and recent recorded errors.
- Open Bot Diagnostic.
- Read each check and its status.
- Correct the item named in the message.
- Select Check again.
Open Products & Stock to search by product name or SKU and filter by visibility.
- Duplicate: creates a copy that can be edited as a new product.
- Sample CSV: downloads the correct import columns.
- Export CSV: downloads products without image files.
- Import CSV: previews up to 1,000 rows from a file up to 2 MB. Matching SKUs are updated; new SKUs are inserted.
Open Data Export to download a CodzeeyAI JSON file containing supported product details and your Bot Instructions.
- Select Download JSON + Bot Instructions.
- Keep the downloaded file private.
- On the destination account, open Data Export.
- Select the CodzeeyAI JSON file and confirm the import.
Products with the same SKU are updated and new SKUs are added within the account’s product limit.
Auto-fill reviews visible products, their descriptions and saved business details, then drafts professional Bot Instructions.
- Free accounts receive 1 successful generation.
- Paid accounts receive 5 included successful generations unless the administrator sets another package allowance.
- After the included paid generations are used, each confirmed generation uses 50 WhatsApp AI replies.
- The dashboard shows the remaining Auto-fill allowance before generation.
Ad Campaign Replies send a prepared response when a customer enters from a Facebook, Instagram or WhatsApp campaign. The saved target reply is sent directly and does not use an AI reply.
- Open Ad Replies and select Add campaign reply.
- Enter the campaign name and platform.
- Paste the customer starter message from the advertisement.
- Add the exact target reply and optionally link a visible product.
- Keep the rule Active and save it.
A linked product can send its saved image with the reply.
- Smart exact match: recommended for normal campaigns. It tolerates harmless spacing and punctuation differences while keeping the match focused.
- Message contains this text: broader matching for a distinctive phrase. Avoid short, common words.
- Alternative customer messages: add one realistic variation per line when an advertisement may send different starter messages.
- Meta ad source: available for WhatsApp Business API when Meta supplies a matching source ID or source URL.
Open WhatsApp Messages to review saved conversations belonging to your own customer account. It helps you understand recent customer questions, bot replies and conversation context.
Messages are separated by customer chat and cannot be viewed by another customer. Administrators may access retained conversations only for support and service management.
Each confirmed chatbot order receives one unique six-digit public order number. If one checkout contains several products, all items remain under that single order number.
The customer can use the order number when asking about the order, and the owner can search for it under Orders.
Open Bot Settings → Automation → Completed-order WhatsApp notification.
- Turn on Send completion message.
- Choose whether to include the six-digit order number.
- Edit the completion message and save the settings.
- Open Orders and mark a chatbot order as Completed.
The system sends the message once to the WhatsApp number saved with that chatbot order.
Yes. When payment-receipt verification is enabled, customers can submit JPG, JPEG, PNG, WebP or PDF receipt files up to 5 MB through WhatsApp.
The secure receipt processor reads available receipt details and stores the submission as Pending. The owner must inspect the original receipt and select Approve or Reject.
Uploaded payment-receipt files are retained for a maximum of 20 days. After that period, the receipt file is permanently deleted by the scheduled cleanup process.
The retention notice is shown in the customer dashboard so owners know how long the file is available for review.
Open Bot Settings → Automation → Human handoff. Choose a repeated-message limit from 1 to 10, add the notification contacts and customer message, then enable the feature and save.
When handoff is triggered, only that customer chat is paused. Reply to the person directly, then open Handoffs and select Resume bot when the issue is resolved.
The floating Support button opens CodzeeyAI’s help assistant. It explains dashboard features, gives short setup steps and searches the latest published website and Help Centre information.
Public visitors can ask general questions. A logged-in customer can also receive guidance based on safe account status, current dashboard configuration and their own recent WooCommerce orders.
Account-specific answers are available only after you log in. The support assistant can use the safe account information supplied by the dashboard, including plan status, reply balances, workflow status, selected WhatsApp method and recent WooCommerce order dates and statuses.
If you are logged out, it will ask you to log in before discussing private account, order, payment, workflow or balance information.
Logged-in customers can attach a JPG, PNG or WebP dashboard screenshot up to 2 MB. Add a short explanation so the support assistant can identify the visible error and recommend the safest next step.
If the support service is temporarily unavailable, the chat shows a clear retry option instead of repeatedly sending the same request. Wait briefly, then select Retry once.
Conversation memory helps the bot understand short follow-ups such as “yes”, “what about the price?” or “show that product”. Current products, prices, stock and settings always take priority over older conversation text.
Website Support uses recent history only to understand the current support conversation. Logged-in and public sessions are kept separate, and public temporary support memory expires automatically.
Customer records are separated by account. Product and review images, private API credentials, access tokens, chat history and automation workflow details are excluded from customer JSON exports.
Never place passwords, OTPs, card security codes or private tokens inside product descriptions, Bot Instructions, support messages or screenshots.
Open Bot Settings → Assistant and complete the fields in this order:
- Enter the assistant name customers should see.
- Select Auto-detect or a preferred reply language.
- Add a short welcome message.
- Add a helpful fallback message.
- Review or generate the Bot Instructions.
- Turn on Chatbot enabled.
- Select Save settings.
After saving, open Test Bot, start a New chat and test a greeting, product question, payment question and unavailable-information question.
Use a short professional assistant name connected to your business. Do not use a person’s name unless customers are allowed to believe that person is replying.
Select Auto-detect when customers may use English, Sinhala, Singlish, Tamil, Tanglish or mixed messages. Select English, Sinhala or Tamil only when you want that language to be preferred until a customer explicitly requests another supported language.
Product and brand names may remain in their original language.
Welcome message: the opening message shown when a new conversation starts. Keep it friendly and explain what the assistant can help with.
Fallback message: used when the requested information is not saved or cannot be answered safely. It should direct the customer to the correct contact method without pretending to know the answer.
Do not place changing prices, passwords, access tokens or long product lists inside either message.
Bot Instructions describe how the assistant should represent your business. Include the business purpose, important sales rules, service boundaries, delivery or activation process, and when a person should take over.
Keep product names, prices, stock and specifications in Products & Stock so the bot always receives the current saved data. Keep bank and contact information in their dedicated Business and Payments fields.
Never include passwords, OTPs, private API tokens, card security codes or instructions asking the bot to ignore safety rules.
- Select Save settings.
- Select the dashboard Refresh button.
- Open Test Bot and select New chat.
- Test the changed setting with a realistic customer message.
- Send one test from a different WhatsApp number before advertising the bot.
New chat resets conversation context only. It does not restore used Test Bot or WhatsApp AI replies.
Open Bot Settings → Reply Style.
- Select the tone that matches your business.
- Select Short, Normal or Detailed reply length.
- Turn occasional emojis on or off.
- Save the settings.
- Start a New chat in Test Bot and ask the same question again.
The latest saved Reply Style overrides an older tone, length or emoji preference remembered in a conversation.
- Friendly: warm and professional for most online shops.
- Formal: more reserved wording for professional or regulated services.
- Casual: relaxed language for informal brands and younger audiences.
- Sales-focused: concise benefit-led replies for active product enquiries without inventing urgency or claims.
The tone changes presentation only. It does not allow the bot to invent products, prices, stock or policies.
Short is best for quick WhatsApp conversations. Normal adds enough explanation for common questions. Detailed is useful when customers need setup or policy guidance.
When occasional emojis are enabled, the assistant may use one suitable emoji when natural. It should not decorate every line. When the switch is off, replies should contain no emojis.
Open Bot Settings → Active Hours.
- Turn on the Active Hours schedule.
- Select the business timezone. Asia/Colombo is recommended for Sri Lankan businesses.
- Enable each working day.
- Enter the opening and closing time for that day.
- Disable days when the business is closed all day.
- Write the away message and save.
The dashboard status shows whether the bot is Active now or in Away mode.
An overnight range is supported when the closing time is earlier than the opening time. For example, 18:00 to 02:00 means the business remains active from 6:00 PM until 2:00 AM the next day.
For a closed day, turn that day off instead of entering identical opening and closing times. Always check the selected timezone before testing.
Outside the saved Active Hours, the customer receives the saved away message instead of an AI-generated sales reply. The away message should state when the team will return and provide an urgent contact method only when appropriate.
Away replies do not consume the customer’s AI reply allowance because the AI is not run.
Open Bot Settings → Business and enter only information customers are allowed to receive:
- Business name
- Contact phone number
- WhatsApp number
- Contact email
- Business address, when customers may visit
- Official website
- Written business hours or support availability
Save the settings and test each field by asking a direct customer-style question.
The assistant uses the saved Business fields when a customer asks how to contact the business, where it is located, which website is official or when the team is available.
It should answer only with the relevant requested field. It should not display every business detail in every reply or invent a missing address, email or phone number.
- Use the correct international phone format when WhatsApp delivery requires it.
- Check spelling in the business name and email address.
- Use the public customer-service address, not a private home address.
- Confirm the website uses HTTPS and opens without a login when it is public.
- Remove old details after a contact method changes.
Open Bot Settings → Payments.
- List the payment methods you currently accept.
- Add the bank name, branch, account name and account number exactly as supplied by the bank.
- Add short payment instructions, including the reference the customer should use.
- Save the settings.
- Start a New chat and ask for payment details.
Remove a payment method immediately when it is no longer available.
The chatbot shares saved payment information only when the customer asks about payment, bank transfer, deposit or checkout, or when payment is required to continue a confirmed order.
It should reproduce saved account names and numbers exactly. If a required payment field is empty, it should use the fallback message instead of guessing.
Place each item on a separate line: payment method, bank name, branch, account name, account number and payment reference instructions. Check every digit before saving.
Never save card PINs, card security codes, OTPs, online-banking passwords, private access tokens or another customer’s receipt information in the Payments tab.
Bot Settings → Automation controls Human Handoff, chatbot order taking, cash on delivery, custom order details, completed-order messages, payment-receipt verification, lead capture, WhatsApp quick choices and the typing indicator.
Enable only the features your business is ready to manage. Save settings after every change and test one feature at a time.
- Open Bot Settings → Automation → Human Handoff.
- Add the notification email and optional owner WhatsApp number.
- Write the customer handoff message.
- Select a repeated-message limit from 1 to 10.
- Enable automatic Human Handoff and save.
When triggered, only that chat pauses. After helping the customer directly, open Handoffs and select Resume bot.
Turn on Allow chatbot orders. Product and quantity are always required.
For physical products, collect customer name, delivery address, WhatsApp number and payment method as needed. For digital products, enable Custom Order Details and select only the required fields, such as email and WhatsApp number.
Enable cash on delivery only when the business genuinely offers COD. Stock is reduced only after the customer explicitly confirms a complete order.
- Open the Completed-order WhatsApp notification area.
- Enable Send completion message.
- Choose whether to include the six-digit order number.
- Edit the message and keep the available placeholders unchanged.
- Save the settings.
The message is sent once when a chatbot order is marked Completed. It does not apply to unrelated WooCommerce orders.
- Enable Accept payment receipt files.
- Edit the receipt received, approval and rejection messages.
- Save the settings.
- Send a test JPG or PDF receipt from WhatsApp.
- Open Payment Receipts and review the Pending record.
- Verify it with the bank or payment provider, then select Approve or Reject.
Receipt text extraction never approves a payment automatically.
Enable automatic Lead Capture and save. When a customer shows product interest, the system can save the available WhatsApp contact, interested product, intent level and a short useful note.
Open Leads to search contacts and review Hot, Warm or Cold opportunities. The owner can update each lead to Active, Won or Closed. Lead Capture does not create an order automatically.
- Enable WhatsApp Quick Choices.
- Write one short menu question.
- Add between 2 and 5 clear choices.
- Save the settings.
- Test with a greeting or menu request from WhatsApp.
The chatbot uses the exact saved wording only when a menu helps the conversation. Ordinary product answers should not repeat the menu continuously.
Enable the WhatsApp typing indicator, select a short delay and save. A delay of 1 to 3 seconds normally feels natural.
The typing indicator is a WhatsApp delivery feature and may not appear in Test Bot. If typing stops without a reply, switch the feature off, test the normal reply, then enable it again with a shorter delay and contact support if the issue continues.
Try fewer words or select All topics.
Need technical support?
Send a clear description with the customer email, connection method, time of the test and the exact message shown. Never include passwords or private tokens.