app2email API Precios

Documentación

Submit-Info

La guía de Submit-Info: cree un formulario a partir de una lista de preguntas, publíquelo en WhatsApp y en una página web, gestione los envíos por etapas en una bandeja compartida con roles, automatice respuestas y llamadas a sus propios sistemas, y configure todo mediante la API o un agente de IA.

Usted escribe un formulario como una simple lista de preguntas. app2email lo convierte en un formulario dentro de WhatsApp y en una página web con los mismos pasos. Un cliente, o un miembro de su propio personal de campo, lo rellena y recibe una referencia. Las respuestas y los archivos se convierten en un envío en una bandeja compartida, donde avanza por sus etapas y activa sus automatizaciones.

Una sola idea

Formulario, luego envío, luego etapas, luego automatizaciones, luego conexiones. Una solicitud de presupuesto, una candidatura, una lectura de contador, un informe de problema, un trabajo terminado, una prueba de entrega y un recibo de gastos son todos lo mismo, con preguntas distintas y nombres de etapa distintos. Cada uno viene como una plantilla que puede instalar y cambiar.

Empiece en cinco minutos

  1. Ábralo: en su panel abra la página Submit-Info (/dashboard/app/submit, que también se abre desde Integrations). Actívela.
  2. Cree un formulario: elija "New form" y escoja una plantilla, o empiece en blanco. Dele un nombre y escriba sus preguntas. Cada pregunta es una fila: su texto, su tipo y si debe responderse.
  3. Publique: "Publish to WhatsApp" sube el formulario a WhatsApp y lo activa. La página web con los mismos pasos queda activa al instante.
  4. Comparta: en Share encuentra la palabra que abre el formulario en su chat, un enlace que abre su chat con esa palabra escrita, la dirección de la página web, un código QR y un fragmento para poner el formulario en su propio sitio web.
  5. Trabaje la bandeja: los envíos nuevos llegan al Inbox. Abra uno, cambie su etapa, responda. Invite a su equipo cuando esté listo.

No cambia nada para un número que nunca abre Submit-Info. Un formulario que aún no está publicado en WhatsApp funciona igualmente: su palabra responde con el enlace de la página web.

El creador de formularios

Un formulario tiene de 1 a 12 pasos, y un paso tiene un título y de 1 a 12 preguntas. No hay lienzo ni nada que dibujar: la misma lista impulsa el formulario en WhatsApp, la página web, las comprobaciones de las respuestas, las columnas de la vista de tabla, las exportaciones y la API. La vista previa junto al editor muestra el formulario tal como lo ve una persona.

TipoQué da la personaQué puede fijar
textUna respuesta cortalongitud mínima y máxima, un patrón
textareaUna respuesta más largalongitud mínima y máxima
numberUn númerovalor más bajo y más alto, decimales, una unidad como kWh
emailUna dirección de correo
phoneUn número de teléfono
dateUna fechacuántos días hacia atrás o hacia delante puede ser
selectUna opciónlas opciones (de 2 a 200), o una lista suya
multiselectVarias opcioneslas opciones (de 2 a 20), mínimo y máximo que se pueden marcar
yesnoSí o No
ratingUna nota de 1 hasta 3-10la nota más alta
consentUna frase que aceptarsi debe estar marcada
photoUna o más fotoscuántas (de 1 a 10); cámara, galería o ambas
documentUno o más archivoscuántos (de 1 a 10); cualquier archivo, PDF, imágenes o archivos de ofimática
locationDónde está la personaen WhatsApp, la solicitud de ubicación; en la web, un botón y una línea de dirección
infoTexto que usted muestrano se pregunta ni se guarda nada
hiddenUn valor que viene con el enlacecomo un número de trabajo; no se muestra nada
  • Texto de ayuda y valores predeterminados: cada pregunta puede llevar una pista corta y un valor predeterminado. Un valor predeterminado puede usar lo que ya sabe, como {contact.name}.
  • Mostrar solo cuando: un paso o una pregunta pueden depender de una respuesta anterior ("mostrar este paso solo cuando Problem es Yes"). WhatsApp y la página web siguen la misma regla.
  • Campos internos: campos que nunca se preguntan. Su equipo o una automatización los rellena: un importe de presupuesto, el motivo de una decisión, un id que volvió de otro sistema. Solo se muestran en la bandeja y en las exportaciones.
  • Listas: una pregunta de opciones puede tomar sus opciones de una lista suya (sedes, trabajos, productos con precios). Cambie la lista en el panel o mediante la API y el formulario la sigue, sin necesidad de publicar de nuevo.
  • Valores calculados: una fórmula sobre las respuestas, para una estimación instantánea o una comprobación. Consulte fórmulas.
  • Después de enviar: una pantalla de revisión antes de enviar, la respuesta con la referencia, un botón "Add more" que adjunta al envío los mensajes siguientes (texto, fotos, archivos) durante diez minutos, y el enlace a la página de estado de la propia persona.
  • Publicación: app2email escribe el formulario de WhatsApp por usted, divide un paso largo en varias pantallas cuando los límites de WhatsApp lo piden, y conserva las últimas cinco versiones publicadas para que un mensaje antiguo siga abriendo el formulario con el que se envió.

