Events

L’objet Event

Un event décrit quelque chose qui s’est passé dans un espace. Skoup l’envoie à vos endpoints de webhook et le garde lisible via GET /v1/events pendant 30 jours. data.object a exactement la forme renvoyée par le GET correspondant.

Attributs

idstring
Identifiant unique de l'event (evt_…). Servez-vous-en pour dédupliquer les livraisons.
objectstring
Toujours event.
typestring
Le type d'event, par ex. alert.created.
api_versionstring
Version de la forme du payload, v1. Aucun champ n'est retiré au sein d'une version.
createdinteger
Timestamp Unix de l'event.
livemodeboolean
false pour les events émis par des appels en mode test ou envoyés comme events de test.
brandstringnullable
La marque concernée (br_…), null pour un event de niveau espace.
dataobject
L'objet concerné par l'event.
Afficher les attributs enfants
- objectobject
  L'objet tel que le renvoie le GET correspondant au moment de l'event.
- previous_attributesobjectnullable
  Pour les events *.updated, les valeurs des attributs modifiés avant le changement.

L'objet Event


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "alert.created",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "object": "alert",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "market": "FR",
      "kind": "price_hallucination",
      "severity": "critical",
      "status": "new",
      "product": {
        "id": "prod_031CQNg2fZXIIClKM3I8uF",
        "title": "Grizl CF SL 7"
      },
      "query": {
        "id": "qry_031CQSmQyxphdXPSkx2QxP",
        "text": "meilleur vélo gravel carbone à moins de 3000 €"
      },
      "competitor": null,
      "model": "chatgpt",
      "models": [
        {
          "model": "chatgpt",
          "occurrences": 2
        },
        {
          "model": "gemini",
          "occurrences": 1
        }
      ],
      "occurrences": 3,
      "claimed": {
        "price": 2199,
        "price_max": null,
        "price_kind": "exact",
        "period": null,
        "unit": null,
        "scope": "offer",
        "currency": "EUR",
        "min": 2199,
        "max": 2199,
        "gap": 0.12,
        "runs": 3
      },
      "truth": {
        "price": 2499,
        "min": 2499,
        "max": 2499,
        "currency": "EUR",
        "period": null,
        "unit": null,
        "annual_min": null,
        "annual_max": null,
        "max_with_addons": 2499,
        "open_ended": false,
        "addons": [],
        "scope": "offer",
        "variants": 4,
        "checked_at": "2026-09-21T02:40:00Z"
      },
      "persisted": false,
      "verifications": 0,
      "first_seen_at": "2026-09-21T02:40:00Z",
      "last_seen_at": "2026-09-21T02:40:00Z",
      "treated_at": null,
      "dismissed_at": null,
      "close_reason": null,
      "last_verification_at": null,
      "resolved_at": null,
      "livemode": true,
      "created": 1790000000
    }
  }
}

Types d’events

Tous les types d’events envoyés par Skoup, groupés par catégorie.

Alertes

alert.created

Une alerte a été ouverte : hallucination de prix, disponibilité erronée, chute de visibilité, nouveau concurrent, spec inventée, informations d’établissement erronées ou régression SEO. Objet : alert.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "alert.created",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "object": "alert",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "market": "FR",
      "kind": "price_hallucination",
      "severity": "critical",
      "status": "new",
      "product": {
        "id": "prod_031CQNg2fZXIIClKM3I8uF",
        "title": "Grizl CF SL 7"
      },
      "query": {
        "id": "qry_031CQSmQyxphdXPSkx2QxP",
        "text": "meilleur vélo gravel carbone à moins de 3000 €"
      },
      "competitor": null,
      "model": "chatgpt",
      "models": [
        {
          "model": "chatgpt",
          "occurrences": 2
        },
        {
          "model": "gemini",
          "occurrences": 1
        }
      ],
      "occurrences": 3,
      "claimed": {
        "price": 2199,
        "price_max": null,
        "price_kind": "exact",
        "period": null,
        "unit": null,
        "scope": "offer",
        "currency": "EUR",
        "min": 2199,
        "max": 2199,
        "gap": 0.12,
        "runs": 3
      },
      "truth": {
        "price": 2499,
        "min": 2499,
        "max": 2499,
        "currency": "EUR",
        "period": null,
        "unit": null,
        "annual_min": null,
        "annual_max": null,
        "max_with_addons": 2499,
        "open_ended": false,
        "addons": [],
        "scope": "offer",
        "variants": 4,
        "checked_at": "2026-09-21T02:40:00Z"
      },
      "persisted": false,
      "verifications": 0,
      "first_seen_at": "2026-09-21T02:40:00Z",
      "last_seen_at": "2026-09-21T02:40:00Z",
      "treated_at": null,
      "dismissed_at": null,
      "close_reason": null,
      "last_verification_at": null,
      "resolved_at": null,
      "livemode": true,
      "created": 1790000000
    }
  }
}

