app2email API Precios

Documentación

Archivos de configuración

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.

En el panel

Cada integración tiene una sección Setup file:

IntegraciónDónde
Book-and-Payla pestaña Overview, al final
Order-and-Payla pestaña Import & export, al final
Tickets-and-Payla pestaña Settings, al final
Submit-Infola pestaña Settings, al final

Solo el propietario y los administradores de un número la ven.

  1. 1. Descargar

    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.

  2. 2. Cambiar

    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.

  3. 3. Subir

    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.

  4. 4. Aplicar

    Apply hace exactamente los cambios que mostró la comprobación. Una comprobación sigue siendo válida durante 1 hora.

  5. 5. Deshacer

    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.

Añadir y cambiar, o dejarlo exactamente como el archivo

Antes de subir, elija qué pasa con las cosas que el archivo no enumera:

  • Add and change (el valor predeterminado): las líneas del archivo se crean o se cambian y todo lo demás se queda como está. Un archivo con solo cinco líneas cambia solo esas cinco cosas.
  • Make it exactly like the file: se elimina todo lo del mismo tipo que el archivo no enumera. Un producto se archiva, nunca se elimina. La comprobación enumera cada eliminación antes de que aplique.

Copiar a otro número

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.

Note

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.

Qué contiene un archivo de configuración

IntegraciónLíneas
Book-and-Paybooking.settings (una línea por sección: horario, web, marca, mensajes ...), booking.service, booking.provider (personal)
Order-and-Payshop.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-Paytickets.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-Infosubmit.settings, submit.list, submit.connection, submit.form, submit.automation
Todasasset: una imagen, nombrada por las líneas que la usan

Nunca en un archivo

  • Secretos: claves de pago, contraseñas de conexión y tokens. Un secreto guardado se queda como está.
  • Activar una integración. Un archivo nunca hace eso, y un archivo nunca publica, cancela ni elimina un evento con entradas.
  • Lo que hicieron los clientes: reservas, pedidos, entradas vendidas, envíos de formularios, clientes, pagos.
  • Miembros del equipo e inicios de sesión del personal.
  • Las cifras de existencias de Order-and-Pay, a menos que marque Also set the stock figures from the file. Sin ello, un archivo que exportó por la mañana no puede deshacer las ventas del día.

El formato

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).

Imágenes

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.

Para agentes de IA y la API

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:

LlamadaQué hace
GET /v1/{number}/setup/guidetodos los tipos de registro, sus campos y límites, con ejemplos. Los agentes la leen primero
GET /v1/{number}/setup/exportel archivo actual: format=jsonl, zip o json
POST /v1/{number}/setup/checkcomprueba un archivo y no cambia nada: problemas por línea, el plan, un check_id
POST /v1/{number}/setup/applyaplica una comprobación: {"check_id": 123}
POST /v1/{number}/setup/assetsguarda una imagen durante 7 días y responde con su sha256
GET /v1/{number}/setup/jobslas últimas comprobaciones, aplicaciones y deshacer
POST /v1/{number}/setup/jobs/{id}/undodevuelve 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.

Tip

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.

Límites

QuéLímite
Un archivo20 MB de texto, 50 000 líneas (en el panel, una subida de 19 MB como máximo)
Una solicitud con imágenes dentro60 MB a través de la API
Una imagen5 MB
Imágenes descargadas por dirección100 por subida; Order-and-Pay descarga las imágenes de productos en segundo plano en unos minutos
Archivos grandesmás de 1000 registros se comprueban y se aplican en segundo plano; el panel los espera por sí solo
Una comprobaciónse puede aplicar dentro de 1 hora, una vez
Deshacer30 días