La página web. Los mismos pasos en /form/your-code/form-key. Pide al final un nombre y un número de WhatsApp. Tras enviar, la persona ve la referencia y puede tocar "Get updates on WhatsApp", que confirma su número con un mensaje; un formulario puede configurarse para exigirlo. Un enlace personal (enviado por usted) ya sabe quién es la persona. Para poner el formulario en su propio sitio, use el fragmento de Share; si el formulario pide una ubicación, añada allow="geolocation" al iframe. Las fotos se reducen en el navegador antes de subirse; un archivo puede ser de hasta 10 MB.

Cómo llega la gente a un formulario

  • Una palabra: cada formulario tiene sus propias palabras. Las palabras form, forms, report y submit (puede cambiarlas) enumeran sus formularios como un menú cuando hay varios. Una palabra solo cuenta en un mensaje corto: uno con menos de 10 palabras más (Settings, "Ignore the words in long messages"), así que un mensaje largo que contenga una por casualidad no pone nada en marcha.
  • Un enlace o un código QR: un enlace que abre su chat de WhatsApp con la palabra del formulario, o la dirección de la página web.
  • Enviado por usted: "Send form" en la bandeja, o la API, envía un formulario a un número, con valores ya rellenados (un número de trabajo, una cuenta, los documentos que quiere).
  • Un seguimiento: una automatización o un miembro del equipo pide más datos con un segundo formulario. Lo que vuelve se adjunta al primer envío.
  • La página web, y la API para sistemas que ya tienen los datos.

Quién puede enviar. Cualquiera (la opción habitual), o solo los números que usted enumere o los contactos con una etiqueta suya. Así es como un formulario se queda con su personal de campo. La palabra status responde a una persona con la etapa de sus envíos recientes.

Etapas

Las etapas pertenecen al formulario. Un formulario nuevo empieza con New, In progress y Done; cámbieles el nombre, añada las suyas (de 2 a 12) y elija un color. Cada etapa es de uno de tres tipos: abierta, terminada o cancelada.

  • Quién puede elegirla: reserve una etapa para ciertos roles. Un Agent prepara, solo un Manager aprueba.
  • Nota obligatoria: pida un motivo cuando un envío se mueve allí (rechazado, denegado, consultado).
  • Mensaje: un texto enviado a la persona cuando su envío llega a la etapa, con marcadores de posición.
  • Botones para la persona: una respuesta puede llevar hasta tres botones (Accept, Decline, "Not fixed yet"), y cada uno cambia la etapa. Esa sola pieza le da la aceptación de presupuestos, la confirmación de una visita y el "¿está arreglado?".

Una respuesta escrita fuera del tiempo de respuesta de WhatsApp se conserva y se entrega cuando la persona escribe de nuevo. La bandeja lo indica en la respuesta.

La bandeja y los roles

