HELP DOCUMENTATION


Magento Extension for Zoho Desk

Ecommerce has become a requisite for all business categories. Every online business owner looks for a sophisticated ecommerce solution that offers a blend of scalability, flexibility, and extensibility. Magento is one of the best choice for ecommerce store. In addition, you have the flexibility and ease to customize your online store according to your brand at a fast pace.

It also offers product, category, inventory and order management, process payments, promotion & marketing tools for your store.It is the perfect CMS for web store that offer complete ecommerce solution.


Objective of the Integration

Our extension allows you to seamlessly integrate between your Magento store with ZohoDesk account in a jiffy through eWidget and get the particular customer's order details & view it inside the Tickets and Customers without navigating to the Magento account.

By using our extension helps your support agents to proactively reach out to your customers to find out their problems with the order and win them back where possible.


Key features of these Integration:

  • View your customer's order,payment,shipment and the rest of their details (including price, quantity, and notes) without leaving the Zoho Desk interface.
  • Real-time single direction synchronization of your Magento store orders,payment & shipment data into Zoho Desk.
  • Any changes in Magento store order status will automatically update the same status in our extension.
  • Map navigation for billing and shipping address right from the Zoho Desk.
  • You can add comments to orders and shipments through our extension; these comments will also be reflected in Magento.
  • You can also add the order details and shipment details in the "Reply All" template through our extension in Zoho Desk.

Installing the Extension in Zoho Desk

End users of the ZohoDesk can view and install the published public extension in two ways:

If the Zoho Desk administrator installs an extension from the Setup page, the extension is made available to users in the current portal. On the other hand, if the administrator tries to install the extension from the Marketplace site, a list of all the available portals appears, letting the admin choose the one in which the extension must be installed.


Setting up the Zoho Desk & Magento Integration:

Getting the Magento Integration tokens and Access token:

Use the following steps to generate an access token:

  1. Login into ADMIN URL and click System > Extensions > Integrations to display the Integrations page.




  2. Click Add New Integration to open the New Integration page.


  3. Enter a unique name for the integration in the Name field. Then enter your admin password in the Your Password field. Leave all other fields blank.

  4. Click the API tab. Select the Magento resources the integration can access. You can select all resources, or select a custom list.


  5. Click Save to save your changes and return to the Integrations page.
  6. Click the Activate link in the grid that corresponds to the newly-created integration.


  7. Click the Allow button to get the integration details page.

Refer: https://devdocs.Magento.com/guides/v2.4/get-started/authentication/gs-authentication-token.html

Granting OAuth Access for Extension Connection in Magento Admin Panel

Follow these steps to grant OAuth access :

Note : To ensure visibility of orders in our eWidget, OAuth access needs to be granted in Magento for accessing order details.

Note : If OAuth access is already enabled, there is no need to follow the steps below.

  1. Navigate to the Magento Admin panel. In the sidebar, locate and click on the STORES option. This action will open a side panel. Within the side panel, you'll find the Settings section. Click on Configuration under this section, and it will navigate you to Configuration tab.



  2. In the configuration tab, scroll down the page until you find the SERVICES option. Click on it, and a dropdown will appear. Within this dropdown, locate and click on the OAuth option. This action will open the OAuth tab



  3. In the OAuth tab, locate the Consumer Settings option. You'll find several options displayed there. Among them, find the Allow OAuth Access Tokens to be used as standalone Bearer tokens setting.

  4. If it's set to No you need to change it to Yes. If it's already set to Yes there's no need to make any changes. You can then proceed with the rest of the help documentation.


  5. after set the yes click the save config your changes


Authentication:

  1. Select departments and profile whose agents can access the extension.



  2. Click install button to initiate the authentication process.



  3. Click on the "Connections" tab and before You authorize the Magento You need to authorize Zoho OAuth after that You Can authorize the Magento by clicking on the "Authorize" button. This will initiate the authorization process.



  4. In the Zoho Desk help document, we previously mention obtaining a Magento access token. Please follow these steps to acquire an access token from Magento and paste it into the required field in Zoho Desk Click here.

  5. Note : Before you paste a access token need to add a bearer.

    Example : bearer<"Space"><"Your Access Token">

  6. Once you authorize a Magento Store connection, you need to provide a Magento Store URL in the Configuration tab on the Extension Settings page.

  7. Enter the Domain name of your Magento Store.
  8. Example 1: In Store Url :https://example.com/magento/
    Domain Name : example.com/magento

    Example 2 :In Store Url :https://sample.com/
    Domain Name : sample.com



  9. Protocol will remain the same; you must mention https.

  10. To get the store URl,follow these steps:


  11. Go to the Magento Admin Panel. Click on "STORE" in the sidebar of the Magento Admin panel.


  12. Click the Settings > Configuration in Side Panel.



  13. Go to General > Web page.



  14. You can see your Base URL as mentioned in the screenshot. Copy and use it for the DomainName and protocol.



  15. It's Mandatory to enter your store domain's protocol(ex: https).

  16. After filling the details,click the save button to connect your store with Zoho Desk.



