| What it does | Where to set it up |
|---|---|
| Answers customer questions automatically ("Is this product original?") | Connections → Hepsiburada channel |
| Answers "Where is my order?" with live order information (across all channels, including WhatsApp, web and phone) | Order sources → Hepsiburada |
Both use the values Hepsiburada gives you. The most common mistake: confusing the Developer Username that Hepsiburada expects in the User-Agent header with the Merchant ID. If these are mixed up, the connection returns 401.
Step 1 · Get the values Hepsiburada provides · 3 min
- Sign in to your Hepsiburada seller panel.
- Copy these three values somewhere safe:
- Merchant ID (username) — the Username (MerchantId) Hepsiburada provides.
- Secret Key (password) — the Password (SecretKey) Hepsiburada provides.
- Developer Username (User-Agent) — the User-Agent value Hepsiburada provides (e.g. example_company_dev).
These are your store's keys; do not share them by email or WhatsApp. YanıtLabs stores them encrypted and never shows them again.
Step 2 · Connect the Q&A channel · 3 min
Where to click: Left menu → Connections → + New connection → Hepsiburada.
What to enter: On the Hepsiburada connection screen that opens, fill in the fields:
| Panel field | What to enter |
|---|---|
| Merchant ID (username) | The Username (MerchantId) from Step 1 |
| Secret Key (password) | The Password (SecretKey) from Step 1 |
| Developer Username (User-Agent) | The User-Agent value from Step 1 (e.g. example_company_dev). Do not enter the Merchant ID. |
| Test environment | Production if you will query orders in your store. Choose Test store only if you are testing listings; order tracking cannot be verified in the test store. |
| Assistant to answer this channel | Choose your assistant |
First press Test connection — it tests without saving. Then press Connect and save keys.
What you should see: The "Connection saved" screen and the channel card showing Connected. Questions are checked every 3 minutes; new questions are answered automatically.
ℹ The test only reads your data; it changes nothing.
If you get stuck: If you get a 401, the most likely cause is entering the Merchant ID in the Developer Username field by mistake. Paste the values again with no leading or trailing spaces.
Step 3 · Turn on order tracking · 2 min
Where to click: Left menu → Order sources → New source at the top right.
What to enter: Platform = Hepsiburada. Fill in the fields:
| Panel field | What to enter |
|---|---|
| Source label (optional) | e.g. My Hepsiburada store |
| Merchant ID (Store ID) | The Store ID (Seller ID) under My Account in the Hepsiburada seller panel. It is not the integrator username. |
| Service Key | Copied from the "Service Key" link on your integrator row under My Integrators (the API password). |
| Integrator (User-Agent) | The integrator username Hepsiburada expects in the User-Agent header (e.g. example_integrator). It is not the Merchant ID or the Store ID. |
| Environment | Production (Test (SIT) is only for the test store) |
Press Save → Test connection.
What you should see: "Connection successful · HTTP 200 · N orders". The card shows "Connection test successful".
If you get stuck: Order tracking cannot be verified in the test store. Hepsiburada opens the test store only for listing tests; the order endpoint is not there. For real order tracking, use the Production environment and your production store's details.
Now when a customer gives an order number from any channel (WhatsApp, website, phone), the assistant states the order status and shipping information. The order number alone is enough. The assistant does not invent an order number or status.
If you get stuck
| Message you see | What it means / what to do |
|---|---|
| Authentication rejected (401): Merchant ID (username) or Secret Key does not match. | The values may be copied incorrectly. In particular, make sure the Developer Username does not contain the Merchant ID; trim leading and trailing spaces. |
| Authorisation denied (403): this identity is not allowed to query orders. | The identity has no order-query permission; check with Hepsiburada. |
| Merchant ID, Secret Key and Developer Username are all required. | Fill in all three fields. |
| Fill in the required fields first. | Complete the required fields before testing. |
| Order tracking does not work in the test store | The test store is for listings only; choose Production for orders. |
| Connection could not be established. | Check the values and try again. |
| The channel card shows Credentials not entered | The channel exists but the keys were not saved; open the channel and enter the keys. |
| Questions are not being answered | Wait 3 minutes. If there is still nothing, check the Inbox: answers held by the rule check are waiting for you there. |
Checklist
- Get the Hepsiburada credentials
- Connect the Q&A channel
- Enable order tracking
The source of this guide had 2 screenshots; they were not moved to the new site. The text is preserved; images will be added in a separate step.