El Inbox muestra Open, Mine, Unassigned, Done y All, además de las vistas que usted guarde. Busque y filtre por formulario, etapa, responsable, etiqueta, canal y fecha. Tres diseños: una lista, una tabla (un formulario: cada pregunta es una columna) y un tablero (un formulario: una columna por cada etapa). Marque varias filas para cambiar la etapa, asignar, etiquetar, exportar o eliminarlas juntas.

Un envío muestra sus respuestas, sus archivos, desde dónde se envió y un único historial de todo lo que le pasó: cambios de etapa con quién y por qué, notas, respuestas en ambos sentidos, archivos y cada paso de automatización con su resultado. Abajo escribe una nota interna o una respuesta de WhatsApp. Exporte cualquier vista como CSV, Excel o JSON, y un envío como PDF.

Su equipo. Invite a personas por correo solo a la bandeja. Reciben una app ligera propia en /desk y nunca ven el resto de su cuenta. Un rol es un conjunto inicial de permisos, y cada permiso se puede activar o desactivar para una persona.

RolEmpieza con
Owner, AdminTodo, incluidos formularios, automatizaciones, conexiones y el equipo
ManagerNotas, respuestas, editar respuestas, cambiar la etapa, asignar, archivos, exportar, eliminar, ejecutar acciones manuales
AgentNotas, respuestas, editar respuestas, cambiar la etapa, archivos, ejecutar acciones manuales. Puede quedarse un envío
ViewerPuede leer, nada más

También puede limitar lo que ve una persona: solo algunos formularios, solo lo que se le asigna (con o sin los no asignados para recoger) y los datos de contacto ocultos. Cada acción de un miembro del equipo se escribe en el historial del envío.

La página de la propia persona. Cada envío tiene una página privada en /s/a-long-code, sin inicio de sesión: la etapa, los mensajes y cambios de etapa hasta ahora, su pregunta abierta con sus botones, y "Add information" cuando el formulario lo permite. Las notas internas y los campos internos nunca aparecen en ella.

Privacidad. Borrar un contacto borra sus envíos y archivos. Un formulario puede tener un tiempo de conservación, tras el cual se borran los envíos cerrados.

Automatizaciones

Una automatización se lee como una frase: cuando pasa algo, si algunas cosas son ciertas, haz estas cosas en orden. "Cuando se envía una Quote request, si la cantidad es 20 o más, asígnala a los Managers y envía un correo al propietario."

CuandoSe ejecuta cuando
submittedun envío está completo y sus archivos han llegado
status_changedla etapa cambió (opcionalmente: hacia o desde ciertas etapas)
assignedcambió la persona a la que está asignado
updatedse editaron respuestas o campos internos
note_addedun miembro del equipo escribió una nota
file_addedse añadió un archivo más tarde
customer_repliedla persona que lo envió añadió texto o archivos
buttonla persona pulsó un botón de una de sus respuestas
overduesigue en la misma etapa después de un número de minutos
duepasó su hora límite mientras estaba abierto
manualun miembro del equipo pulsa el botón de la acción en el envío

Si: reglas sobre respuestas, valores calculados, la etapa, el canal, las etiquetas y el responsable. Una regla es un campo, un operador y un valor: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Una las reglas con all (y) o any (o).

HazQué hace
set_statusmoverlo a una etapa, con una nota
assigna un miembro, por turnos entre un rol, al menos ocupado de un rol, o a nadie
set_field, calculateescribir un campo interno, o calcularlo con una fórmula
tag, set_priority, set_dueetiquetas, prioridad, una hora límite
replyun mensaje de WhatsApp a la persona, con hasta 3 botones que cambian cada uno la etapa, un archivo, o el enlace a su página de estado
ask_locationpedir a la persona que comparta dónde está
send_formenviar un formulario de seguimiento; lo que vuelve se adjunta a este envío
emailal propietario, al responsable, a la persona o a cualquier dirección, con los archivos adjuntos
notifyun correo al responsable, a un rol o a todo el equipo
http, openapi, mcpllamar a una conexión y guardar partes de la respuesta en campos
waitcontinuar más tarde, solo si las condiciones siguen cumpliéndose
stopterminar aquí

