app2email API Preços

Documentação

Submit-Info

O guia do Submit-Info: monte um formulário a partir de uma lista de perguntas, publique-o no WhatsApp e em uma página web, trabalhe os envios por etapas em uma caixa de entrada compartilhada com funções, automatize respostas e chamadas aos seus próprios sistemas e configure tudo pela API ou por um agente de IA.

Você escreve um formulário como uma simples lista de perguntas. O app2email o transforma em um formulário dentro do WhatsApp e em uma página web com as mesmas etapas. Um cliente, ou um membro da sua própria equipe de campo, o preenche e recebe uma referência. As respostas e os arquivos viram um envio em uma caixa de entrada compartilhada, onde ele passa pelas suas etapas e dispara as suas automações.

Uma ideia

Formulário, depois envio, depois etapas, depois automações, depois conexões. Um pedido de orçamento, uma candidatura, uma leitura de medidor, um relato de problema, um serviço concluído, um comprovante de entrega e um recibo de despesa são a mesma coisa, com perguntas diferentes e nomes de etapas diferentes. Cada um vem como um modelo que você pode instalar e alterar.

Comece em cinco minutos

  1. Abra-o: no seu painel, abra a página Submit-Info (/dashboard/app/submit, que também abre pelas Integrações). Ative-o.
  2. Crie um formulário: escolha "Novo formulário" e selecione um modelo, ou comece em branco. Dê um nome a ele e escreva as suas perguntas. Cada pergunta é uma linha: o texto dela, o tipo e se ela precisa ser respondida.
  3. Publique: "Publicar no WhatsApp" envia o formulário ao WhatsApp e o coloca no ar. A página web com as mesmas etapas fica no ar na hora.
  4. Compartilhe: em Compartilhar você encontra a palavra que abre o formulário na sua conversa, um link que abre a sua conversa com essa palavra digitada, o endereço da página web, um QR code e um trecho para colocar o formulário no seu próprio site.
  5. Trabalhe a caixa de entrada: os novos envios chegam à Inbox. Abra um, altere a etapa dele, responda. Convide a sua equipe quando estiver pronto.

Nada muda para um número que nunca abre o Submit-Info. Um formulário que ainda não foi publicado no WhatsApp continua funcionando: a palavra dele responde com o link da página web.

O construtor de formulários

Um formulário tem de 1 a 12 etapas, e uma etapa tem um título e de 1 a 12 perguntas. Não há tela de desenho e nada para desenhar: a mesma lista alimenta o formulário no WhatsApp, a página web, as verificações das respostas, as colunas da visualização em tabela, as exportações e a API. A pré-visualização ao lado do editor mostra o formulário como uma pessoa o vê.