alert.resolved

Un re-sampling de vérification ne retrouve plus le claim (ou, pour une régression SEO, le crawl suivant retrouve les pages saines) : l’alerte est résolue. Objet : alert.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "alert.resolved",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "object": "alert",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "market": "FR",
      "kind": "price_hallucination",
      "severity": "critical",
      "status": "new",
      "product": {
        "id": "prod_031CQNg2fZXIIClKM3I8uF",
        "title": "Grizl CF SL 7"
      },
      "query": {
        "id": "qry_031CQSmQyxphdXPSkx2QxP",
        "text": "meilleur vélo gravel carbone à moins de 3000 €"
      },
      "competitor": null,
      "model": "chatgpt",
      "models": [
        {
          "model": "chatgpt",
          "occurrences": 2
        },
        {
          "model": "gemini",
          "occurrences": 1
        }
      ],
      "occurrences": 3,
      "claimed": {
        "price": 2199,
        "price_max": null,
        "price_kind": "exact",
        "period": null,
        "unit": null,
        "scope": "offer",
        "currency": "EUR",
        "min": 2199,
        "max": 2199,
        "gap": 0.12,
        "runs": 3
      },
      "truth": {
        "price": 2499,
        "min": 2499,
        "max": 2499,
        "currency": "EUR",
        "period": null,
        "unit": null,
        "annual_min": null,
        "annual_max": null,
        "max_with_addons": 2499,
        "open_ended": false,
        "addons": [],
        "scope": "offer",
        "variants": 4,
        "checked_at": "2026-09-21T02:40:00Z"
      },
      "persisted": false,
      "verifications": 0,
      "first_seen_at": "2026-09-21T02:40:00Z",
      "last_seen_at": "2026-09-21T02:40:00Z",
      "treated_at": null,
      "dismissed_at": null,
      "close_reason": null,
      "last_verification_at": null,
      "resolved_at": null,
      "livemode": true,
      "created": 1790000000
    }
  }
}

alert.updated

Une alerte a changé de statut (vue, traitée, ignorée) ou a agrégé de nouvelles occurrences. Objet : alert.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "alert.updated",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "object": "alert",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "market": "FR",
      "kind": "price_hallucination",
      "severity": "critical",
      "status": "new",
      "product": {
        "id": "prod_031CQNg2fZXIIClKM3I8uF",
        "title": "Grizl CF SL 7"
      },
      "query": {
        "id": "qry_031CQSmQyxphdXPSkx2QxP",
        "text": "meilleur vélo gravel carbone à moins de 3000 €"
      },
      "competitor": null,
      "model": "chatgpt",
      "models": [
        {
          "model": "chatgpt",
          "occurrences": 2
        },
        {
          "model": "gemini",
          "occurrences": 1
        }
      ],
      "occurrences": 3,
      "claimed": {
        "price": 2199,
        "price_max": null,
        "price_kind": "exact",
        "period": null,
        "unit": null,
        "scope": "offer",
        "currency": "EUR",
        "min": 2199,
        "max": 2199,
        "gap": 0.12,
        "runs": 3
      },
      "truth": {
        "price": 2499,
        "min": 2499,
        "max": 2499,
        "currency": "EUR",
        "period": null,
        "unit": null,
        "annual_min": null,
        "annual_max": null,
        "max_with_addons": 2499,
        "open_ended": false,
        "addons": [],
        "scope": "offer",
        "variants": 4,
        "checked_at": "2026-09-21T02:40:00Z"
      },
      "persisted": false,
      "verifications": 0,
      "first_seen_at": "2026-09-21T02:40:00Z",
      "last_seen_at": "2026-09-21T02:40:00Z",
      "treated_at": null,
      "dismissed_at": null,
      "close_reason": null,
      "last_verification_at": null,
      "resolved_at": null,
      "livemode": true,
      "created": 1790000000
    }
  }
}