Cada ejecución se registra paso a paso: qué se envió, qué volvió y cuánto tardó. "Try with a submission" ejecuta una automatización con un envío real sin cambiar ni enviar nada. Una llamada a un sistema externo que falla se reintenta tras 1 minuto, 10 minutos y 1 hora; después la automatización se marca como fallida y sus webhooks reciben submit.automation_failed. Las automatizaciones que se activan unas a otras se detienen tras tres niveles.

Receta 1: los presupuestos grandes van a un manager

{
  "name": "Large quotes go to a manager",
  "form": "quote_request",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "all": [
      {
        "field": "quantity",
        "gte": 20
      }
    ]
  },
  "actions": [
    {
      "type": "assign",
      "to": "role:manager"
    },
    {
      "type": "set_priority",
      "priority": "high"
    },
    {
      "type": "email",
      "to": [
        "owner"
      ],
      "subject": "Large quote {reference}",
      "body": "{contact.name} asked for a quote.\n\n{answers}\n\n{desk_link}",
      "attach_files": true
    }
  ]
}

Receta 2: enviar el presupuesto, pedir una respuesta, recordar a los tres días

quote_amount es un campo interno que su equipo rellena antes de pasar el envío a Quoted. El recordatorio sale solo si el envío sigue en Quoted.

{
  "name": "Send the quote and ask for an answer",
  "form": "quote_request",
  "enabled": true,
  "trigger": "status_changed",
  "options": {
    "to": [
      "quoted"
    ],
    "from": []
  },
  "conditions": {
    "field": "status",
    "equals": "quoted"
  },
  "actions": [
    {
      "type": "reply",
      "text": "Your quote {reference}: {quote_amount}. Would you like to go ahead?",
      "link": true,
      "buttons": [
        {
          "id": "accept",
          "title": "Accept",
          "set_status": "accepted"
        },
        {
          "id": "decline",
          "title": "Decline",
          "set_status": "declined"
        }
      ]
    },
    {
      "type": "wait",
      "minutes": 4320
    },
    {
      "type": "reply",
      "text": "A reminder about your quote {reference}. Tap Accept or Decline, or write to us with any question."
    }
  ]
}

Receta 3: apartar una lectura de contador que parece errónea

usage es un valor calculado: reading - previous('reading').

{
  "name": "Query a reading that looks wrong",
  "form": "meter_reading",
  "enabled": true,
  "trigger": "submitted",
  "options": {},
  "conditions": {
    "any": [
      {
        "field": "usage",
        "lt": 0
      },
      {
        "field": "usage",
        "gt": 2000
      }
    ]
  },
  "actions": [
    {
      "type": "set_status",
      "status": "queried",
      "note": "Usage {usage} kWh is outside the usual range."
    },
    {
      "type": "notify",
      "to": "role:manager",
      "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
    }
  ]
}

Conexiones

Una conexión es un sistema externo al que una automatización puede llamar. Los webhooks de su cuenta no necesitan ninguna: reciben cada evento de envío a medida que ocurre (consulte los eventos). Para todo lo demás hay tres tipos. "Test" en una conexión, y "Try with a submission" en una acción, muestran la solicitud real y la respuesta real antes de activar nada.

Solicitud HTTP

Una dirección base y una forma de iniciar sesión (ninguna, un token bearer, un encabezado, usuario y contraseña, o una clave en la dirección). La acción indica el método, la ruta y un cuerpo JSON. save guarda partes de la respuesta en campos del envío.

{
  "key": "billing",
  "name": "Billing",
  "kind": "http",
  "base_url": "https://billing.example.com/api",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_BILLING_TOKEN"
  },
  "enabled": true
}
{
  "type": "http",
  "connection": "billing",
  "method": "POST",
  "path": "/readings",
  "body": {
    "meter": "{meter_no}",
    "reading": "{reading}",
    "usage": "{usage}",
    "reference": "{reference}",
    "photo": "{files.photo}"
  },
  "save": {
    "billing_id": "$.id"
  },
  "on_fail": "retry"
}