TipoO que a pessoa informaO que você pode definir
textUma resposta curtacomprimento mínimo e máximo, um padrão
textareaUma resposta mais longacomprimento mínimo e máximo
numberUm númerovalor mínimo e máximo, decimais, uma unidade como kWh
emailUm endereço de e-mail
phoneUm número de telefone
dateUma dataquantos dias para trás ou para a frente ela pode estar
selectUma escolhaas opções (de 2 a 200), ou uma lista sua
multiselectVárias escolhasas opções (de 2 a 20), o mínimo e o máximo a marcar
yesnoSim ou Não
ratingUma nota de 1 até 3-10a nota mais alta
consentUma frase com a qual concordarse ela precisa ser marcada
photoUma ou mais fotosquantas (de 1 a 10); câmera, galeria ou qualquer uma
documentUm ou mais arquivosquantos (de 1 a 10); qualquer arquivo, PDF, imagens ou arquivos de escritório
locationOnde a pessoa estáno WhatsApp, o pedido de localização; na web, um botão e uma linha de endereço
infoTexto que você mostranada é perguntado nem guardado
hiddenUm valor que vem com o linkcomo um número de serviço; nada é mostrado
  • Texto de ajuda e valores padrão: toda pergunta pode ter uma dica curta e um valor padrão. Um valor padrão pode usar o que você já sabe, como {contact.name}.
  • Mostrar só quando: uma etapa ou uma pergunta pode depender de uma resposta anterior ("mostrar esta etapa só quando Problema for Sim"). O WhatsApp e a página web seguem a mesma regra.
  • Campos internos: campos que nunca são perguntados. A sua equipe ou uma automação os preenche: um valor de orçamento, o motivo de uma decisão, um id que voltou de outro sistema. Eles aparecem só na caixa de entrada e nas exportações.
  • Listas: uma pergunta de escolha pode tirar as opções de uma lista sua (locais, serviços, produtos com preços). Altere a lista no painel ou pela API e o formulário acompanha, sem precisar publicar de novo.
  • Valores calculados: uma fórmula sobre as respostas, para uma estimativa instantânea ou uma verificação. Veja fórmulas.
  • Depois do envio: uma tela de revisão antes de enviar, a resposta com a referência, um botão "Adicionar mais" que anexa ao envio as mensagens seguintes (texto, fotos, arquivos) por dez minutos e o link para a página de status da própria pessoa.
  • Publicação: o app2email escreve o formulário do WhatsApp para você, divide uma etapa longa em várias telas quando os limites do WhatsApp exigem e guarda as últimas cinco versões publicadas, para que uma mensagem antiga ainda abra o formulário com o qual foi enviada.

A página web. As mesmas etapas em /form/your-code/form-key. Ela pede por último um nome e um número de WhatsApp. Depois do envio, a pessoa vê a referência e pode tocar em "Receber atualizações no WhatsApp", que confirma o número dela com uma mensagem; um formulário pode ser configurado para exigir isso. Um link pessoal (enviado por você) já sabe quem é a pessoa. Para colocar o formulário no seu próprio site, use o trecho em Compartilhar; se o formulário pede uma localização, adicione allow="geolocation" ao iframe. As fotos são reduzidas no navegador antes de serem enviadas; um arquivo pode ter até 10 MB.

Como as pessoas chegam a um formulário

  • Uma palavra: cada formulário tem as suas próprias palavras. As palavras form, forms, report e submit (você pode alterá-las) listam os seus formulários como um menu quando há vários. Uma palavra só vale em uma mensagem curta: uma com menos de 10 outras palavras (Configurações, "Ignorar as palavras em mensagens longas"), então uma mensagem longa que por acaso a contenha não inicia nada.
  • Um link ou um QR code: um link que abre a sua conversa de WhatsApp com a palavra do formulário, ou o endereço da página web.
  • Enviado por você: "Enviar formulário" na caixa de entrada, ou a API, envia um formulário a um número, com valores já preenchidos (um número de serviço, uma conta, os documentos que você quer).
  • Um acompanhamento: uma automação ou um membro da equipe pede mais informações com um segundo formulário. O que voltar é anexado ao primeiro envio.
  • A página web e a API para sistemas que já guardam os dados.

Quem pode enviar. Qualquer pessoa (a escolha habitual), ou só os números que você listar ou contatos com uma tag sua. É assim que um formulário fica restrito à sua equipe de campo. A palavra status responde a uma pessoa com a etapa dos envios recentes dela.

Etapas

As etapas pertencem ao formulário. Um formulário novo começa com Novo, Em andamento e Concluído; renomeie-as, adicione as suas (de 2 a 12) e escolha uma cor. Toda etapa é de um de três tipos: aberta, concluída ou cancelada.

  • Quem pode escolhê-la: reserve uma etapa para certas funções. Um Agente prepara, só um Gerente aprova.
  • Nota obrigatória: peça um motivo quando um envio é movido para lá (recusado, rejeitado, em dúvida).
  • Mensagem: um texto enviado à pessoa quando o envio dela chega à etapa, com placeholders.
  • Botões para a pessoa: uma resposta pode ter até três botões (Aceitar, Recusar, "Ainda não resolvido"), e cada um muda a etapa. Só essa peça já dá a aceitação de orçamentos, a confirmação de uma visita e o "foi resolvido?".