Catalogue

catalog.sync.completed

Une synchronisation du catalogue est terminée (boutique, feed). Objet : catalog_sync.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "catalog.sync.completed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "csync_031CRAJfSt7R2knG4Y5HDB",
      "object": "catalog_sync",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "source": "shopify",
      "trigger": "scheduled",
      "status": "completed",
      "products_total": 342,
      "products_synced": 342,
      "products_created": 3,
      "products_removed": 1,
      "error": null,
      "started_at": "2026-09-21T03:00:02Z",
      "finished_at": "2026-09-21T03:01:40Z",
      "livemode": true,
      "created": 1790000000
    }
  }
}

catalog.sync.failed

Une synchronisation du catalogue a échoué. Objet : catalog_sync.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "catalog.sync.failed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "csync_031CRAJfSt7R2knG4Y5HDB",
      "object": "catalog_sync",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "source": "shopify",
      "trigger": "scheduled",
      "status": "failed",
      "products_total": null,
      "products_synced": 342,
      "products_created": 3,
      "products_removed": 1,
      "error": "The store rejected the access token.",
      "started_at": "2026-09-21T03:00:02Z",
      "finished_at": "2026-09-21T03:01:40Z",
      "livemode": true,
      "created": 1790000000
    }
  }
}

product.created

Un produit est apparu dans le catalogue (boutique, feed ou manuel). Objet : product.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "product.created",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "prod_031CQNg2fZXIIClKM3I8uF",
      "object": "product",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "source": "shopify",
      "read_only": true,
      "external_id": "gid://shopify/Product/8123456789012",
      "handle": "grizl-cf-sl-7",
      "title": "Grizl CF SL 7",
      "description": "Gravel carbone, transmission Shimano GRX 2x12.",
      "vendor": "Nordvelo",
      "category": "Vélos gravel",
      "sku": "GRZ-CF-SL7",
      "gtin": "4251234567890",
      "price": "2499.00",
      "currency": "EUR",
      "price_period": null,
      "price_annual": null,
      "price_unit": null,
      "addons": [],
      "url": "https://nordvelo.fr/products/grizl-cf-sl-7",
      "image_url": "https://cdn.shopify.com/s/files/grizl-cf-sl-7.jpg",
      "status": "active",
      "tags": [
        "gravel",
        "carbone"
      ],
      "options": [
        {
          "name": "Taille",
          "values": [
            "S",
            "M",
            "L"
          ]
        }
      ],
      "variants": [
        {
          "id": "var_031CQNtmS3W4oi14CtkFvn",
          "object": "variant",
          "title": "M",
          "sku": "GRZ-CF-SL7-M",
          "gtin": "4251234567891",
          "price": "2499.00",
          "compare_at_price": null,
          "inventory_quantity": 7,
          "options": [
            {
              "name": "Taille",
              "value": "M"
            }
          ]
        }
      ],
      "synced_at": "2026-09-21T03:00:12Z",
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

product.deleted

Un produit a quitté le catalogue. Objet : product.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "product.deleted",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "prod_031CQNg2fZXIIClKM3I8uF",
      "object": "product",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "source": "shopify",
      "read_only": true,
      "external_id": "gid://shopify/Product/8123456789012",
      "handle": "grizl-cf-sl-7",
      "title": "Grizl CF SL 7",
      "description": "Gravel carbone, transmission Shimano GRX 2x12.",
      "vendor": "Nordvelo",
      "category": "Vélos gravel",
      "sku": "GRZ-CF-SL7",
      "gtin": "4251234567890",
      "price": "2499.00",
      "currency": "EUR",
      "price_period": null,
      "price_annual": null,
      "price_unit": null,
      "addons": [],
      "url": "https://nordvelo.fr/products/grizl-cf-sl-7",
      "image_url": "https://cdn.shopify.com/s/files/grizl-cf-sl-7.jpg",
      "status": "active",
      "tags": [
        "gravel",
        "carbone"
      ],
      "options": [
        {
          "name": "Taille",
          "values": [
            "S",
            "M",
            "L"
          ]
        }
      ],
      "variants": [
        {
          "id": "var_031CQNtmS3W4oi14CtkFvn",
          "object": "variant",
          "title": "M",
          "sku": "GRZ-CF-SL7-M",
          "gtin": "4251234567891",
          "price": "2499.00",
          "compare_at_price": null,
          "inventory_quantity": 7,
          "options": [
            {
              "name": "Taille",
              "value": "M"
            }
          ]
        }
      ],
      "synced_at": "2026-09-21T03:00:12Z",
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