Documento OpenAPI

Indique la dirección de un documento OpenAPI 3 en JSON, o péguelo. app2email lee sus operaciones; la acción elige una por su id y rellena sus parámetros. Los documentos YAML y Swagger 2 no se leen.

{
  "key": "helpdesk",
  "name": "Helpdesk",
  "kind": "openapi",
  "base_url": "https://helpdesk.example.com/api",
  "spec_url": "https://helpdesk.example.com/openapi.json",
  "auth": {
    "type": "header",
    "name": "X-Api-Token",
    "secret": "YOUR_HELPDESK_TOKEN"
  },
  "enabled": true
}
{
  "type": "openapi",
  "connection": "helpdesk",
  "operation": "createTicket",
  "params": {
    "title": "Problem {reference}: {category}",
    "description": "{description}",
    "reporter": "{contact.phone}"
  },
  "save": {
    "ticket_id": "$.id"
  },
  "on_fail": "retry"
}

Servidor MCP

Indique la dirección de un servidor MCP (HTTP en streaming) y su token. app2email enumera las herramientas del servidor; la acción elige una y rellena sus argumentos. $text guarda como texto toda la respuesta de la herramienta.

{
  "key": "dispatch",
  "name": "Dispatch",
  "kind": "mcp",
  "base_url": "https://dispatch.example.com/mcp",
  "auth": {
    "type": "bearer",
    "secret": "YOUR_DISPATCH_TOKEN"
  },
  "enabled": true
}
{
  "type": "mcp",
  "connection": "dispatch",
  "tool": "close_job",
  "arguments": {
    "job_id": "{job}",
    "summary": "{work_done}",
    "minutes": "{time_spent}",
    "photos": "{files.photos}"
  },
  "save": {
    "dispatch_answer": "$text"
  },
  "on_fail": "continue"
}

Conviene saber. Un valor que es exactamente un marcador de posición conserva su tipo (un número sigue siendo un número, una lista sigue siendo una lista). Los secretos se guardan cifrados, no se vuelven a mostrar y la API nunca los devuelve. Las direcciones deben ser https y públicas: las direcciones privadas, locales e internas se rechazan, y no se siguen las redirecciones. Una llamada puede tardar 15 segundos y su respuesta puede ser de 256 KB. En save, una ruta es $ (toda la respuesta) o una ruta simple como $.data.items[0].id.

Marcadores de posición

Cada texto y cada parámetro de una acción pueden usar marcadores de posición entre llaves. Un nombre que no se conoce se queda como lo escribió.

MarcadorSe convierte en
{<field key>}la respuesta a esa pregunta (también campos internos, valores calculados y valores que guardó una automatización)
{reference}la referencia, por ejemplo MR-7Q3M2A
{form} {form_key}el nombre del formulario y su clave
{status} {status_name}la clave de la etapa y su nombre
{channel}whatsapp, web, api o staff
{priority} {tags}la prioridad y las etiquetas
{created} {updated} {due}las horas
{contact.name} {contact.phone} {contact.email}la persona que lo envió
{assignee.name} {assignee.email}el miembro del equipo al que está asignado
{link}la página de estado de la propia persona
{desk_link}el envío en la bandeja de su equipo
{answers}todas las respuestas como líneas "Etiqueta: valor"
{files} {files.<field key>}enlaces a todos los archivos, o a los archivos de una pregunta; otro sistema puede descargarlos durante 7 días
{note}la nota del cambio de etapa, o la nota que activó la automatización
{button}el botón que pulsó la persona
{business}el nombre de su empresa
{submission}en un cuerpo JSON: el envío completo como objeto
{= formula }una fórmula calculada en el sitio, por ejemplo {= round(qty * 1.1, 2) }

Fórmulas

Las usan los valores calculados, la acción calculate y {= ... } dentro de cualquier texto. Una fórmula trabaja con números, textos entre comillas simples y las claves de sus preguntas. Puede tener 500 caracteres. Dividir por cero, o un número que falta, da un valor vacío en lugar de un error.