Enable Magento Integration via eWidget

  1. Once the authorization process is completed successfully, you can view the Magento order details in the Tickets and Customers modules in the Zoho Desk. The order details include the customer's name, order date, order number, total amount, and order status. You can also view the customer's contact information, including notes and attachments.
  2. Note : The order details are retrieved based on email IDs from Magento. Therefore, before checking the order details in the Tickets/Customers modules, you need to ensure that the order's email ID-based customers and Tickets are created in Zoho Desk. If they do not exist, you have to create them manually.

  3. Tickets or Customer records can be accessed according to your preferences. Tickets have an email address, which needs to be the same on Magento.
  4. In Ticket Module



    In Contact Module



    Note: WE have added a feature - Global Email search. With this feature, you can search for Magento order details within Zoho Desk based on the customer's email address in Magento. With the Global Email Search, you can also find order details for any Customer's email address in Magento, which is not available in Zoho Desk.


  5. To view order details from the Magento store within Zoho Desk's Tickets or Customers record, click on the Zoho desk eWidget icon on the right pane and select Desk Ticket Widget from the app menu.

  6. Our extension shows all Magento orders associated with the customer within the Zoho Desk Ticket. The order details can also be found within the corresponding Customer record.

  7. In Ticket Module



    In Customer Module



  8. To view the order details in detail, simply click on the corresponding order to view the entire order details.

  9. In Ticket Module



    In Customer Module



  10. On the Orders Details page within eWidget, you can take a glance at the order details.

  11. In Ticket Module



    In Customer Module



  12. If the Ticket Email Not Same as magento Mail,It display "No Order Fount of this particular Mail".

  13. In Ticket Module



    In Customer Module




Orders Tab:

1.You can view the customers’ Magento orders detail along with date, status, comments, payment details, billing and shipping address within corresponding ticket record in Zoho Desk.The same information is also available in Zoho Desk's Customer record.


Items Tab:

1.You can view the order item details including product ordered, quantity orders, total price of each item, number of items shipped, Grand Total, Subtotal, Tax, and discount within the corresponding ticket record in Zoho Desk. The same information is also available in Zoho Desk's Customer record.


Shipments Tab:

1. You can view the shipment details along with the tracking number, carrier, and shipment comments within the corresponding ticket record in Zoho Desk. The same information is also available in Zoho Desk's Customer record.


No Shipping Details

Note: If there is no shipment information available for the order in Magento, there will be no information available here.


No Tracking Details

Note: If You Didn't add Tracking Details of that Shipment there will be no tracking information available in our extension.


Features of this Extension

Filter:

1. we can Apply the Filter Based on Displayed Order List,we will use to apply filter based on Order id, Date and Status.


2. You Can Filter Out the Order by Clicking the Filter Icon.


3. if you will click the Filter Icon,It will Open the Modal then Enter the OrderID Or Status and Date Then Click Filter Button.


4. Once You Click Filter Button,It will Display the Filtered Orders.


5. You Can Remove Filtered Orders by Clicking the Clear Filter Icon.


Note: If you enter wrong details in the filter box,it displays "No Order Found For this Provided Filter Criteria".



Pin The Order:

1. A specific order can be pinned by clicking the Pin button.


2. When you view the ticket in the widget again it will show that the order has been pinned.


Note : You can pin only one order per customer based ticket and You cannot use this map function in the Customer module.


Reply Mail

1. You can share order details via email by clicking the Reply button.


2. Once You Click Reply Button, It Will add Orders Details on the Mail.


3. You can remove that order Details from mail by clicking Trash icon.

4. You can also share Shipment details via email by clicking the Reply button on Shipment Tab.


5. Once You Click Reply Button, It Will add Shipment Details on the Mail.


6. You can remove that shipment Details from mail by clicking Trash icon.

Note :You cannot use this Reply functionality in the Customer module.


Add Order Comments

1. You can add comments to your order by clicking the +Add button on Order Details Tab.


2. After clicking that button, it will display the Order Comments dialog box,and enter the Order comment then click Post.


3. Once Post,It Will Show the Popup to "Comments Added successfully".


4. You can see the comment of that order in your Magento store.


Add Shipment Comments

1. You can also add shipment comments to your Shipment by clicking the Comment button on Shipment tab.


2. After clicking on that comment button it will show Shipment comment dialog box, enter the Comment and click Post.


3. Once Post,It Will Show the Popup to "Shipment Comments Added successfully".


4. You can see the Shipment comment of that order in your Magento store.


Uninstall the Extenstion

Contact us

Need any Help in Installing the Extension?

Contact us