product.updated

Un produit a changé. Objet : product.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "product.updated",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "prod_031CQNg2fZXIIClKM3I8uF",
      "object": "product",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "source": "shopify",
      "read_only": true,
      "external_id": "gid://shopify/Product/8123456789012",
      "handle": "grizl-cf-sl-7",
      "title": "Grizl CF SL 7",
      "description": "Gravel carbone, transmission Shimano GRX 2x12.",
      "vendor": "Nordvelo",
      "category": "Vélos gravel",
      "sku": "GRZ-CF-SL7",
      "gtin": "4251234567890",
      "price": "2499.00",
      "currency": "EUR",
      "price_period": null,
      "price_annual": null,
      "price_unit": null,
      "addons": [],
      "url": "https://nordvelo.fr/products/grizl-cf-sl-7",
      "image_url": "https://cdn.shopify.com/s/files/grizl-cf-sl-7.jpg",
      "status": "active",
      "tags": [
        "gravel",
        "carbone"
      ],
      "options": [
        {
          "name": "Taille",
          "values": [
            "S",
            "M",
            "L"
          ]
        }
      ],
      "variants": [
        {
          "id": "var_031CQNtmS3W4oi14CtkFvn",
          "object": "variant",
          "title": "M",
          "sku": "GRZ-CF-SL7-M",
          "gtin": "4251234567891",
          "price": "2499.00",
          "compare_at_price": null,
          "inventory_quantity": 7,
          "options": [
            {
              "name": "Taille",
              "value": "M"
            }
          ]
        }
      ],
      "synced_at": "2026-09-21T03:00:12Z",
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

write_back.applied

Skoup a écrit la fiche ou les codes-barres d’un produit dans la boutique (relus par une personne dans l’app), avec les valeurs remplacées. Objet : write_back.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "write_back.applied",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "wb_031CQjcAH6UqepovbzUK6t",
      "object": "write_back",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "product": "prod_031CQNg2fZXIIClKM3I8uF",
      "task": "task_031CQg4La2D4FtcCN87OUU",
      "status": "applied",
      "changes": [
        {
          "field": "seo_description",
          "variant_external_id": null,
          "variant_title": null,
          "before": "",
          "after": "Gravel carbone Shimano GRX 2x12, cadre garanti à vie."
        },
        {
          "field": "barcode",
          "variant_external_id": "gid://shopify/ProductVariant/44123456789",
          "variant_title": "M",
          "before": "",
          "after": "4006381333931"
        }
      ],
      "error": null,
      "applied_at": "2026-09-22T14:05:31Z",
      "rollback_until": "2026-10-22T14:05:31Z",
      "rolled_back_at": null,
      "livemode": true,
      "created": 1790085931
    }
  }
}

write_back.rolled_back

Un write-back a été annulé : la boutique retrouve les valeurs précédentes. Objet : write_back.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "write_back.rolled_back",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "wb_031CQjcAH6UqepovbzUK6t",
      "object": "write_back",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "product": "prod_031CQNg2fZXIIClKM3I8uF",
      "task": "task_031CQg4La2D4FtcCN87OUU",
      "status": "applied",
      "changes": [
        {
          "field": "seo_description",
          "variant_external_id": null,
          "variant_title": null,
          "before": "",
          "after": "Gravel carbone Shimano GRX 2x12, cadre garanti à vie."
        },
        {
          "field": "barcode",
          "variant_external_id": "gid://shopify/ProductVariant/44123456789",
          "variant_title": "M",
          "before": "",
          "after": "4006381333931"
        }
      ],
      "error": null,
      "applied_at": "2026-09-22T14:05:31Z",
      "rollback_until": "2026-10-22T14:05:31Z",
      "rolled_back_at": null,
      "livemode": true,
      "created": 1790085931
    }
  }
}

Concurrents

competitor.removed