Uma resposta escrita fora do prazo de resposta do WhatsApp é guardada e entregue quando a pessoa escrever de novo. A caixa de entrada informa isso na resposta.

A caixa de entrada e as funções

A Inbox mostra Abertos, Meus, Sem responsável, Concluídos e Todos, além das visualizações que você salvar. Pesquise e filtre por formulário, etapa, responsável, tag, canal e data. Três layouts: uma lista, uma tabela (um formulário: cada pergunta é uma coluna) e um quadro (um formulário: uma coluna para cada etapa). Marque várias linhas para alterar a etapa, atribuir, aplicar tags, exportar ou excluí-las juntas.

Um envio mostra as respostas dele, os arquivos, de onde foi enviado e um único histórico de tudo o que aconteceu com ele: mudanças de etapa com quem as fez e por quê, notas, respostas nos dois sentidos, arquivos e cada etapa de automação com o resultado. Na parte de baixo, você escreve uma nota interna ou uma resposta de WhatsApp. Exporte qualquer visualização como CSV, Excel ou JSON, e um envio como PDF.

A sua equipe. Convide pessoas por e-mail somente para a caixa de entrada. Elas recebem um app leve próprio em /desk e nunca veem o resto da sua conta. Uma função é um conjunto inicial de permissões, e cada permissão pode ser ativada ou desativada para uma pessoa.

FunçãoComeça com
Proprietário, AdministradorTudo, incluindo formulários, automações, conexões e a equipe
GerenteNotas, respostas, edição de respostas, mudança de etapa, atribuição, arquivos, exportação, exclusão, execução de ações manuais
AgenteNotas, respostas, edição de respostas, mudança de etapa, arquivos, execução de ações manuais. Pode assumir um envio para si
VisualizadorPode ler, nada mais

Você também pode restringir o que uma pessoa vê: só alguns formulários, só o que foi atribuído a ela (com ou sem os não atribuídos para pegar) e dados de contato ocultos. Toda ação de um membro da equipe é gravada no histórico do envio.

A página da própria pessoa. Cada envio tem uma página privada em /s/a-long-code, sem login: a etapa, as mensagens e as mudanças de etapa até agora, a sua pergunta em aberto com os botões dela e "Adicionar informações" quando o formulário permite. Notas internas e campos internos nunca aparecem nela.

Privacidade. Apagar um contato apaga os envios e os arquivos dele. Um formulário pode ter um prazo de guarda, depois do qual os envios encerrados são apagados.

Automações

Uma automação se lê como uma frase: quando algo acontece, se algumas coisas são verdadeiras, faça estas coisas em ordem. "Quando um Pedido de orçamento é enviado, se a quantidade for 20 ou mais, atribua-o aos Gerentes e envie um e-mail ao proprietário."

QuandoExecuta quando
submittedum envio está completo e os arquivos dele chegaram
status_changeda etapa mudou (opcionalmente: para ou de certas etapas)
assigneda pessoa a quem ele está atribuído mudou
updatedrespostas ou campos internos foram editados
note_addedum membro da equipe escreveu uma nota
file_addedum arquivo foi adicionado depois
customer_replieda pessoa que o enviou adicionou texto ou arquivos
buttona pessoa apertou um botão de uma das suas respostas
overdueele continua na mesma etapa depois de um número de minutos
dueo prazo dele passou enquanto estava aberto
manualum membro da equipe aperta o botão da ação no envio

Se: regras sobre respostas, valores calculados, a etapa, o canal, as tags e o responsável. Uma regra é um campo, um operador e um valor: equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Junte regras com all (e) ou any (ou).

