---
title: Utiliser le Shadow CRM
slug: oip-next/LVgB-utiliser-le
icon: {"lucideIcon":"📘"}
createdAt: 2025-12-04T12:43:56.000Z
---

# Vue d'ensemble

Dans le cadre d’un projet **selfcare**, il est nécessaire d’activer la prise en charge du **Shadow CRM** lors du décrochage.

Ce mode permet de récupérer le contexte client directement depuis le service Shadow CRM sans token de décrochage.

***

# Prérequis

Assurez-vous que les variables d’environnement suivantes soient définies :

- [SHADOW\_CRM\_URL](https://doc.fasst.tech/oip/environnement#qrcGM)
- [SHADOW\_CRM\_TEAM\_API\_KEY](https://doc.fasst.tech/oip/environnement#oag10)

Ces variables permettent au serveur de l'OAV d'appeler le service Shadow CRM pour récupérer le contexte client.

***

# Activation du mode Shadow CRM

Pour activer la récupération du contexte via Shadow CRM lors du décrochage, modifiez la configuration de l’application client dans le fichier `app/index.jsx` de votre projet.

L’objet de configuration passé à la fonction `start` doit inclure la propriété `ctx` avec la valeur `shadow-crm`.

***

# Exemple d’intégration

:::CodeblockTabs
index.jsx

```javascript
import { start } from '@fasstech/oip-starter-utils/app';

(() => {
  const appConfig = {
    // ...
    ctx: 'shadow-crm'
  };

  start(appConfig);
})();
```
:::

Avec cette configuration :

- le moteur OIP interroge automatiquement le Shadow CRM pour résoudre le contexte ;
- le contexte résolu est ensuite transmis à l’OAV pour initialiser ou reprendre le parcours.

***

# Résumé

La prise en charge du **Shadow CRM** est requise pour les projets **selfcare.&#x20;**

Ce mode nécessite :

- Les variables d’environnement : `SHADOW_CRM_URL` et `SHADOW_CRM_TEAM_API_KEY` ;
- La configuration de l'application client transmise à la fonction `start` doit inclure la propriété `ctx` avec la valeur `shadow-crm`.

Le contexte client est alors entièrement résolu via le Shadow CRM lors du décrochage.