Une marque concurrente n’est plus suivie. Objet : competitor.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "competitor.removed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "comp_031DIivuBKog78mwjgnch7",
      "object": "competitor",
      "name": "Canyon",
      "key": "canyon",
      "domain": "canyon.com",
      "market": "FR",
      "origin": "detected",
      "tracked": false,
      "tracked_at": "2026-09-22T10:04:11Z",
      "removed_at": "2026-09-23T08:30:00Z",
      "livemode": true,
      "created": 1790071451
    }
  }
}

competitor.tracked

Une marque concurrente est désormais suivie. Objet : competitor.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "competitor.tracked",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "comp_031DIivuBKog78mwjgnch7",
      "object": "competitor",
      "name": "Canyon",
      "key": "canyon",
      "domain": "canyon.com",
      "market": "FR",
      "origin": "detected",
      "tracked": true,
      "tracked_at": "2026-09-22T10:04:11Z",
      "removed_at": null,
      "livemode": true,
      "created": 1790071451
    }
  }
}

Fiches d’identité

sheet.validated

Une fiche d’identité produit a été validée par une personne. Objet : sheet.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "sheet.validated",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "sheet_031DIivuBKog78mwjgnXQv",
      "object": "sheet",
      "product": "prod_031DIivuBKog78mwjgnbd3",
      "status": "validated",
      "version": 3,
      "promise": "Le gravel carbone le plus léger de sa catégorie, garanti à vie.",
      "attributes": [
        {
          "id": "attr_weight",
          "label": "Cadre carbone 890 g"
        },
        {
          "id": "attr_warranty",
          "label": "Garantie à vie"
        },
        {
          "id": "attr_fit",
          "label": "Géométrie endurance"
        }
      ],
      "price_positioning": "premium",
      "audience": "Cyclistes gravel exigeants, longues distances",
      "specs": [
        {
          "key": "Poids cadre",
          "value": "890 g"
        }
      ],
      "validated_at": "2026-09-22T15:40:00Z",
      "livemode": true,
      "created": 1790000000
    }
  }
}

Intégrations

integration.disconnected

Une intégration a été déconnectée. Objet : integration.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "integration.disconnected",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "object": "integration",
      "brand": "br_031DIivuBKog78mwjgnYQr",
      "provider": "shopify",
      "status": "disconnected",
      "external_property": "nordvelo.myshopify.com",
      "last_error": null,
      "last_synced_at": "2026-09-23T03:00:12Z",
      "livemode": true
    }
  }
}

integration.needs_reauth

Une intégration (Shopify, Search Console) doit être reconnectée. Objet : integration.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "integration.needs_reauth",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "object": "integration",
      "brand": "br_031DIivuBKog78mwjgnYQr",
      "provider": "shopify",
      "status": "needs_reauth",
      "external_property": "nordvelo.myshopify.com",
      "last_error": "The app was uninstalled from the store.",
      "last_synced_at": "2026-09-23T03:00:12Z",
      "livemode": true
    }
  }
}

Perception

perception.judged

Les claims des dernières réponses ont été jugés contre les fiches d’identité produit. Objet : perception_judgement.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "perception.judged",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "object": "perception_judgement",
      "brand": "br_031DIivuBKog78mwjgnYQr",
      "market": "FR",
      "sampling": "smp_031DIivuBKog78mwjgnZUv",
      "claims": 214,
      "score": 71.4,
      "by_model": [
        {
          "model": "chatgpt",
          "runs": 58,
          "conforming": 44,
          "absent": 9,
          "distorted": 6,
          "false": 2
        },
        {
          "model": "claude",
          "runs": 51,
          "conforming": 39,
          "absent": 7,
          "distorted": 3,
          "false": 1
        }
      ],
      "livemode": true
    }
  }
}

Readiness

readiness.score.updated

Le score de readiness IA d’un marché a été recalculé (avec le score précédent). Objet : readiness_score.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "readiness.score.updated",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "object": "readiness_score",
      "brand": "br_031DIivuBKog78mwjgnYQr",
      "market": "FR",
      "score": 68,
      "previous_score": 64,
      "trigger": "crawl",
      "blocks": [
        {
          "block": "crawlability",
          "weight": 30,
          "score": 82,
          "measured": true,
          "checks": [
            {
              "check": "robots_ai_bots",
              "status": "ok",
              "value": "7/7",
              "impact": 0
            },
            {
              "check": "llms_txt",
              "status": "err",
              "value": null,
              "impact": 4
            }
          ]
        }
      ],
      "computed_at": "2026-09-23T04:19:10Z",
      "livemode": true
    }
  }
}