Usted escribeSignificado
+ - * / %aritmética con números y respuestas
== != > >= < <=comparaciones
and or not ( )lógica y paréntesis
if(condition, a, b)a cuando se cumple la condición, si no b
min(a, b, ...) max(a, b, ...)el menor, el mayor
round(x, n) abs(x)redondeo a n decimales, el tamaño de un número sin su signo
num(x) len(x)un texto como número; la longitud de un texto o de una lista
coalesce(a, b)a, o b cuando a está vacío
lower(x) upper(x) concat(a, b, ...)textos
lookup('list', id, 'column')una columna de una fila de una de sus listas, por ejemplo un precio
previous('field')la última respuesta de la misma persona a esa pregunta
count_files('field')cuántos archivos contiene una pregunta
days_since(date)días desde una fecha hasta hoy

Ejemplos: qty * lookup('prices', product, 'price') para una estimación instantánea; reading - previous('reading') para el consumo; if(amount > 500, 'manager', 'agent') para decidir quién aprueba.

Para desarrolladores y agentes de IA

Todo lo anterior está en la API REST bajo /v1/{number}/submit, donde {number} es su número de WhatsApp con el código de país, solo dígitos. Envíe su clave de API como Authorization: Bearer YOUR_API_KEY (el encabezado X-API-KEY también se acepta). La clave necesita el permiso submissions:manage; las claves con acceso total lo tienen, la clave Default no. Las claves de sandbox no pueden escribir.

  1. GET /submit/guide: un documento JSON con todo el vocabulario: tipos de pregunta con sus opciones y límites, reglas de etapa, disparadores, operadores, acciones con sus parámetros, marcadores de posición, funciones de fórmula, las plantillas y ejemplos resueltos.
  2. POST /submit/setup con "dry_run": true: no se escribe nada; cada problema vuelve con su ruta y una frase que dice cómo corregirlo.
  3. POST /submit/setup sin dry_run: las listas, conexiones, formularios y automatizaciones se aplican juntos. Con cualquier problema no se escribe nada.
  4. POST /submit/forms/{key}/publish, o nombre los formularios en "publish" del documento de configuración.
  5. Comparta los enlaces del formulario (GET /submit/forms/{key} los devuelve) y luego lea GET /submit/submissions o escuche los eventos de webhook.

Una llamada de configuración completa

Guarde el documento de abajo como setup.json y envíelo. Sustituya 61400000000 por su número. Comprueba una solución de lecturas de contador: una lista de sedes, una conexión a un sistema de facturación, un formulario con tres etapas y un consumo calculado, y dos automatizaciones. Quite "dry_run": true para aplicarlo. Los formularios, listas y conexiones existentes con la misma clave se sustituyen; las automatizaciones se identifican por su nombre dentro del formulario. "preset": "..." en lugar de las partes instala una de las plantillas (GET /submit/presets las enumera).

