Intégrations — Heurix

Particularité Shopify. Shopify ne permet pas d'exécuter du code serveur avec une clé secrète directement dans un thème (Liquid est rendu côté serveur mais sans appels sortants authentifiés possibles). La bonne architecture : une petite fonction serverless (Cloudflare Worker ci-dessous, gratuit jusqu'à 100 000 requêtes/jour) qui détient la vraie clé Heurix et sert de relais entre votre thème et l'API — votre clé n'est jamais exposée dans le navigateur.

1. Brancher la recherche

Le relais (Cloudflare Worker) :

// worker.js — déployé sur Cloudflare Workers (gratuit pour ce volume)
export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    const q = url.searchParams.get("q") || "";
    const res = await fetch("https://api.heurix.fr/v1/index/" + env.HEURIX_CATALOG + "/search", {
      method: "POST",
      headers: {
        "Authorization": "Bearer " + env.HEURIX_API_KEY,  // secret Cloudflare, jamais exposé
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ q, limit: 20 })
    });
    return new Response(await res.text(), {
      headers: { "Content-Type": "application/json", "Access-Control-Allow-Origin": "https://votre-boutique.myshopify.com" }
    });
  }
}

Dans le thème (Online Store 2.0), remplacez le rendu de sections/search-results.liquid par un appel à ce relais :

<div id="heurix-results"></div>
<script>
  const params = new URLSearchParams(window.location.search);
  fetch("https://votre-worker.workers.dev/search?q=" + encodeURIComponent(params.get("q") || ""))
    .then(r => r.json())
    .then(data => {
      document.getElementById("heurix-results").innerHTML = data.hits.map(h =>
        `<a href="/products/${h.product.handle}" class="heurix-hit">
           <span>${h.product.name}</span><span>${h.product.price} €</span>
         </a>`
      ).join("");
    });
</script>

2. Synchroniser le catalogue

Enregistrez un webhook Shopify (Admin API ou shopify.app.toml pour une app custom) sur les sujets products/create, products/update, products/delete, pointé vers le même Worker :

// Ajout dans worker.js : gestion du webhook Shopify
async function handleWebhook(request, env) {
  const product = await request.json();
  await fetch("https://api.heurix.fr/v1/index/" + env.HEURIX_CATALOG + "/items", {
    method: "POST",
    headers: { "Authorization": "Bearer " + env.HEURIX_API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      rulepack: "mode",
      items: [{
        id: String(product.id),
        name: product.title,
        ref: product.variants?.[0]?.sku || "",
        description: product.body_html?.replace(/<[^>]+>/g, "") || "",
        stock: product.variants?.reduce((s, v) => s + (v.inventory_quantity || 0), 0) || 0,
        handle: product.handle,
        price: product.variants?.[0]?.price
      }]
    })
  });
}

Pensez à vérifier la signature HMAC du webhook Shopify (X-Shopify-Hmac-Sha256) avant de traiter la charge utile, pour ne pas accepter de requêtes forgées.

Avantage PrestaShop. PrestaShop tourne en PHP côté serveur — pas besoin de relais externe comme pour Shopify. Un module PrestaShop peut appeler l'API Heurix directement, la clé reste dans la configuration serveur, jamais envoyée au navigateur.

1. Brancher la recherche

Dans un module custom, on hook displaySearchResults ou on surcharge le contrôleur de recherche :

<?php
// modules/heurixsearch/heurixsearch.php
class HeurixSearch extends Module
{
    public function search($query)
    {
        $ch = curl_init('https://api.heurix.fr/v1/index/' . Configuration::get('HEURIX_CATALOG') . '/search');
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . Configuration::get('HEURIX_API_KEY'),
                'Content-Type: application/json',
            ],
            CURLOPT_POSTFIELDS => json_encode(['q' => $query, 'limit' => 24]),
        ]);
        $response = json_decode(curl_exec($ch), true);
        curl_close($ch);
        return $response['hits'] ?? [];
    }
}

Dans le template de résultats (search.tpl), on boucle sur ces résultats à la place de la recherche native PrestaShop.

2. Synchroniser le catalogue

Trois hooks suffisent pour rester à jour en temps réel :

<?php
public function install()
{
    return parent::install()
        && $this->registerHook('actionProductAdd')
        && $this->registerHook('actionProductUpdate')
        && $this->registerHook('actionProductDelete');
}

public function hookActionProductUpdate($params)
{
    $product = $params['product'];
    $this->pushToHeurix([
        'id' => (string) $product->id,
        'name' => $product->name,
        'ref' => $product->reference,
        'description' => strip_tags($product->description_short),
        'stock' => (int) StockAvailable::getQuantityAvailableByProduct($product->id),
    ]);
}

private function pushToHeurix($item)
{
    $ch = curl_init('https://api.heurix.fr/v1/index/' . Configuration::get('HEURIX_CATALOG') . '/items');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . Configuration::get('HEURIX_API_KEY'),
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS => json_encode(['rulepack' => 'mode', 'items' => [$item]]),
    ]);
    curl_exec($ch);
    curl_close($ch);
}

Avantage WooCommerce. Comme PrestaShop, WordPress/WooCommerce tourne en PHP côté serveur — appel direct à l'API depuis un plugin, clé jamais exposée au navigateur. On utilise wp_remote_post(), la fonction HTTP native de WordPress, plutôt que du cURL brut.

