Browse sections

Connect your Tjar store

Link your Tjar store with its domain and API key, so your team sees each customer's orders in the conversation and your website chat appears on your store.

On this page

When you connect your Tjar store to Hadir Chat, your agents see the customer's orders inside the conversation and can change their status from there, you can show your website chat on every page of your store, and you can send your customers automatic notifications about their orders. You connect with the store's domain and the API key from your Tjar dashboard, and there is nothing to paste back into Tjar afterwards.

Before you start

  • You are an Administrator in Hadir Chat, or your role has the permission “Connect and manage the store integrations, and which channel reads from which store”.
  • You can open your store's Tjar dashboard and copy its API key.
  • Your plan has room for another store, if you already have one connected. The store count covers Salla, Zid, EasyOrders, Tjar and IAppCloud together, and an extra store is 10 USD a month on any plan.
  • Egypt plans do not include Tjar. On them you can connect EasyOrders or IAppCloud, or move to the international plan.

Copy the API key from Tjar

  1. Open your store's Tjar dashboard.
  2. Go to General Settings, then Developers.
  3. Copy the API key.

Connect the store

  1. In the inbox, open Settings, then Integrations.
  2. On the Tjar card, select Configure.
  3. Under Link your Tjar store, enter the Store domain as it shows in the browser, such as mystore.tjar.sa.
  4. Paste the key into API key.
  5. Select Link store. You see “Store linked.” and the store appears on the page.

Hadir Chat checks the key before it saves anything, then registers on your store the webhook that new orders arrive through. The key is never shown on the page again.

Note: a store links to one workspace only. If you see “This store is linked to another workspace. Unlink it there first.”, unlink it there and try again. If you see “You have reached the number of stores your plan allows.”, add a store for 10 USD a month from the button next to it, unlink another store, or move to a bigger plan.

Connection status

Under the store's name you see one of these:

  • Linked, waiting for the store's first event: the link is done, and no order or update has come from the store yet.
  • Linked: everything works.
  • Tjar rejected the key: the key may have changed in Tjar. Select Link again and paste the new key from General Settings, then Developers.
  • Not linked: you unlinked it, and Hadir Chat receives nothing from the store.

Below the status you see “We receive everything new from the store.” when the webhook is registered. If we could not register it, you see a warning saying so: Tjar allows two webhooks per store, so delete one you do not need on Tjar's Developers page, then select Try again. New secret asks Tjar for a new webhook secret and saves it, with nothing for you to copy.

Chat channel on your store

An administrator can show one website channel's chat window on every page of your store:

  1. On the store's card, under Chat channel on your store, choose one of your website channels, Create a new website channel, or No chat to hide it.
  2. You see “Chat channel saved.”.

The chat appears on your store once the Hadir Chat app is active in Tjar. A new channel counts toward your plan's channels. If your store has its own domain besides the Tjar one, select Edit next to Other store domains and add it, so the chat appears there too.

Orders in the conversation

In the contact panel beside the conversation, a Tjar orders section lists the customer's orders whose phone number or email matches theirs:

  • A summary, such as “3 orders, worth …, 1 of them cancelled or returned”.
  • For each order: its number, status, total and items.
  • If your store sent the customer digital codes, you see “Digital codes sent on …” with the date. The codes themselves are never shown.
  • Refresh asks the store for the customer's orders again.

From the same section an agent can change an order's status, such as confirming or cancelling it, if their role allows it. See Order actions and Agent permissions on orders.

Customer notifications

If your subscription includes customer notifications, you find the Customer notifications section at the bottom of the store's card. On Tjar you can switch on New order, Order status changed, Ask for a review and Abandoned basket. See Customer notifications.

Rename

Select Rename on the store's card, type a name your team sees, then select Save.

  1. On the store's card, select Unlink.
  2. Confirm with Unlink in the dialog. The store's orders stop arriving, your website chat leaves it at once, and the API key is deleted. Conversations and contacts stay as they are.

The store stays on the page as Not linked. To connect it again, select Link again: the domain is filled in for you, and you paste a new API key from Tjar.

Was this helpful?

Thanks for your feedback ✓

Please don't include personal details

We got your note and will review the article with it in mind.

To see how this site uses cookies, read our Privacy Policy