curl -X POST "https://api.app2email.com/v1/61400000000/submit/setup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @setup.json
{
  "dry_run": true,
  "settings": {
    "enabled": true,
    "config": {
      "business_name": "Northside Energy",
      "default_prefix": "NE"
    }
  },
  "lists": [
    {
      "key": "sites",
      "name": "Sites",
      "items": [
        {
          "id": "north",
          "title": "North depot"
        },
        {
          "id": "south",
          "title": "South depot"
        }
      ]
    }
  ],
  "connections": [
    {
      "key": "billing",
      "name": "Billing",
      "kind": "http",
      "base_url": "https://billing.example.com/api",
      "auth": {
        "type": "bearer",
        "secret": "YOUR_BILLING_TOKEN"
      },
      "enabled": true
    }
  ],
  "forms": [
    {
      "key": "meter_reading",
      "name": "Meter reading",
      "definition": {
        "title": "Meter reading",
        "description": "Send us your reading. It takes about a minute.",
        "prefix": "MR",
        "steps": [
          {
            "key": "reading",
            "title": "Your reading",
            "text": "",
            "show_if": null,
            "fields": [
              {
                "key": "site",
                "type": "select",
                "label": "Site",
                "required": true,
                "list": "sites"
              },
              {
                "key": "meter_no",
                "type": "text",
                "label": "Meter number",
                "help": "Printed on the front of the meter",
                "required": true,
                "max_length": 30
              },
              {
                "key": "reading",
                "type": "number",
                "label": "Reading",
                "required": true,
                "min": 0,
                "decimals": 0,
                "unit": "kWh"
              },
              {
                "key": "photo",
                "type": "photo",
                "label": "Photo of the meter",
                "required": false,
                "max_files": 1,
                "source": "any"
              },
              {
                "key": "billing_id",
                "type": "text",
                "label": "Billing record",
                "internal": true
              }
            ]
          }
        ],
        "stages": [
          {
            "key": "received",
            "name": "Received",
            "kind": "open",
            "color": "blue",
            "set_by": [],
            "require_note": false,
            "message": ""
          },
          {
            "key": "queried",
            "name": "Queried",
            "kind": "open",
            "color": "amber",
            "set_by": [],
            "require_note": true,
            "message": "We have a question about your reading {reference}. We will be in touch."
          },
          {
            "key": "checked",
            "name": "Checked",
            "kind": "done",
            "color": "green",
            "set_by": [],
            "require_note": false,
            "message": ""
          }
        ],
        "who": {
          "mode": "anyone",
          "numbers": [],
          "tag": ""
        },
        "trigger": {
          "words": [
            "meter",
            "reading"
          ],
          "header": "",
          "body": "Tap the button to send your reading.",
          "button": "Open form",
          "footer": ""
        },
        "after": {
          "review_step": true,
          "reply": "Thanks {contact.name}. We have your reading - reference {reference}.",
          "allow_additions": false,
          "status_page": true
        },
        "web": {
          "enabled": true,
          "verify": "optional",
          "ask_email": false,
          "success_text": "Thank you. We have your reading."
        },
        "notify": {
          "email": true,
          "to": [],
          "attach_files": true
        },
        "calculated": [
          {
            "key": "usage",
            "label": "Usage",
            "formula": "reading - previous('reading')",
            "unit": "kWh",
            "decimals": 0
          }
        ],
        "retention_days": 0
      }
    }
  ],
  "automations": [
    {
      "name": "Query a reading that looks wrong",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "any": [
          {
            "field": "usage",
            "lt": 0
          },
          {
            "field": "usage",
            "gt": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "set_status",
          "status": "queried",
          "note": "Usage {usage} kWh is outside the usual range."
        },
        {
          "type": "notify",
          "to": "role:manager",
          "text": "Reading {reference} for meter {meter_no} needs a check: usage {usage} kWh."
        }
      ]
    },
    {
      "name": "Send good readings to billing",
      "form": "meter_reading",
      "enabled": true,
      "trigger": "submitted",
      "options": {},
      "conditions": {
        "all": [
          {
            "field": "usage",
            "gte": 0
          },
          {
            "field": "usage",
            "lte": 2000
          }
        ]
      },
      "actions": [
        {
          "type": "http",
          "connection": "billing",
          "method": "POST",
          "path": "/readings",
          "body": {
            "meter": "{meter_no}",
            "reading": "{reading}",
            "usage": "{usage}",
            "reference": "{reference}",
            "photo": "{files.photo}"
          },
          "save": {
            "billing_id": "$.id"
          },
          "on_fail": "retry"
        },
        {
          "type": "set_status",
          "status": "checked",
          "note": "Sent to billing as {billing_id}."
        }
      ]
    }
  ],
  "publish": [
    "meter_reading"
  ]
}

La respuesta de la llamada real (sin dry_run):

{
  "success": true,
  "request_id": "req_...",
  "applied": {
    "lists": [
      "sites"
    ],
    "connections": [
      "billing"
    ],
    "forms": [
      "meter_reading"
    ],
    "automations": [
      "Query a reading that looks wrong",
      "Send good readings to billing"
    ],
    "published": [
      "meter_reading"
    ]
  },
  "problems": []
}

