app2email API Tarifs

Documentation

Fichiers de configuration

Un fichier de configuration contient toute la configuration d'une intégration dans un seul fichier texte. Téléchargez-le comme sauvegarde, modifiez beaucoup d'éléments d'un coup, copiez une configuration vers un autre numéro, ou laissez un agent IA tout configurer via l'API ou MCP. Chaque import est d'abord vérifié et peut être annulé.

Un fichier de configuration contient tout ce que vous configurez dans une intégration : les paramètres, les services et le personnel de Book-and-Pay, les catégories, options et produits d'Order-and-Pay, les événements, dates et types de billets de Tickets-and-Pay, ainsi que les formulaires et automatisations de Submit-Info. C'est un seul fichier texte : vous pouvez donc le garder comme sauvegarde, le modifier dans n'importe quel éditeur, l'importer de nouveau ou le copier vers un autre de vos numéros.

Le même fichier fonctionne à trois endroits : le tableau de bord, l'API et le serveur MCP pour les agents IA.

Dans le tableau de bord

Chaque intégration a une section Fichier de configuration :

IntégrationOù
Book-and-Payl'onglet Vue d'ensemble, tout en bas
Order-and-Payl'onglet Import et export, tout en bas
Tickets-and-Payl'onglet Paramètres, tout en bas
Submit-Infol'onglet Paramètres, tout en bas

Seuls le propriétaire et les administrateurs d'un numéro la voient.

  1. 1. Télécharger

    Télécharger donne la configuration sous forme de fichier .a2e.jsonl. Télécharger avec les images donne un .zip contenant le même fichier et toutes les images : une sauvegarde hors ligne complète que vous pouvez réimporter telle quelle.

  2. 2. Modifier

    Ouvrez le fichier dans un éditeur de texte et modifiez, ajoutez ou supprimez des lignes. Chaque ligne est une chose : un service, un produit, un événement. Un tableur n'est pas nécessaire.

  3. 3. Importer

    Importer un fichier le vérifie d'abord. Rien ne change encore. Vous voyez chaque problème avec son numéro de ligne et la façon de le corriger, ou ce que l'application ferait : combien d'éléments sont nouveaux, modifiés ou supprimés, et lesquels.

  4. 4. Appliquer

    Appliquer effectue exactement les changements montrés par la vérification. Une vérification reste valable 1 heure.

  5. 5. Annuler

    Chaque application est listée sous Modifications récentes par fichier de configuration. Annuler remet en place tout ce que cette application a changé, pendant 30 jours, tant qu'aucune application ultérieure n'a modifié la même intégration. Annulez d'abord la plus récente.

Ajouter et modifier, ou rendre identique au fichier

Avant d'importer, choisissez ce qui arrive aux éléments que le fichier ne liste pas :

  • Ajouter et modifier (par défaut) : les lignes du fichier sont créées ou modifiées, tout le reste est inchangé. Un fichier de cinq lignes seulement ne change que ces cinq éléments.
  • Rendre identique au fichier : tout élément du même type que le fichier ne liste pas est retiré. Un produit est archivé, jamais supprimé. La vérification liste chaque suppression avant que vous appliquiez.

Copier vers un autre numéro

Si vous êtes propriétaire ou administrateur de plus d'un numéro, Copier vers un autre numéro copie la configuration d'une intégration du numéro sur lequel vous êtes vers un autre : une deuxième succursale, un numéro de test, ou un modèle que vous donnez à chaque nouvelle boutique.

La copie est d'abord vérifiée sur l'autre numéro et montre ce qu'elle y changerait. Copier maintenant l'applique. Les images suivent. Pour annuler une copie, ouvrez la même intégration sur l'autre numéro : la copie y est listée sous Modifications récentes.

Note

L'adresse web de Book-and-Pay, d'Order-and-Pay et de Tickets-and-Pay appartient à un seul numéro et n'est jamais copiée. Définissez l'adresse de l'autre numéro dans son propre tableau de bord.

Ce que contient un fichier de configuration