FaçaO que faz
set_statusmovê-lo para uma etapa, com uma nota
assigna um membro, em rodízio entre uma função, ao menos ocupado de uma função, ou a ninguém
set_field, calculategravar um campo interno, ou calculá-lo com uma fórmula
tag, set_priority, set_duetags, prioridade, um prazo
replyuma mensagem de WhatsApp à pessoa, com até 3 botões que mudam a etapa cada um, um arquivo, ou o link para a página de status dela
ask_locationpedir à pessoa que compartilhe onde está
send_formenviar um formulário de acompanhamento; o que voltar é anexado a este envio
emailao proprietário, ao responsável, à pessoa ou a qualquer endereço, com os arquivos anexados
notifyum e-mail ao responsável, a uma função ou a todos na equipe
http, openapi, mcpchamar uma conexão e guardar partes da resposta em campos
waitcontinuar mais tarde, só se as condições ainda valerem
stopterminar aqui

Toda execução é registrada passo a passo: o que foi enviado, o que voltou, quanto tempo levou. "Testar com um envio" executa uma automação sobre um envio real sem alterar nem enviar nada. Uma chamada a um sistema externo que falha é tentada de novo após 1 minuto, 10 minutos e 1 hora; depois disso, a automação é marcada como falha e os seus webhooks recebem submit.automation_failed. Automações que disparam umas às outras são interrompidas após três níveis.

Receita 1: orçamentos grandes vão para um gerente

{
  "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
    }
  ]
}

Receita 2: envie o orçamento, peça uma resposta e lembre depois de três dias

quote_amount é um campo interno que a sua equipe preenche antes de mover o envio para Orçado. O lembrete só sai se o envio ainda estiver em Orçado.

{
  "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."
    }
  ]
}

Receita 3: separe uma leitura de medidor que parece errada

usage é um 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."
    }
  ]
}

Conexões

Uma conexão é um sistema externo que uma automação pode chamar. Os webhooks da sua conta não precisam de nenhuma: eles recebem todo evento de envio assim que acontece (veja os eventos). Para todo o resto, há três tipos. "Testar" em uma conexão e "Testar com um envio" em uma ação mostram a requisição real e a resposta real antes de qualquer coisa ser ativada.

Requisição HTTP

Um endereço base e uma forma de entrar (nenhuma, um bearer token, um cabeçalho, nome de usuário e senha, ou uma chave no endereço). A ação indica o método, o caminho e um corpo JSON. save guarda partes da resposta em campos do envio.