Las demás rutas

  • Settings: GET / PUT /submit/settings.
  • Formularios: listar, crear (desde una definición o una plantilla), leer, actualizar, eliminar, publicar, y POST /submit/forms/{key}/send para enviar un formulario a un número con valores rellenados.
  • Listas: PUT /submit/lists/{key} sustituye las filas de una lista.
  • Envíos: listar (filtre por formulario, etapa, responsable, etiqueta, canal, contacto, texto y fechas; updated_after para sincronizar; CSV con ?format=csv), crear, leer por id o referencia, actualizar (etapa, nota, prioridad, responsable, hora límite, etiquetas, respuestas, campos internos), añadir una nota, responder con botones, añadir un archivo, eliminar.
  • Automatizaciones y ejecuciones: listar, crear, leer, actualizar, eliminar, POST /submit/automations/try y el registro de ejecuciones.
  • Conexiones: listar, fijar, eliminar, probar, actualizar y las funciones a las que puede llamar una acción.
  • Equipo e informe: invitar, actualizar y quitar miembros; recuentos por formulario, etapa, día y responsable.

Eventos de webhook

Cada webhook de su cuenta recibe todos los eventos. Cada uno lleva el envío tal como está en ese momento; los enlaces de archivos que contiene funcionan 7 días.

EventoCuándo
submission.createdexiste un envío (sus archivos aún pueden estar llegando)
submission.files_readysus archivos están guardados
submission.updatedcambiaron respuestas, valores internos, prioridad, etiquetas u hora límite
submission.status_changedcambió la etapa
submission.assignedcambió el responsable
submission.note_addedse escribió una nota
submission.customer_repliedla persona añadió texto, archivos o un seguimiento, o pulsó un botón
submission.deletedeliminado o borrado
submit.automation_faileduna automatización se rindió tras sus reintentos

Herramientas MCP

Cada ruta también es una herramienta en el servidor MCP alojado de app2email, así que un asistente puede hacer toda la configuración en una conversación: get_submit_guide, apply_submit_setup, list_submit_presets, create_form, publish_form, send_form, list_submissions, get_submission, update_submission, reply_to_submission, create_automation, try_automation, set_connection, test_connection y más. Un buen primer mensaje para el asistente: "Lee la guía de Submit-Info, luego configura un formulario de informe de problemas con fotos y una ubicación, y avisa a mis managers de los urgentes."

claude mcp add --transport http app2email https://api.app2email.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Más sobre cómo conectar asistentes y herramientas de automatización: Herramientas de automatización y agentes.

Límites

LímiteValor
Formularios por número100
Pasos en un formulario, preguntas en un paso12 y 12 (60 preguntas en un formulario, una pregunta de ubicación)
Listas50, cada una de hasta 1000 filas
Automatizaciones, conexiones, miembros del equipo200, 30, 200
Archivos en un envío60
Tamaño de archivo25 MB desde WhatsApp, 10 MB desde la página web o la API
Una nota o una respuesta4000 caracteres
Etiquetas en un envío20
Llamadas a sistemas externos60 por minuto y 2000 por día por número; 15 segundos y 256 KB por llamada
Registro de ejecucionesse conserva 30 días

Todavía no disponible

  • Cobrar un pago en un envío (un presupuesto se acepta, no se paga).
  • Enviar un formulario como formulario de WhatsApp a alguien que no le ha escrito en las últimas 24 horas: recibe en su lugar su enlace web personal, para enviarlo con cualquier plantilla aprobada.
  • Firmas.
  • Grupos repetibles ("añadir otro artículo").
  • Saltar a otro formulario a mitad de camino.
  • Rellenar un formulario sin una conexión.
  • Otros idiomas en los textos fijos de la página web (cada texto de su formulario lo escribe usted).
  • Documentos OpenAPI en YAML o Swagger 2, y servidores MCP que solo hablan el transporte SSE más antiguo.
  • Leer valores a partir de fotos.

Todo lo anterior se configura en la página Submit-Info del panel (/dashboard/app/submit). Preguntas: support@app2email.com.