> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eat-now.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter NowOS

> La procédure complète pour relier votre caisse NowOS à EatNow : récupérer les identifiants côté NowOS, les saisir dans EatNow, et vérifier que tout fonctionne.

La connexion se fait en **deux temps** : vous récupérez d'abord deux identifiants dans le backoffice NowOS, puis vous les collez dans EatNow. Comptez 10 minutes.

<Note>
  C'est une opération **ponctuelle**, généralement faite avec le support EatNow. Une fois connectée, l'intégration fonctionne sans que personne n'ait à y toucher.
</Note>

***

## Avant de commencer

<Steps>
  <Step title="Publiez votre plan de salle dans NowOS">
    Dans le backoffice NowOS, ouvrez **Tables → Floor plan**, dessinez vos salles et vos tables, puis touchez **Publier toutes les modifications**. Tant que le plan n'est pas publié, EatNow ne verra aucune table à associer.
  </Step>

  <Step title="Vérifiez vos droits dans EatNow">
    Vous devez avoir la permission de **créer une intégration**. Si le bouton affiche **Non autorisé**, demandez à un administrateur de votre restaurant. Voir [Permissions](/fr/collaborators/permissions).
  </Step>
</Steps>

***

## Étape 1 — Récupérer les identifiants dans NowOS

Dans le backoffice NowOS, ouvrez **Integrations → Reservations**.

<Steps>
  <Step title="Créez la connexion">
    Donnez un nom à la connexion (par exemple *EatNow*) et confirmez.
  </Step>

  <Step title="Copiez les deux identifiants">
    NowOS affiche une **clé API** et un **secret de webhook**.

    <Warning>
      Ces deux valeurs ne sont affichées **qu'une seule fois**. Copiez-les immédiatement dans un endroit sûr. Si vous les perdez, il faudra faire tourner la clé pour en générer de nouvelles.
    </Warning>
  </Step>
</Steps>

| Identifiant NowOS     | À quoi il sert                                                                                                 |
| --------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Clé API**           | Permet à EatNow d'envoyer vos réservations à la caisse.                                                        |
| **Secret de webhook** | Permet à EatNow de vérifier que les messages reçus viennent bien de votre caisse, et pas de quelqu'un d'autre. |

***

## Étape 2 — Saisir les identifiants dans EatNow

Dans EatNow, allez dans **Paramètres → Intégrations → Liste d'intégrations**.

<Steps>
  <Step title="Trouvez la carte NowOS">
    Descendez jusqu'à la section **Point de vente et logiciel de caisse (POS)**. La carte **NowOS** est la première de la liste. Cliquez sur **Connecter**.
  </Step>

  <Step title="Copiez l'URL du webhook EatNow">
    En haut de la fenêtre **Connecter NowOS**, le champ **URL du webhook EatNow** contient une adresse propre à votre restaurant. Cliquez sur **Copier**.

    Collez cette adresse dans le backoffice NowOS, sur la page **Integrations → Reservations**, à l'endroit prévu pour l'URL de webhook. C'est par là que la caisse préviendra EatNow de tout ce qui se passe en salle.
  </Step>

  <Step title="Renseignez la clé API">
    Collez dans le champ **Clé API** la clé récupérée à l'étape 1. Elle commence par `nowos_sk_live_`.
  </Step>

  <Step title="Renseignez le secret de signature">
    Collez dans le champ **Secret de signature des webhooks** le secret de webhook récupéré à l'étape 1.
  </Step>

  <Step title="Laissez l'URL de base vide">
    Le champ **URL de base (optionnel)** ne sert qu'aux environnements de test. Laissez-le vide : EatNow utilisera l'environnement NowOS standard.
  </Step>

  <Step title="Cliquez sur Connecter">
    Le message *NowOS connecté avec succès* confirme l'opération. Une pastille verte apparaît sur la carte NowOS.
  </Step>
</Steps>

<Note>
  Pour des raisons de sécurité, la clé API et le secret ne sont **jamais réaffichés** dans EatNow après l'enregistrement. Les champs apparaissent vides quand vous rouvrez la fenêtre : c'est normal.
</Note>

***

## Étape 3 — Associer vos tables

La connexion est établie, mais **les placements ne fonctionneront pas** tant que chaque table d'EatNow n'est pas reliée à sa jumelle dans NowOS.