{
  "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

Informe o endereço de um documento OpenAPI 3 em JSON, ou cole-o. O app2email lê as operações dele; a ação escolhe uma pelo id e preenche os parâmetros dela. Documentos YAML e Swagger 2 não são lidos.

{
  "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

Informe o endereço de um servidor MCP (streamable HTTP) e o token dele. O app2email lista as ferramentas do servidor; a ação escolhe uma e preenche os argumentos dela. $text guarda a resposta inteira da ferramenta como texto.

{
  "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"
}

Bom saber. Um valor que é exatamente um placeholder mantém o tipo dele (um número continua número, uma lista continua lista). Os segredos são guardados criptografados, nunca mostrados de novo e nunca devolvidos pela API. Os endereços precisam ser https e públicos: endereços privados, locais e internos são recusados, e os redirecionamentos não são seguidos. Uma chamada pode levar 15 segundos e a resposta pode ter 256 KB. Em save, um caminho é $ (a resposta inteira) ou um caminho simples como $.data.items[0].id.

Placeholders

Todo texto e todo parâmetro de uma ação pode usar placeholders entre chaves. Um nome que não é conhecido continua como você o digitou.

PlaceholderVira
{<field key>}a resposta a essa pergunta (também campos internos, valores calculados e valores que uma automação guardou)
{reference}a referência, por exemplo MR-7Q3M2A
{form} {form_key}o nome do formulário e a chave dele
{status} {status_name}a chave da etapa e o nome dela
{channel}whatsapp, web, api ou staff
{priority} {tags}a prioridade e as tags
{created} {updated} {due}os horários
{contact.name} {contact.phone} {contact.email}a pessoa que o enviou
{assignee.name} {assignee.email}o membro da equipe a quem ele está atribuído
{link}a página de status da própria pessoa
{desk_link}o envio na caixa de entrada da sua equipe
{answers}todas as respostas como linhas "Rótulo: valor"
{files} {files.<field key>}links para todos os arquivos, ou para os arquivos de uma pergunta; outro sistema pode buscá-los por 7 dias
{note}a nota da mudança de etapa, ou a nota que disparou a automação
{button}o botão que a pessoa apertou
{business}o nome da sua empresa
{submission}em um corpo JSON: o envio inteiro como um objeto
{= formula }uma fórmula calculada no próprio lugar, por exemplo {= round(qty * 1.1, 2) }

Fórmulas

Usadas por valores calculados, pela ação calculate e dentro de {= ... } em qualquer texto. Uma fórmula trabalha com números, textos entre aspas simples e as chaves das suas perguntas. Ela pode ter 500 caracteres. Dividir por zero, ou um número ausente, dá um valor vazio em vez de um erro.

Você escreveSignificado
+ - * / %aritmética com números e respostas
== != > >= < <=comparações
and or not ( )lógica e parênteses
if(condition, a, b)a quando a condição vale, caso contrário b
min(a, b, ...) max(a, b, ...)o menor, o maior
round(x, n) abs(x)arredondamento para n casas decimais, o tamanho de um número sem o sinal
num(x) len(x)um texto como número; o comprimento de um texto ou de uma lista
coalesce(a, b)a, ou b quando a está vazio
lower(x) upper(x) concat(a, b, ...)textos
lookup('list', id, 'column')uma coluna de uma linha de uma das suas listas, por exemplo um preço
previous('field')a última resposta da mesma pessoa a essa pergunta
count_files('field')quantos arquivos uma pergunta contém
days_since(date)dias desde uma data até hoje

Exemplos: qty * lookup('prices', product, 'price') para uma estimativa instantânea; reading - previous('reading') para o consumo; if(amount > 500, 'manager', 'agent') para decidir quem aprova.

Para desenvolvedores e agentes de IA

Tudo o que foi descrito acima está na API REST em /v1/{number}/submit, onde {number} é o seu número de WhatsApp com o código do país, só dígitos. Envie a sua chave de API como Authorization: Bearer YOUR_API_KEY (o cabeçalho X-API-KEY também é aceito). A chave precisa do escopo submissions:manage; as chaves com acesso total o têm, a chave padrão (Default) não. Chaves sandbox não podem gravar.

  1. GET /submit/guide: um único documento JSON com todo o vocabulário: tipos de pergunta com as opções e os limites deles, regras de etapa, gatilhos, operadores, ações com os parâmetros delas, placeholders, funções de fórmula, os modelos e exemplos completos.
  2. POST /submit/setup com "dry_run": true: nada é gravado; todo problema volta com o caminho dele e uma frase dizendo como corrigi-lo.
  3. POST /submit/setup sem dry_run: listas, conexões, formulários e automações são aplicados juntos. Havendo qualquer problema, nada é gravado.
  4. POST /submit/forms/{key}/publish, ou indique os formulários em "publish" do documento de configuração.
  5. Compartilhe os links do formulário (GET /submit/forms/{key} os devolve) e depois leia GET /submit/submissions ou escute os eventos de webhook.

Uma chamada de configuração completa

Salve o documento abaixo como setup.json e envie-o. Troque 61400000000 pelo seu número. Ele verifica uma solução de leitura de medidor: uma lista de locais, uma conexão com um sistema de cobrança, um formulário com três etapas e um consumo calculado, e duas automações. Remova "dry_run": true para aplicá-lo. Formulários, listas e conexões existentes com a mesma chave são substituídos; as automações são identificadas pelo nome dentro do formulário. "preset": "..." no lugar das partes instala um dos modelos (GET /submit/presets os lista).

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"
  ]
}

