Dépannage

Étapes

1. Ouvrez votre restaurant puis Restaurant › Agent vocal.
2. Vérifiez le bandeau de statut sur la carte de l'agent : il doit afficher « En ligne, répond aux appels » avec une pastille verte. S'il affiche « Hors ligne » (pastille grise), l'agent ne prend aucun appel.
3. Si l'agent est « Hors ligne », activez l'interrupteur (Switch) sur la carte de l'agent pour le repasser « En ligne ».
4. Vérifiez la section « Numéro de téléphone » : un numéro doit y être affiché. Si vous voyez le bouton « Assigner un numéro » à la place, c'est qu'aucun numéro n'est rattaché à l'agent, cliquez dessus pour en obtenir un.
5. Si l'activation échoue avec un message d'abonnement, vérifiez l'abonnement du restaurant (voir la cause « Restaurant non abonné » ci-dessous) puis réessayez.
6. Refaites un appel de test une fois l'agent « En ligne » et le numéro affiché.

Réglages

Statut de l'agent (interrupteur En ligne / Hors ligne)

Quand l'agent est « Hors ligne » (isActive = false), il ne répond à aucun appel entrant ; le widget et le site restent en service tant que le restaurant est en essai ou abonné. C'est le premier point à contrôler. L'activation est bloquée si le restaurant n'est pas abonné (1 agent actif par restaurant abonné).

Numéro de téléphone assigné

Sans numéro rattaché, aucun appel ne peut arriver jusqu'à l'agent. Le bouton « Assigner un numéro » prend le plus ancien numéro disponible dans le pool (FIFO) et le relie à l'agent. En cas de succès, le message « Numéro assigné avec succès » s'affiche. S'il n'apparaît pas, c'est qu'aucun numéro n'était disponible : contactez le support.

Restaurant non abonné

L'activation d'un agent exige que son restaurant soit abonné (1 agent actif par restaurant). Sans abonnement, l'activation est refusée avec « Ce restaurant n'est pas abonné » et un bouton « Abonner ce restaurant ».

Étapes

1. Vérifiez d'abord que vous regardez une date où le restaurant est censé ouvrir : un jour fermé ou hors de tout service n'affiche aucun créneau.
2. Ouvrez Réservations › Services et contrôlez que vos services sont bien configurés et actifs (jours, plages horaires / shifts). Sans aucun service actif, YumCall bascule sur vos horaires d'ouverture : s'ils sont vides eux aussi, aucun créneau ne peut être généré.
3. Si vous êtes en « Mode table », vérifiez que vous avez des tables actives (Réservations › Plan de salle). En mode table sans aucune table active, le calcul retombe automatiquement sur la capacité globale ; et si la capacité n'est pas non plus définie, rien ne s'affiche.
4. Regardez s'il y a une fermeture exceptionnelle ou une exception de calendrier sur la date concernée (un jour fermé est annoncé comme « Restaurant fermé », parfois avec une note publique).
5. Contrôlez le « Délai minimum avant réservation » : sur la journée en cours, tous les créneaux trop proches de l'heure actuelle sont masqués pour les canaux externes (widget, site, agent vocal).
6. Vérifiez que la capacité (ou les tables) n'est pas déjà entièrement réservée sur le créneau visé.

Réglages

Services configurés et actifs (jours + shifts)

Les créneaux sont générés à l'intérieur des plages horaires (shifts) de vos services actifs, pour les jours où le service s'applique. Un service inactif, sans shift, ou qui ne couvre pas le jour demandé, ne produit aucun créneau. En l'absence totale de service actif, YumCall utilise les horaires d'ouverture du restaurant comme repli (chemin « legacy »).

Mode table + tables actives

Si le « Mode table » est activé mais qu'aucune table n'est active, le système bascule silencieusement sur le calcul par capacité globale. À l'inverse, si vous avez des tables mais que le « Mode table » est désactivé, un bandeau d'avertissement s'affiche dans Réservations › Plan de salle (« Vos N tables ne sont pas utilisées pour le calcul des disponibilités »). Pour un vrai calcul par table, le « Mode table » doit être activé ET au moins une table doit être active.

Délai minimum avant réservation (bookingCutoffMinutes)