1. Brancher la recherche

<?php
// Dans functions.php ou un plugin dédié
add_filter('woocommerce_product_query_meta_query', function ($meta_query, $query) {
    if (!is_search()) return $meta_query;

    $response = wp_remote_post('https://api.heurix.fr/v1/index/' . HEURIX_CATALOG . '/search', [
        'headers' => [
            'Authorization' => 'Bearer ' . HEURIX_API_KEY,
            'Content-Type'  => 'application/json',
        ],
        'body' => json_encode(['q' => get_search_query(), 'limit' => 24]),
    ]);
    $hits = json_decode(wp_remote_retrieve_body($response), true)['hits'] ?? [];
    $ids  = array_map(fn($h) => (int) $h['product']['id'], $hits);

    // Réordonne les résultats WooCommerce natifs selon le classement Heurix
    $query->set('post__in', $ids ?: [0]);
    $query->set('orderby', 'post__in');
    return $meta_query;
}, 10, 2);

Cette approche a un avantage : elle réutilise l'affichage natif WooCommerce (fiches produit, filtres existants), Heurix ne fait que reclasser les résultats — moins de template à réécrire.

2. Synchroniser le catalogue

<?php
add_action('woocommerce_update_product', 'heurix_sync_product');
add_action('woocommerce_new_product', 'heurix_sync_product');

function heurix_sync_product($product_id) {
    $product = wc_get_product($product_id);
    wp_remote_post('https://api.heurix.fr/v1/index/' . HEURIX_CATALOG . '/items', [
        'headers' => [
            'Authorization' => 'Bearer ' . HEURIX_API_KEY,
            'Content-Type'  => 'application/json',
        ],
        'body' => json_encode([
            'rulepack' => 'mode',
            'items' => [[
                'id'    => (string) $product_id,
                'name'  => $product->get_name(),
                'ref'   => $product->get_sku(),
                'description' => wp_strip_all_tags($product->get_short_description()),
                'stock' => $product->get_stock_quantity() ?? 0,
            ]],
        ]),
    ]);
}

add_action('woocommerce_delete_product', function ($product_id) {
    wp_remote_request('https://api.heurix.fr/v1/index/' . HEURIX_CATALOG . '/items/' . $product_id, [
        'method' => 'DELETE',
        'headers' => ['Authorization' => 'Bearer ' . HEURIX_API_KEY],
    ]);
});

À prévoir sur Magento. L'architecture de Magento 2 (modules, observers, DI) est plus lourde que les trois autres — comptez davantage de temps de développement. Le principe reste le même : appel serveur direct, clé jamais exposée.

1. Brancher la recherche

Un module custom avec un plugin sur le bloc de résultats de recherche :

<?php
// app/code/Heurix/Search/Model/SearchClient.php
namespace Heurix\Search\Model;

use Magento\Framework\HTTP\Client\Curl;

class SearchClient
{
    public function __construct(private Curl $curl) {}

    public function search(string $query): array
    {
        $this->curl->addHeader('Authorization', 'Bearer ' . HEURIX_API_KEY);
        $this->curl->addHeader('Content-Type', 'application/json');
        $this->curl->post(
            'https://api.heurix.fr/v1/index/' . HEURIX_CATALOG . '/search',
            json_encode(['q' => $query, 'limit' => 24])
        );
        $data = json_decode($this->curl->getBody(), true);
        return $data['hits'] ?? [];
    }
}

Injectez ce service dans un plugin sur Magento\CatalogSearch\Model\Layer\Filter ou remplacez directement le template de résultats de recherche par un rendu basé sur ces données.

2. Synchroniser le catalogue

Un observer sur les événements standards du catalogue :

<?php
// app/code/Heurix/Search/Observer/SyncProduct.php
namespace Heurix\Search\Observer;

use Magento\Framework\Event\ObserverInterface;
use Magento\Framework\Event\Observer;

class SyncProduct implements ObserverInterface
{
    public function __construct(private \Magento\Framework\HTTP\Client\Curl $curl) {}

    public function execute(Observer $observer)
    {
        $product = $observer->getEvent()->getProduct();
        $this->curl->addHeader('Authorization', 'Bearer ' . HEURIX_API_KEY);
        $this->curl->addHeader('Content-Type', 'application/json');
        $this->curl->post('https://api.heurix.fr/v1/index/' . HEURIX_CATALOG . '/items', json_encode([
            'rulepack' => 'mode',
            'items' => [[
                'id' => (string) $product->getId(),
                'name' => $product->getName(),
                'ref' => $product->getSku(),
                'stock' => (int) $product->getExtensionAttributes()?->getStockItem()?->getQty(),
            ]],
        ]));
    }
}

Déclaré dans events.xml sur catalog_product_save_after et catalog_product_delete_after.

Une question sur votre plateforme ?

Ces guides sont un point de départ technique, pas un module clé en main. Si votre configuration sort de l'ordinaire, écrivez-nous.

Voir la documentation complète Nous contacter

Brancher Heurix sur votre plateforme.

1. Brancher la recherche

2. Synchroniser le catalogue

1. Brancher la recherche

2. Synchroniser le catalogue

1. Brancher la recherche

2. Synchroniser le catalogue

1. Brancher la recherche

2. Synchroniser le catalogue

Une question sur votre plateforme ?