README

Provides API integrations with the RobinHQ platform / dashboards

Installation

Prerequisites

• Magento 2.4.4 or higher
• PHP 8.0 or higher

Install package using composer

composer require emico/magento-2-robinhq

Run installers

php bin/magento setup:upgrade

Dynamic API

This module provides 5 endpoints for the RobinHQ dynamic API integration. This endpoints are called directly from within the RobinHQ dashboard, providing the latest up to date information from Magento.

The following endpoints are available:

• /robinhq/api/customer?email=$EmailAddress
• /robinhq/api/customerOrders?email=$EmailAddress
• /robinhq/api/order?orderNumber=$Id
• /robinhq/api/search?searchTerm=$Expression
• /robinhq/api/lifetime?email=$Email

Those are accessible from the root of your magento domain. http://my.shop.nl/robinhq/api/customer

To enable the dynamic API functionality you have to enable it in the configuration.

Stores -> Configuration -> Emico -> RobinHQ -> Enable dynamic API

Authentication

The authentication of the dynamic API is done by a pre shared key which must be communicated to RobinHQ.

You can define an API key and secret in the RobinHQ configuration.

When issueing requests to the dynamic API endpoint you have to include a Basic authentication header. The value you have to sent is a base64-encoding of {apiKey}:{apiSecret}.

For example you have set up API key to abc and API secret to def. The value would be base64(abc:def), which resolves to YWJjOmRlZg==. The full authorization header is: Authorization: Basic YWJjOmRlZg==

Customize panelview and detailview

Some endpoints provide the possibility to provide custom data in the Robin dashboards.

For example when retrieving customer details using /robinhq/api/customer the following payload is returned.

{
    "naam": "Robin Doe",
    ...
    "panel_view": {
        "street": "Lovinklaan 1",
        ...
        "my_customfield1": "234",
        "loyalty_card_number": "1265645456"
    }
}

You can simply add custom attributes to these views in the configuration. Stores -> Configuration -> Emico -> RobinHQ -> Custom Attributes section.

When you need even more control or implement your own bussiness logic you can implement the interfaces DetailViewProviderInterface or CustomerPanelViewProviderInterface.

For example:

namespace MyVendor\MyModule;

class MyPanelViewProvider implements CustomerPanelViewProviderInterface
{
    public function getData(CustomerInterface $customer): array
    {
        return [
            'my_custom_field' => 'some value'
        ]
    }
}

Register in your di.xml

<virtualType name="Emico\RobinHq\DataProvider\PanelView\CustomerPanelViewProvider" type="Emico\RobinHq\DataProvider\PanelView\AggregateProvider">
    <arguments>
        <argument name="providers" xsi:type="array">
            <item name="mydata" xsi:type="object">MyVendor\MyModule\MyPanelViewProvider</item>
        </argument>
    </arguments>
</virtualType>

Dynamic API POST requests

For complete integration with Robin dynamic API the Magento module needs to issue POST requests to the RobinHQ platform.

For this functionality to work correctly it is mandatory to have a working RabbitMQ instance. You can read more about setting this up in the Magento documentation.

Use the following command to process the message queue: bin/magento queue:consumers:start EmicoRobinHq

You can configure this in a cronjob or preferably using supervisor.

Frontend widgets

This module provides a widget to display the RobinHQ tracking script on your website. This makes it possible to gain insight into all products viewed by the customer and the contents of the shopping cart. Should work out of the box with the default Luma theme.

See: https://developers.cm.com/mobile-service-cloud/docs/viewed-products

To enable this feature you have to enable it in the configuration.

Stores -> Configuration -> Emico -> RobinHQ -> Enable viewed products tracking