A resposta da chamada real (sem 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": []
}

As outras rotas

  • Configurações: GET / PUT /submit/settings.
  • Formulários: listar, criar (a partir de uma definição ou de um modelo), ler, atualizar, excluir, publicar, e POST /submit/forms/{key}/send para enviar um formulário a um número com valores preenchidos.
  • Listas: PUT /submit/lists/{key} substitui as linhas de uma lista.
  • Envios: listar (filtrar por formulário, etapa, responsável, tag, canal, contato, texto e datas; updated_after para sincronizar; CSV com ?format=csv), criar, ler por id ou referência, atualizar (etapa, nota, prioridade, responsável, prazo, tags, respostas, campos internos), adicionar uma nota, responder com botões, adicionar um arquivo, excluir.
  • Automações e execuções: listar, criar, ler, atualizar, excluir, POST /submit/automations/try e o log de execuções.
  • Conexões: listar, definir, excluir, testar, atualizar e as funções que uma ação pode chamar.
  • Equipe e relatório: convidar, atualizar e remover membros; contagens por formulário, etapa, dia e responsável.

Eventos de webhook

Todo webhook da sua conta recebe todos os eventos. Cada um traz o envio como ele está naquele momento; os links de arquivos nele funcionam por 7 dias.

EventoQuando
submission.createdum envio existe (os arquivos dele ainda podem estar chegando)
submission.files_readyos arquivos dele estão guardados
submission.updatedrespostas, valores internos, prioridade, tags ou o prazo mudaram
submission.status_changeda etapa mudou
submission.assignedo responsável mudou
submission.note_addeduma nota foi escrita
submission.customer_replieda pessoa adicionou texto, arquivos ou um acompanhamento, ou apertou um botão
submission.deletedexcluído ou apagado
submit.automation_faileduma automação desistiu depois das novas tentativas

Ferramentas MCP

Cada rota também é uma ferramenta no servidor MCP hospedado do app2email, para que um assistente possa fazer toda a configuração em uma conversa: 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 e outras. Uma boa primeira mensagem ao assistente: "Leia o guia do Submit-Info, depois configure um formulário de relato de problema com fotos e uma localização e avise os meus gerentes sobre os urgentes."

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

Mais sobre como conectar assistentes e ferramentas de automação: Ferramentas de automação e agentes.

Limites

LimiteValor
Formulários por número100
Etapas em um formulário, perguntas em uma etapa12 e 12 (60 perguntas em um formulário, uma pergunta de localização)
Listas50, cada uma com até 1.000 linhas
Automações, conexões, membros da equipe200, 30, 200
Arquivos em um envio60
Tamanho do arquivo25 MB pelo WhatsApp, 10 MB pela página web ou pela API
Uma nota ou uma resposta4.000 caracteres
Tags em um envio20
Chamadas a sistemas externos60 por minuto e 2.000 por dia por número; 15 segundos e 256 KB por chamada
Log de execuçõesguardado por 30 dias

Ainda não disponível

  • Receber um pagamento em um envio (um orçamento é aceito, não pago).
  • Enviar como formulário do WhatsApp um formulário a alguém que não escreveu para você nas últimas 24 horas: em vez disso, você recebe o link web pessoal da pessoa, para enviar com qualquer modelo de mensagem aprovado.
  • Assinaturas.
  • Grupos repetidos ("adicionar outro item").
  • Pular para outro formulário no meio do caminho.
  • Preencher um formulário sem uma conexão.
  • Outros idiomas nos textos fixos da página web (cada texto do seu formulário é seu para escrever).
  • Documentos OpenAPI em YAML ou Swagger 2, e servidores MCP que só falam o transporte SSE mais antigo.
  • Ler valores a partir de fotos.

Tudo o que foi descrito acima é configurado na página Submit-Info do painel (/dashboard/app/submit). Dúvidas: support@app2email.com.