# Shopify

> Reconnaissez vos clients Shopify quand ils appellent ou écrivent, et enregistrez vos appels et SMS Allo sur le client Shopify

L'intégration Shopify synchronise vos clients Shopify dans Allo : vos appelants apparaissent avec leur nom, leur email, leur entreprise, leur montant total dépensé et leur dernière commande Shopify. Après chaque appel ou SMS, Allo l'enregistre sur le client Shopify correspondant.

Allo se connecte à votre boutique via une petite app que vous créez pour votre propre boutique dans le Dev Dashboard de Shopify. Cela prend environ 5 minutes et ne se fait qu'une fois.

<Note>
  Depuis le 1er janvier 2026, Shopify ne permet plus de créer des apps personnalisées depuis **Paramètres** \> **Applications et canaux de vente** \> **Développer des applications**. Si vous avez connecté Allo avec un jeton d'accès Admin API, votre connexion continue de fonctionner et vous n'avez rien à faire.
</Note>

## Comment connecter

Il vous faut un admin ou un manager Allo, et le compte Shopify propriétaire de la boutique (ou un compte collaborateur autorisé à développer des apps pour elle).

### Créez l'app Allo dans Shopify

<Steps>
  <Step title="Ouvrez le Dev Dashboard de Shopify">
    Allez sur [dev.shopify.com](https://dev.shopify.com) et connectez-vous avec le compte Shopify de votre boutique. Choisissez l'organisation qui contient votre boutique.
  </Step>
  <Step title="Créez l'app">
    Cliquez sur **Create app**, nommez-la `Allo` et confirmez.
  </Step>
  <Step title="Choisissez les scopes d'accès">
    Ouvrez l'onglet **Versions** et créez une version. Dans la section des scopes, ajoutez ces quatre scopes :

    - `read_customers`
    - `write_customers`
    - `read_orders`
    - `write_orders`

    Choisissez les scopes de l'Admin API, pas ceux qui commencent par `customer_` (comme `customer_write_orders`), qui servent à une autre API Shopify.

    `write_customers` permet à Allo d'enregistrer les appels et SMS sur vos clients. Les scopes de commandes permettent à Allo de lire les commandes de vos clients. Allo ne supprime jamais un client ni une commande.
  </Step>
  <Step title="Autorisez l'accès aux données des clients">
    Shopify bloque l'accès aux clients tant que vous ne l'autorisez pas, même sur votre propre boutique. Allez sur le [Partner Dashboard de Shopify](https://partners.shopify.com) avec le même compte, ouvrez **Apps** \> **Allo** \> **API access requests** \> **Protected customer data access** et cliquez sur **Request access**. Sélectionnez **Protected customer data** et les champs **Name**, **Email** et **Phone**, indiquez une raison et enregistrez. Si Shopify vous demande d'abord de choisir une méthode de distribution, choisissez **Custom distribution** pour votre boutique.
  </Step>
  <Step title="Publiez la version">
    Cliquez sur **Release** pour activer cette version.
  </Step>
  <Step title="Installez l'app sur votre boutique">
    Depuis l'onglet **Home** de l'app, cliquez sur **Test app**, choisissez votre boutique, puis cliquez sur **Install** et acceptez les scopes.
  </Step>
  <Step title="Copiez le Client ID et le secret">
    Ouvrez l'onglet **Settings** de l'app et copiez le **Client ID** et le **Client secret**. Gardez-les pour l'étape suivante.
  </Step>
</Steps>

<Warning>
  L'app doit être dans la même organisation Shopify que votre boutique. Sinon, Shopify refuse la connexion.
</Warning>

### Connectez Shopify dans Allo

<Steps>
  <Step title="Allez dans Integrations">
    Dans Allo, allez dans **Settings** \> **Integrations**.
  </Step>
  <Step title="Trouvez Shopify">
    Trouvez **Shopify** et cliquez sur **Connect**.
  </Step>
  <Step title="Entrez votre boutique">
    Entrez le sous-domaine de votre boutique, la partie avant `.myshopify.com`. Pour `acme.myshopify.com`, entrez `acme`. Vous pouvez aussi coller l'adresse de votre boutique ou un lien d'admin Shopify comme `admin.shopify.com/store/acme` : Allo ne garde que le sous-domaine.
  </Step>
  <Step title="Collez le Client ID et le secret">
    Collez le **Client ID** et le **Client secret** copiés depuis le Dev Dashboard, puis cliquez sur **Connect**.
  </Step>
  <Step title="Attendez l'import des clients">
    Allo importe vos clients Shopify. L'intégration affiche l'import en cours jusqu'à la fin de la première synchronisation.
  </Step>
</Steps>

## Ce qui est synchronisé

**De Shopify vers Allo :**
- Les clients qui ont au moins un numéro de téléphone, avec leur nom, email, numéros, entreprise, note et tags
- Le montant total dépensé, le nombre de commandes et le nom de la dernière commande
- Un lien vers le client dans votre admin Shopify

**D'Allo vers Shopify :**
- Les appels et SMS, enregistrés sur le client correspondant

**Sens de synchronisation :** bidirectionnel. La première synchronisation importe tous vos clients Shopify qui ont un numéro de téléphone. Ensuite, Allo vérifie les clients nouveaux ou modifiés toutes les 10 minutes.

Allo lit le numéro du client et celui de son adresse par défaut. Les clients sans aucun numéro ne sont pas importés, car Allo ne peut pas les associer à un appel ou un SMS. Un client qui perd son dernier numéro est retiré d'Allo à la synchronisation suivante.

## Comment les appels et SMS sont enregistrés dans Shopify

Shopify ne permet pas aux apps d'écrire dans la chronologie du client. Allo enregistre donc vos appels et SMS à deux endroits sur le client :

- **La note du client :** Allo ajoute une ligne courte en haut de la note pour chaque appel ou SMS, avec le sens, le résultat, la durée et la date. Allo ne supprime ni ne modifie jamais ce que votre équipe a écrit dans la note. Quand la note devient longue, Allo retire uniquement ses propres lignes les plus anciennes.
- **Le champ Allo activity :** un metafield client nommé **Allo activity** garde les 50 derniers appels et SMS avec leurs détails et leur résumé IA. Vous le trouvez dans la section **Metafields** de la fiche client.

## Troubleshooting

<AccordionGroup>
  <Accordion title="La connexion échoue">
    - Vérifiez que l'app est installée sur la boutique que vous avez entrée, et que la version avec les quatre scopes est publiée.
    - Vérifiez que l'app et la boutique sont dans la même organisation Shopify.
    - Copiez à nouveau le Client ID et le Client secret depuis l'onglet **Settings** de l'app. Si vous avez renouvelé le secret dans Shopify, utilisez le nouveau.
    - Entrez uniquement le sous-domaine de la boutique, par exemple `acme` pour `acme.myshopify.com`.
  </Accordion>
  <Accordion title="Les clients sont importés sans nom ni numéro">
    Shopify protège le nom, l'email et le téléphone des clients. Si votre app ne les reçoit pas, ouvrez l'app dans le [Partner Dashboard de Shopify](https://partners.shopify.com), allez dans **API access requests** \> **Protected customer data access**, sélectionnez **Name**, **Email** et **Phone**, et enregistrez. Puis déconnectez et reconnectez Shopify dans Allo.
  </Accordion>
  <Accordion title="Les clients ne se synchronisent pas">
    Les clients nouveaux ou modifiés peuvent mettre jusqu'à 10 minutes à apparaître dans Allo. Seuls les clients avec un numéro de téléphone sont importés. Vérifiez que l'intégration apparaît comme connectée dans **Settings** \> **Integrations**.
  </Accordion>
  <Accordion title="Un appelant n'est pas reconnu">
    Allo compare le numéro du client et celui de son adresse par défaut. Les formats national et international d'un même numéro correspondent. Vérifiez que le numéro est bien enregistré sur le client Shopify.
  </Accordion>
  <Accordion title="Déconnecter ou révoquer l'accès">
    Pour arrêter la synchronisation, allez dans **Settings** \> **Integrations** \> **Shopify** dans Allo et cliquez sur **Disconnect**. Les contacts déjà dans Allo y restent. Pour révoquer l'accès d'Allo dans Shopify, désinstallez l'app Allo de votre boutique, ou supprimez-la dans le Dev Dashboard.
  </Accordion>
</AccordionGroup>