Empêche de réserver trop près du créneau, uniquement pour les réservations venant de l'extérieur (agent vocal, widget, site). Exemple : avec 45 minutes, à 11h30 il est déjà trop tard pour midi. Désactivable (valeur nulle ou 0 = aucun délai) ou réglable en minutes. Réglé au niveau du restaurant, et surchargeable par service. Ne s'applique pas si le restaurant est connecté à un prestataire externe (TheFork, ZenChef, SevenRooms), chaque prestataire gérant ses propres règles.

Fermetures et exceptions de calendrier

Une fermeture (vacances, jour férié) ou une exception de calendrier marquant un jour/service « fermé » retire les créneaux correspondants. Une fermeture sur toute la journée est annoncée comme « Restaurant fermé » ; une fermeture limitée à un service masque uniquement ce service (« pas de disponibilité pour ce service »).

Capacité / plafond de couverts

Un créneau disparaît quand la capacité du service (ou globale), le plafond de couverts simultanés, ou le rythme d'arrivées (max de personnes par tranche de 15 min) est atteint, compte tenu des réservations confirmées ET en attente.

Étapes

1. Identifiez le motif à partir de ce que le client a entendu (voir le tableau des messages ci-dessous) ou du créneau concerné.
2. Si c'est une question de capacité ou de rythme : ouvrez l'onglet « Réservations », vérifiez la capacité/le plafond du service et le nombre de réservations déjà prises sur ce créneau.
3. Si c'est une fermeture ou une exception : vérifiez vos fermetures et exceptions de calendrier sur la date concernée, et levez-la si elle n'est plus d'actualité.
4. Si c'est le délai minimum : le créneau était trop proche de l'heure de l'appel, proposez un horaire un peu plus tard, ou créez la réservation manuellement depuis le dashboard (le délai ne s'applique pas en interne).
5. Si c'est une question de zone (mode table) : vérifiez que les zones autorisées du service ne sont pas trop restrictives ou en conflit avec une exception de calendrier.

Réglages

« Excusez-moi, ce créneau vient juste d'être pris. Voulez-vous que je vérifie un autre horaire ? »

Motif : aucune disponibilité (capacité atteinte, plafond de couverts, rythme d'arrivées dépassé, plus de table libre, ou intersection de zones vide). L'agent propose un autre horaire. C'est le cas le plus courant quand le service se remplit.

« Désolé, le restaurant est fermé ce jour-là. Souhaitez-vous une autre date ? »

Motif : la date tombe sur une fermeture active ou sur une exception de calendrier marquant la journée entière comme fermée. L'agent propose une autre date.

« Désolé, c'est trop juste pour ce créneau. Souhaitez-vous un horaire un peu plus tard ? »

Motif : le créneau demandé est à l'intérieur du « Délai minimum avant réservation ». L'agent propose un horaire un peu plus tard. Ne se produit pas pour les restaurants connectés à un prestataire externe.

« Pardon, j'ai dû mal noter, on reprend ? »

Motif : données invalides (date/heure mal comprises, nombre de couverts incohérent, autre erreur de validation). L'agent recommence la prise d'information.

Étapes

1. Ouvrez Réservations › Règles et repérez la carte « Empreintes bancaires » (Stripe Connect).
2. Vérifiez le statut : il doit afficher « Compte Stripe connecté » (vert). S'il indique « Vérification Stripe en cours » (orange), cliquez sur « Continuer la vérification » pour terminer l'onboarding Stripe. S'il propose « Connecter Stripe », c'est qu'aucun compte n'est encore relié.
3. Une fois Stripe connecté et vérifié (chargesEnabled), ouvrez le service concerné et vérifiez que l'option « Exiger une empreinte carte » y est activée avec un montant valide (au moins 0,50 €).
4. Refaites un test de réservation via le widget ou l'agent vocal : l'empreinte doit alors être demandée.
5. Si l'empreinte échoue côté client, demandez-lui de réessayer depuis le lien (par SMS sur les réservations issues d'un appel, ou directement dans le widget) : la création de l'empreinte est conçue pour être relançable (idempotente).

Réglages

Stripe Connect, Compte connecté et vérifié (chargesEnabled)