IntégrationLignes
Book-and-Paybooking.settings (une ligne par section : horaires, web, marque, messages ...), booking.service, booking.provider (personnel)
Order-and-Payshop.settings (une ligne par section, y compris l'apparence de la page de commande), shop.category, shop.option_group, shop.item (avec variantes et images)
Tickets-and-Paytickets.settings (une ligne par section ; wa_templates est votre propre formulation des messages WhatsApp), tickets.chart (plans de salle enregistrés), tickets.event (avec ses dates, types de billets, limites partagées, images et plan de salle), tickets.promo
Submit-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Toutesasset : une image, nommée par les lignes qui l'utilisent

Jamais dans un fichier

  • Les secrets : clés de paiement, mots de passe de connexion et jetons. Un secret enregistré reste tel quel.
  • L'activation d'une intégration. Un fichier ne le fait jamais, et un fichier ne publie, n'annule ni ne supprime jamais un événement avec billetterie.
  • Ce que les clients ont fait : réservations, commandes, billets vendus, soumissions, clients, paiements.
  • Les membres de l'équipe et les identifiants du personnel.
  • Les chiffres de stock d'Order-and-Pay, sauf si vous cochez Définir aussi les stocks à partir du fichier. Sans cela, un fichier exporté le matin ne peut pas annuler les ventes de la journée.

Le format

Un fichier de configuration est au format JSON Lines : un objet JSON par ligne. La première ligne indique ce qu'est le fichier ; chaque autre ligne est un enregistrement avec un type et une key. La clé permet de retrouver le même enregistrement la fois suivante : l'identifiant d'un service, le SKU d'un produit, l'adresse d'un événement.

{"type":"a2e.setup","version":1,"products":["booking"]}
{"type":"booking.service","key":"haircut","name":"Haircut","duration_min":30,"price":"$25","price_amount":25}
{"type":"booking.service","key":"beard","name":"Beard trim","duration_min":15,"price":"$12","price_amount":12}
{"type":"booking.provider","key":"sam","name":"Sam","services":["haircut","beard"]}

L'ordre des lignes n'a pas d'importance. Les prix de Book-and-Pay sont des montants (25 vaut 25,00, price est le libellé affiché à côté) ; les prix d'Order-and-Pay et de Tickets-and-Pay sont exprimés dans la plus petite unité de la devise (1250 vaut 12,50). Les champs exacts de chaque ligne figurent dans le guide de l'API (GET /v1/{number}/setup/guide).

Images

Un enregistrement désigne une image par la clé d'une ligne asset. L'image provient de l'un de ces éléments :

  • url : une adresse https://, récupérée par nos soins.
  • data : l'image elle-même, en base64.
  • file : un chemin à l'intérieur du .zip importé.
  • sha256 : une image que ce numéro possède déjà.

Un export écrit l'adresse publique de chaque image. Une image qui n'a pas d'adresse publique, comme l'image du sol derrière un plan de salle, reçoit un lien signé valable 7 jours : un fichier copié vers un autre numéro la conserve donc.

{"type":"asset","key":"classic-photo","url":"https://example.com/classic.jpg"}
{"type":"shop.item","key":"BURGER-CLASSIC","name":"Classic burger","category":"burgers","price":1250,"images":["classic-photo"]}

Les images sont au format PNG, JPEG ou WEBP, de 5 Mo au plus chacune. Là où une intégration en a besoin, une image est réduite ou convertie en JPEG : un logo de Book-and-Pay pour tenir en 300 Ko, une image de Tickets-and-Pay pour tenir en 1 Mo.

Pour les agents IA et l'API

Un agent configure toute une intégration en une seule étape vérifiée au lieu de dizaines d'appels. Le serveur MCP https://api.app2email.com/mcp/setup a ces outils : get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job et undo_setup. Les mêmes appels existent dans l'API :

AppelCe qu'il fait
GET /v1/{number}/setup/guidetous les types d'enregistrements, leurs champs et leurs limites, avec des exemples. Les agents le lisent en premier
GET /v1/{number}/setup/exportle fichier actuel : format=jsonl, zip ou json
POST /v1/{number}/setup/checkvérifie un fichier et ne change rien : problèmes par ligne, le plan, un check_id
POST /v1/{number}/setup/applyapplique une vérification : {"check_id": 123}
POST /v1/{number}/setup/assetsstocke une image pendant 7 jours et répond avec son sha256
GET /v1/{number}/setup/jobsles dernières vérifications, applications et annulations
POST /v1/{number}/setup/jobs/{id}/undoremet en place ce qu'une application a changé

La clé a besoin de la permission propre à l'intégration : bookings:manage, orders:manage, tickets:manage ou submissions:manage. Une clé sandbox peut exporter et vérifier, mais pas appliquer.

Tip

La boucle habituelle d'un agent : lire le guide, exporter le fichier actuel, modifier quelques lignes, vérifier, corriger ce que la vérification signale, puis demander à l'utilisateur avant d'appliquer le check_id.

Limites

QuoiLimite
Un fichier20 Mo de texte, 50 000 lignes (dans le tableau de bord, un import de 19 Mo au plus)
Une requête avec des images à l'intérieur60 Mo via l'API
Une image5 Mo
Images récupérées par adresse100 par import ; Order-and-Pay récupère les images des produits en arrière-plan en quelques minutes
Gros fichiersplus de 1 000 enregistrements sont vérifiés et appliqués en arrière-plan ; le tableau de bord les attend de lui-même
Une vérificationpeut être appliquée dans l'heure, une seule fois
Annulation30 jours