Revenue

order.attributed

Une commande de la boutique a été attribuée à une surface IA (ChatGPT, Claude, Gemini, Perplexity…). Objet : order.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "order.attributed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "ord_031DIivuBKog78mwjgnaYz",
      "object": "order",
      "source": "shopify",
      "order_number": "#1042",
      "ordered_at": "2026-09-23T09:12:44Z",
      "currency": "EUR",
      "subtotal": "2399.00",
      "total": "2399.00",
      "items_count": 1,
      "country": "FR",
      "ai_surface": "chatgpt",
      "attribution_signal": "referrer",
      "referrer_host": "chatgpt.com",
      "landing_path": "/products/strade-7",
      "landing_product": "prod_031DIivuBKog78mwjgnbd3",
      "utm_source": null,
      "utm_medium": null,
      "utm_campaign": null,
      "lines": [
        {
          "product": "prod_031DIivuBKog78mwjgnbd3",
          "title": "Strade 7",
          "sku": "STR7-M",
          "quantity": 1,
          "unit_price": "2399.00",
          "total": "2399.00"
        }
      ],
      "livemode": true,
      "created": 1790154764
    }
  }
}

SEO

seo.crawl.completed

Un crawl SEO d’un marché est terminé, avec son score. Objet : seo_crawl.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "seo.crawl.completed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "object": "seo_crawl",
      "brand": "br_031DIivuBKog78mwjgnYQr",
      "market": "FR",
      "status": "completed",
      "trigger": "scheduled",
      "score": 78,
      "pages_crawled": 412,
      "checks": {
        "ok": 41,
        "warn": 7,
        "err": 3
      },
      "started_at": "2026-09-23T04:00:02Z",
      "finished_at": "2026-09-23T04:18:45Z",
      "livemode": true
    }
  }
}

Tâches

task.created

Une tâche a été ajoutée au backlog, à la main ou depuis une alerte, un check ou une opportunité. Objet : task.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "task.created",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "task_031CQmvL2QQbe3t38Gyo91",
      "object": "task",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "title": "Corriger le prix affiché de la Grizl CF SL 7",
      "description": "ChatGPT annonce 2 199 € alors que le catalogue affiche 2 499 €.",
      "status": "in_progress",
      "kind": "content",
      "effort": "s",
      "source": "alert",
      "source_label": "Alerte · hallucination de prix",
      "alert": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "product": "Grizl CF SL 7",
      "impact": "Critique",
      "gain": null,
      "guide": {
        "topic": "price_source",
        "platform": "shopify",
        "steps": [
          "Open the alert and its answers: note the sources cited next to the wrong price.",
          "Old promotion page still online: Online Store → Pages, hide it, then create a URL redirect (search « URL redirects » in the admin) to the current product page.",
          "Check the variant's price and « compare-at price » in Products; update Google Merchant Center and the comparison sites.",
          "Click « Verify » on the alert: a targeted re-sampling confirms the fix."
        ]
      },
      "assignee": {
        "name": "Camille Martin"
      },
      "started_at": "2026-09-21T09:12:00Z",
      "published_at": null,
      "verify_at": null,
      "verified_at": null,
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

task.updated

Une tâche a changé : champs, responsable ou colonne du kanban. Objet : task.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "task.updated",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "task_031CQmvL2QQbe3t38Gyo91",
      "object": "task",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "title": "Corriger le prix affiché de la Grizl CF SL 7",
      "description": "ChatGPT annonce 2 199 € alors que le catalogue affiche 2 499 €.",
      "status": "in_progress",
      "kind": "content",
      "effort": "s",
      "source": "alert",
      "source_label": "Alerte · hallucination de prix",
      "alert": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "product": "Grizl CF SL 7",
      "impact": "Critique",
      "gain": null,
      "guide": {
        "topic": "price_source",
        "platform": "shopify",
        "steps": [
          "Open the alert and its answers: note the sources cited next to the wrong price.",
          "Old promotion page still online: Online Store → Pages, hide it, then create a URL redirect (search « URL redirects » in the admin) to the current product page.",
          "Check the variant's price and « compare-at price » in Products; update Google Merchant Center and the comparison sites.",
          "Click « Verify » on the alert: a targeted re-sampling confirms the fix."
        ]
      },
      "assignee": {
        "name": "Camille Martin"
      },
      "started_at": "2026-09-21T09:12:00Z",
      "published_at": null,
      "verify_at": null,
      "verified_at": null,
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