Sans compte Stripe connecté et vérifié (onboarding terminé, chargesEnabled = true), aucune empreinte ne peut être demandée. Le toggle « Exiger une empreinte carte » d'un service reste d'ailleurs bloqué tant que Stripe n'est pas opérationnel, avec le message « Connectez votre compte Stripe pour encaisser les empreintes ». L'argent prélevé en cas de no-show arrive directement sur votre compte connecté.

Empreinte activée sur le service + montant positif

L'empreinte n'est demandée que si le service concerné a l'option « Exiger une empreinte carte » activée ET un montant strictement positif. Si le service ne l'a pas activée, aucune empreinte n'est demandée même si Stripe est connecté. Mode du montant : forfaitaire (flat) ou par couvert (per_guest).

Canal de la réservation

L'empreinte n'est exigée que sur les canaux publics (widget, site, agent vocal). Les réservations créées manuellement par le personnel et les walk-ins en sont exemptés : il est donc normal qu'aucune empreinte ne soit demandée pour une saisie interne.

Étapes

1. Ouvrez la fiche du restaurant et regardez son statut, à côté de son nom : « Essai terminé » ou « Résilié » coupe le widget et le site.
2. Abonnez-le : cliquez sur son statut, puis sur « Abonner ce restaurant » (ou « Se réabonner »). Le widget revient sans changer le code installé sur votre site.
3. Après l'abonnement, patientez quelques minutes : le widget embarqué est mis en cache côté navigateur.
4. Vérifiez que vous utilisez le bon identifiant d'agent dans le code d'intégration du widget (recopiez-le au besoin depuis Présence en ligne › Widget).
5. Rechargez la page de votre site pour forcer le rechargement du widget.

Réglages

Restaurant en essai ou abonné (condition d'affichage du widget)

Le widget récupère ses données via un endpoint public (/public/widget/agent/:id). Il répond tant que le restaurant de l'agent est en essai de 14 jours ou abonné (y compris en cas d'impayé, ou jusqu'à la date d'une résiliation programmée), que l'agent soit « En ligne » ou en pause. Une fois l'essai terminé, le restaurant résilié, ou avec un identifiant d'agent inconnu, l'endpoint répond « Agent not found or inactive » et le widget affiche « Widget indisponible ».

Apparence du widget (couleur, thème)

La couleur (par défaut #239772) et le thème (clair/sombre) du widget proviennent du widgetConfig enregistré dans le back-office. Les changements se propagent aux boutons flottants embarqués, sous réserve du cache d'environ 5 minutes.

Étapes

1. Sur la page de connexion, saisissez votre email et votre mot de passe dans l'onglet « Connexion ».
2. Si vous recevez un message « email à vérifier » (EMAIL_NOT_VERIFIED), ouvrez votre boîte mail : un code à 6 chiffres vous a été envoyé. Saisissez-le sur la page de vérification pour finir l'activation de votre compte.
3. Si le code est expiré ou perdu, demandez-en un nouveau depuis la page de vérification (le code est valable 15 minutes).
4. Si vous avez oublié votre mot de passe (ou n'en avez jamais défini, par exemple après une inscription via l'onboarding), utilisez « Mot de passe oublié » : vous recevez un lien valable 1 heure pour le définir ou le réinitialiser.
5. Si le message indique des identifiants invalides, vérifiez l'email (sans faute de frappe ni espace) et le mot de passe, puis réessayez.

Réglages

Email vérifié

Tant que l'email n'est pas confirmé, la connexion est refusée (403 EMAIL_NOT_VERIFIED) et un code de vérification (6 chiffres, valable 15 minutes) vous est envoyé. Au-delà de 5 tentatives de code erroné, il faut en redemander un nouveau.

Mot de passe

Doit faire au moins 8 caractères, avec au moins une minuscule, une majuscule et un chiffre. Les comptes créés via l'onboarding peuvent ne pas avoir de mot de passe au départ : il faut le définir via « Mot de passe oublié ».

Lien de réinitialisation / définition du mot de passe

Envoyé par email, valable 1 heure. Cliquer dessus prouve que vous êtes propriétaire de l'adresse : votre email est alors automatiquement marqué comme vérifié.