Un archivo de configuración contiene toda la configuración de una integración en un solo archivo de texto. Descárguelo como copia de seguridad, cambie muchas cosas a la vez, copie una configuración a otro número o deje que un agente de IA lo configure todo mediante la API o MCP. Cada subida se comprueba primero y se puede deshacer.
Un archivo de configuración contiene todo lo que configura en una integración: los ajustes, los servicios y el personal de Book-and-Pay, las categorías, opciones y productos de Order-and-Pay, los eventos, las fechas y los tipos de entrada de Tickets-and-Pay, y los formularios y automatizaciones de Submit-Info. Es un único archivo de texto, así que puede guardarlo como copia de seguridad, cambiarlo en cualquier editor, subirlo de nuevo o copiarlo a otro de sus números.
El mismo archivo funciona en tres lugares: el panel, la API y el servidor MCP para agentes de IA.
Cada integración tiene una sección Setup file:
| Integración | Dónde |
|---|---|
| Book-and-Pay | la pestaña Overview, al final |
| Order-and-Pay | la pestaña Import & export, al final |
| Tickets-and-Pay | la pestaña Settings, al final |
| Submit-Info | la pestaña Settings, al final |
Solo el propietario y los administradores de un número la ven.
Download da la configuración como un archivo .a2e.jsonl. Download with pictures da un .zip con el mismo archivo y todas las imágenes dentro: una copia de seguridad completa sin conexión que puede volver a subir tal cual.
Abra el archivo en un editor de texto y cambie, añada o quite líneas. Cada línea es una cosa: un servicio, un producto, un evento. No hace falta una hoja de cálculo.
Upload a file lo comprueba primero. Todavía no cambia nada. Ve cada problema con su número de línea y cómo corregirlo, o lo que haría aplicar el archivo: cuántas cosas son nuevas, cambiadas o eliminadas, y cuáles.
Apply hace exactamente los cambios que mostró la comprobación. Una comprobación sigue siendo válida durante 1 hora.
Cada aplicación aparece en Recent changes by setup file. Undo devuelve todo lo que cambió esa aplicación, durante 30 días, siempre que ninguna aplicación posterior haya cambiado la misma integración. Deshaga primero la posterior.
Antes de subir, elija qué pasa con las cosas que el archivo no enumera:
Si es propietario o administrador de más de un número, Copy to another number copia la configuración de una integración desde el número en el que está a otro: una segunda sucursal, un número de prueba o una plantilla que da a cada tienda nueva.
La copia se comprueba primero en el otro número y muestra lo que cambiaría allí. Copy now la aplica. Las imágenes van con ella. Para deshacer una copia, abra la misma integración en el otro número: la copia figura allí en Recent changes.
La dirección web de Book-and-Pay, Order-and-Pay y Tickets-and-Pay pertenece a un solo número y nunca se copia. Fije la dirección del otro número en su propio panel.
| Integración | Líneas |
|---|---|
| Book-and-Pay | booking.settings (una línea por sección: horario, web, marca, mensajes ...), booking.service, booking.provider (personal) |
| Order-and-Pay | shop.settings (una línea por sección, incluido el aspecto de la página de pedidos), shop.category, shop.option_group, shop.item (con variantes e imágenes) |
| Tickets-and-Pay | tickets.settings (una línea por sección; wa_templates son sus propias palabras para los mensajes de WhatsApp), tickets.chart (planos de asientos guardados), tickets.event (con sus fechas, tipos de entrada, límites compartidos, imágenes y plano de asientos), tickets.promo |
| Submit-Info | submit.settings, submit.list, submit.connection, submit.form, submit.automation |
| Todas | asset: una imagen, nombrada por las líneas que la usan |
Nunca en un archivo
Un archivo de configuración es JSON Lines: un objeto JSON por línea. La primera línea dice qué es el archivo; cada una de las demás líneas es un registro con un type y una key. La clave encuentra el mismo registro la próxima vez: el id de un servicio, el SKU de un producto, la dirección de un evento.
{"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"]}El orden de las líneas no importa. Los precios de Book-and-Pay son importes (25 es 25,00 y price es la etiqueta que se muestra junto a él); los precios de Order-and-Pay y Tickets-and-Pay están en la unidad más pequeña de la moneda (1250 es 12,50). Los campos exactos de cada línea están en la guía de la API (GET /v1/{number}/setup/guide).
Un registro nombra una imagen por la clave de una línea asset. La imagen viene de una de estas fuentes:
url: una dirección https://, que descargamos nosotros.data: la imagen misma, en base64.file: una ruta dentro del .zip subido.sha256: una imagen que este número ya tiene.Una exportación escribe la dirección pública de cada imagen. Una imagen que no tiene dirección pública, como la imagen del suelo detrás de un plano de asientos, recibe un enlace firmado que funciona 7 días, así que un archivo copiado a otro número la lleva consigo.
{"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"]}Las imágenes son PNG, JPEG o WEBP, de 5 MB como máximo cada una. Donde una integración lo necesita, una imagen se hace más pequeña o se convierte en JPEG: un logotipo de Book-and-Pay hasta ajustarse a 300 KB, una imagen de Tickets-and-Pay hasta ajustarse a 1 MB.
Un agente configura toda una integración en un único paso comprobado en lugar de docenas de llamadas. El servidor MCP https://api.app2email.com/mcp/setup tiene estas herramientas: get_setup_guide, export_setup, check_setup, apply_setup, upload_setup_asset, list_setup_jobs, get_setup_job y undo_setup. Las mismas llamadas están en la API:
| Llamada | Qué hace |
|---|---|
GET /v1/{number}/setup/guide | todos los tipos de registro, sus campos y límites, con ejemplos. Los agentes la leen primero |
GET /v1/{number}/setup/export | el archivo actual: format=jsonl, zip o json |
POST /v1/{number}/setup/check | comprueba un archivo y no cambia nada: problemas por línea, el plan, un check_id |
POST /v1/{number}/setup/apply | aplica una comprobación: {"check_id": 123} |
POST /v1/{number}/setup/assets | guarda una imagen durante 7 días y responde con su sha256 |
GET /v1/{number}/setup/jobs | las últimas comprobaciones, aplicaciones y deshacer |
POST /v1/{number}/setup/jobs/{id}/undo | devuelve lo que cambió una aplicación |
La clave necesita el permiso propio de la integración: bookings:manage, orders:manage, tickets:manage o submissions:manage. Una clave de sandbox puede exportar y comprobar, pero no aplicar.
El ciclo habitual de un agente: leer la guía, exportar el archivo actual, cambiar unas pocas líneas, comprobar, corregir lo que informe la comprobación y luego preguntar al usuario antes de aplicar el check_id.
| Qué | Límite |
|---|---|
| Un archivo | 20 MB de texto, 50 000 líneas (en el panel, una subida de 19 MB como máximo) |
| Una solicitud con imágenes dentro | 60 MB a través de la API |
| Una imagen | 5 MB |
| Imágenes descargadas por dirección | 100 por subida; Order-and-Pay descarga las imágenes de productos en segundo plano en unos minutos |
| Archivos grandes | más de 1000 registros se comprueban y se aplican en segundo plano; el panel los espera por sí solo |
| Una comprobación | se puede aplicar dentro de 1 hora, una vez |
| Deshacer | 30 días |