<Card title="Associer vos tables" icon="layout-grid" href="/fr/nowos/table-mapping">
  L'étape suivante, indispensable. Comptez quelques minutes selon la taille de votre salle.
</Card>

***

## Étape 4 — Vérifier que tout fonctionne

<Steps>
  <Step title="Créez une réservation de test">
    Dans EatNow, créez une réservation pour aujourd'hui, avec un statut **Confirmé**, et attribuez-lui une table.
  </Step>

  <Step title="Regardez la caisse">
    Sur la caisse NowOS, ouvrez l'onglet **Tables**. Un bouton **Réservations** doit apparaître en haut à droite du plan de salle, et votre réservation de test doit s'y trouver. La table attribuée porte un **anneau ambre** avec le nom du client.
  </Step>

  <Step title="Placez la réservation depuis la caisse">
    Touchez la ligne, puis **Placer sur…**. La commande s'ouvre.
  </Step>

  <Step title="Revenez dans EatNow">
    La réservation de test doit être passée en **Assis**, sur la bonne table. Si c'est le cas, l'intégration fonctionne dans les deux sens.
  </Step>
</Steps>

<Tip>
  Pensez à supprimer la réservation de test ensuite — ou à la laisser se terminer normalement pour tester aussi l'encaissement.
</Tip>

***

## Mettre à jour ou faire tourner les identifiants

Si vous avez régénéré la clé API ou le secret côté NowOS :

1. Allez dans **Paramètres → Intégrations → Liste d'intégrations**.
2. Sur la carte **NowOS**, cliquez sur **Connecter** (la fenêtre s'ouvre en mode modification).
3. Saisissez les **nouveaux** identifiants.
4. Cliquez sur **Mettre à jour**.

<Warning>
  Faire tourner la clé côté NowOS coupe immédiatement l'ancienne. Mettez EatNow à jour dans la foulée, sinon les réservations cessent d'arriver sur la caisse.
</Warning>

***

## Déconnecter NowOS

Sur la carte **NowOS**, cliquez sur **Déconnecter**, puis confirmez.

<Warning>
  La déconnexion arrête immédiatement les échanges dans les deux sens. Les réservations déjà envoyées restent visibles sur la caisse, mais elles ne seront plus mises à jour, et les placements faits en salle ne remonteront plus dans EatNow.
</Warning>

Vos associations de tables sont conservées : si vous reconnectez plus tard le **même** établissement NowOS, vous n'aurez pas à les refaire.

***

## Problèmes fréquents à cette étape

<AccordionGroup>
  <Accordion title="Le bouton Connecter affiche « Non autorisé »">
    Votre rôle n'a pas la permission de créer une intégration. Demandez à un administrateur du restaurant, ou faites-vous attribuer le droit correspondant. Voir [Permissions](/fr/collaborators/permissions).
  </Accordion>

  <Accordion title="Je ne retrouve pas ma clé API NowOS">
    Elle n'est affichée qu'une fois. Retournez dans **Integrations → Reservations** du backoffice NowOS et faites tourner la clé pour en générer une nouvelle, puis mettez EatNow à jour.
  </Accordion>

  <Accordion title="La connexion est enregistrée mais rien n'arrive sur la caisse">
    Trois causes, dans l'ordre de fréquence :

    1. **Le plan de salle NowOS n'est pas publié** — les réservations sans table arrivent quand même, mais rien ne s'affiche sur le plan.
    2. **Les tables ne sont pas associées** — voir [Associer vos tables](/fr/nowos/table-mapping).
    3. **Les réservations sont encore en attente** — une réservation au statut *En attente* ou *En attente de paiement* n'est volontairement pas envoyée à la caisse. Seules les réservations **confirmées** (et au-delà) partent.
  </Accordion>

  <Accordion title="La caisse envoie des événements mais EatNow ne bouge pas">
    Vérifiez que l'**URL du webhook EatNow** a bien été collée dans NowOS, et que le **secret de signature** saisi dans EatNow est identique à celui affiché par NowOS. Un secret erroné fait rejeter tous les messages entrants.

    L'onglet **Webhook deliveries** du backoffice NowOS montre si les envois échouent.
  </Accordion>
</AccordionGroup>