task.verified

Une tâche est passée « Vérifiée », à la main ou parce que son alerte est résolue. Objet : task.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "task.verified",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "task_031CQmvL2QQbe3t38Gyo91",
      "object": "task",
      "brand": "br_031CQGx2DNM4mxT2CO7BL3",
      "title": "Corriger le prix affiché de la Grizl CF SL 7",
      "description": "ChatGPT annonce 2 199 € alors que le catalogue affiche 2 499 €.",
      "status": "in_progress",
      "kind": "content",
      "effort": "s",
      "source": "alert",
      "source_label": "Alerte · hallucination de prix",
      "alert": "alrt_031CQlTxUKUOFYaHSd3kBY",
      "product": "Grizl CF SL 7",
      "impact": "Critique",
      "gain": null,
      "guide": {
        "topic": "price_source",
        "platform": "shopify",
        "steps": [
          "Open the alert and its answers: note the sources cited next to the wrong price.",
          "Old promotion page still online: Online Store → Pages, hide it, then create a URL redirect (search « URL redirects » in the admin) to the current product page.",
          "Check the variant's price and « compare-at price » in Products; update Google Merchant Center and the comparison sites.",
          "Click « Verify » on the alert: a targeted re-sampling confirms the fix."
        ]
      },
      "assignee": {
        "name": "Camille Martin"
      },
      "started_at": "2026-09-21T09:12:00Z",
      "published_at": null,
      "verify_at": null,
      "verified_at": null,
      "livemode": true,
      "created": 1790000000,
      "updated": 1790003600
    }
  }
}

Visibilité

sampling.completed

Un sampling est terminé : chaque requête a été posée à chaque modèle. Les re-samplings ciblés portent leur requête. Objet : sampling.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "sampling.completed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "smp_031DIivuBKog78mwjgnZUv",
      "object": "sampling",
      "market": "FR",
      "trigger": "scheduled",
      "status": "completed",
      "query": null,
      "week_starts_on": "2026-09-21",
      "models": [
        "chatgpt",
        "claude",
        "gemini",
        "perplexity"
      ],
      "queries_count": 40,
      "runs_total": 640,
      "runs_completed": 635,
      "runs_failed": 5,
      "brand_share": 31.9,
      "by_model": [
        {
          "model": "chatgpt",
          "runs": 160,
          "hits": 61,
          "avg_position": 2.4
        },
        {
          "model": "claude",
          "runs": 158,
          "hits": 49,
          "avg_position": 2.9
        },
        {
          "model": "gemini",
          "runs": 157,
          "hits": 38,
          "avg_position": 3.1
        },
        {
          "model": "perplexity",
          "runs": 160,
          "hits": 55,
          "avg_position": 2.2
        }
      ],
      "error": null,
      "started_at": "2026-09-21T02:00:04Z",
      "finished_at": "2026-09-21T02:41:37Z",
      "livemode": true,
      "created": 1790042400
    }
  }
}

sampling.failed

Un sampling a échoué avant la fin. Objet : sampling.

Afficher un exemple de payload


{
  "id": "evt_0kR3vWm8Qb1xYz2A4c6E8g",
  "object": "event",
  "type": "sampling.failed",
  "api_version": "v1",
  "created": 1790000000,
  "livemode": true,
  "brand": "br_0kQ1s9Xw3Yb5Zc7Ad9Ef1G",
  "data": {
    "object": {
      "id": "smp_031DIivuBKog78mwjgnZUv",
      "object": "sampling",
      "market": "FR",
      "trigger": "scheduled",
      "status": "failed",
      "query": null,
      "week_starts_on": "2026-09-21",
      "models": [
        "chatgpt",
        "claude",
        "gemini",
        "perplexity"
      ],
      "queries_count": 40,
      "runs_total": 640,
      "runs_completed": 0,
      "runs_failed": 640,
      "brand_share": null,
      "by_model": [],
      "error": "Every run failed.",
      "started_at": "2026-09-21T02:00:04Z",
      "finished_at": "2026-09-21T02:41:37Z",
      "livemode": true,
      "created": 1790042400
    }
  }
}