app2email API Tarifs

Documentation

Submit-Info

Le guide de Submit-Info : créez un formulaire à partir d'une liste de questions, publiez-le sur WhatsApp et sur une page web, traitez les soumissions par statuts dans une boîte de réception partagée avec des rôles, automatisez les réponses et les appels vers vos propres systèmes, et configurez tout via l'API ou un agent IA.

Vous écrivez un formulaire sous la forme d'une simple liste de questions. app2email le transforme en formulaire dans WhatsApp et en page web avec les mêmes étapes. Un client, ou un membre de votre propre personnel de terrain, le remplit et reçoit une référence. Les réponses et les fichiers deviennent une soumission dans une boîte de réception partagée, où elle passe par vos statuts et déclenche vos automatisations.

Une seule idée

Formulaire, puis soumission, puis statuts, puis automatisations, puis connexions. Une demande de devis, une candidature, un relevé de compteur, un signalement de problème, une intervention terminée, une preuve de livraison et un justificatif de dépense sont tous la même chose, avec des questions différentes et des noms de statuts différents. Chacun existe sous forme de modèle que vous pouvez installer et modifier.

Démarrer en cinq minutes

  1. L'ouvrir : dans votre tableau de bord, ouvrez la page Submit-Info (/dashboard/app/submit, que l'on peut aussi ouvrir depuis Intégrations). Activez-la.
  2. Créer un formulaire : choisissez « Nouveau formulaire » et prenez un modèle, ou partez de zéro. Donnez-lui un nom et écrivez vos questions. Chaque question est une ligne : son texte, son type, et si elle doit obligatoirement recevoir une réponse.
  3. Publier : « Publier sur WhatsApp » envoie le formulaire à WhatsApp et le met en ligne. La page web avec les mêmes étapes est en ligne immédiatement.
  4. Partager : sous Partager, vous trouvez le mot qui ouvre le formulaire dans votre conversation, un lien qui ouvre votre conversation avec ce mot déjà saisi, l'adresse de la page web, un code QR, et un extrait pour placer le formulaire sur votre propre site.
  5. Traiter la boîte de réception : les nouvelles soumissions arrivent dans la Boîte de réception. Ouvrez-en une, changez son statut, répondez. Invitez votre équipe quand vous êtes prêt.

Rien ne change pour un numéro qui n'ouvre jamais Submit-Info. Un formulaire qui n'est pas encore publié sur WhatsApp fonctionne quand même : son mot répond avec le lien de la page web.

Le créateur de formulaires

Un formulaire compte de 1 à 12 étapes, et une étape a un titre et de 1 à 12 questions. Il n'y a ni canevas ni rien à dessiner : la même liste pilote le formulaire sur WhatsApp, la page web, les contrôles sur les réponses, les colonnes de la vue en tableau, les exports et l'API. L'aperçu à côté de l'éditeur montre le formulaire tel qu'une personne le voit.

TypeCe que la personne donneCe que vous pouvez régler
textUne réponse courtelongueur minimale et maximale, un motif
textareaUne réponse plus longuelongueur minimale et maximale
numberUn nombrevaleur minimale et maximale, décimales, une unité comme kWh
emailUne adresse e-mail
phoneUn numéro de téléphone
dateUne datecombien de jours en arrière ou en avant elle peut être
selectUn choixles choix (2 à 200), ou une liste à vous
multiselectPlusieurs choixles choix (2 à 20), le minimum et le maximum à cocher
yesnoOui ou Non
ratingUne note de 1 jusqu'à 3-10la note maximale
consentUne phrase à acceptersi elle doit obligatoirement être cochée
photoUne ou plusieurs photoscombien (1 à 10) ; appareil photo, galerie ou les deux
documentUn ou plusieurs fichierscombien (1 à 10) ; tout fichier, PDF, images ou fichiers bureautiques
locationOù se trouve la personnesur WhatsApp la demande de position ; sur le web un bouton et une ligne d'adresse
infoDu texte que vous affichezrien n'est demandé ni enregistré
hiddenUne valeur qui arrive avec le lienpar exemple un numéro d'intervention ; rien n'est affiché
  • Texte d'aide et valeurs par défaut : chaque question peut porter un court indice et une valeur par défaut. Une valeur par défaut peut utiliser ce que vous savez déjà, comme {contact.name}.
  • Afficher seulement si : une étape ou une question peut dépendre d'une réponse précédente (« afficher cette étape seulement quand Problème est Oui »). WhatsApp et la page web suivent la même règle.
  • Champs internes : des champs qui ne sont jamais demandés. Votre équipe ou une automatisation les remplit : un montant de devis, un motif de décision, un identifiant revenu d'un autre système. Ils n'apparaissent que dans la boîte de réception et dans les exports.
  • Listes : une question à choix peut prendre ses choix dans une liste à vous (sites, interventions, produits avec prix). Modifiez la liste dans le tableau de bord ou via l'API et le formulaire suit, sans qu'il soit nécessaire de publier de nouveau.
  • Valeurs calculées : une formule sur les réponses, pour une estimation instantanée ou un contrôle. Voir les formules.
  • Après l'envoi : un écran de relecture avant l'envoi, la réponse avec la référence, un bouton « Ajouter » qui rattache les messages suivants (texte, photos, fichiers) à la soumission pendant dix minutes, et le lien vers la page de suivi de la personne.
  • Publication : app2email écrit le formulaire WhatsApp pour vous, répartit une longue étape sur plusieurs écrans quand les limites de WhatsApp l'exigent, et conserve les cinq dernières versions publiées pour qu'un ancien message ouvre toujours le formulaire avec lequel il a été envoyé.

La page web. Les mêmes étapes à /form/your-code/form-key. Elle demande un nom et un numéro WhatsApp en dernier. Après l'envoi, la personne voit la référence et peut toucher « Recevoir les mises à jour sur WhatsApp », ce qui confirme son numéro avec un message ; un formulaire peut être réglé pour l'exiger. Un lien personnel (envoyé par vous) sait déjà qui est la personne. Pour placer le formulaire sur votre propre site, utilisez l'extrait sous Partager ; si le formulaire demande une position, ajoutez allow="geolocation" à l'iframe. Les photos sont réduites dans le navigateur avant d'être envoyées ; un fichier peut peser jusqu'à 10 Mo.

Comment les gens accèdent à un formulaire

  • Un mot : chaque formulaire a ses propres mots. Les mots form, forms, report et submit (vous pouvez les changer) listent vos formulaires sous forme de menu quand il y en a plusieurs. Un mot ne compte que dans un message court : un message avec moins de 10 autres mots (Paramètres, « Ignorer les mots dans les longs messages ») : un long message qui le contient par hasard ne déclenche donc rien.
  • Un lien ou un code QR : un lien qui ouvre votre conversation WhatsApp avec le mot du formulaire, ou l'adresse de la page web.
  • Envoyé par vous : « Envoyer le formulaire » dans la boîte de réception, ou l'API, envoie un formulaire à un numéro, avec des valeurs déjà remplies (un numéro d'intervention, un compte, les documents que vous voulez).
  • Un suivi : une automatisation ou un membre de l'équipe demande plus d'informations avec un second formulaire. Ce qui revient est rattaché à la première soumission.
  • La page web, et l'API pour les systèmes qui détiennent déjà les données.

Qui peut envoyer. Tout le monde (le choix habituel), ou seulement les numéros que vous listez ou les contacts qui ont une étiquette à vous. C'est ainsi qu'un formulaire reste réservé à votre personnel de terrain. Le mot status répond à une personne avec le statut de ses soumissions récentes.

Statuts

Les statuts appartiennent au formulaire. Un nouveau formulaire démarre avec Nouveau, En cours et Terminé ; renommez-les, ajoutez les vôtres (2 à 12) et choisissez une couleur. Chaque statut est de l'un de trois types : ouvert, terminé ou annulé.

  • Qui peut le choisir : réservez un statut à certains rôles. Un Agent prépare, seul un Responsable approuve.
  • Note obligatoire : demandez un motif quand une soumission y est déplacée (refusée, rejetée, mise en question).
  • Message : un texte envoyé à la personne quand sa soumission arrive au statut, avec des variables.
  • Boutons pour la personne : une réponse peut porter jusqu'à trois boutons (Accepter, Refuser, « Pas encore réparé »), et chacun fait changer le statut. Cet élément à lui seul permet l'acceptation d'un devis, la confirmation d'une visite et « est-ce réparé ? ».

Une réponse écrite en dehors du délai de réponse de WhatsApp est conservée et remise quand la personne écrit la fois suivante. La boîte de réception l'indique sur la réponse.

La boîte de réception et les rôles

La Boîte de réception affiche Ouvertes, Les miennes, Non attribuées, Terminées et Toutes, plus les vues que vous enregistrez. Recherchez et filtrez par formulaire, statut, responsable, étiquette, canal et date. Trois dispositions : une liste, un tableau (un formulaire : chaque question est une colonne) et un tableau kanban (un formulaire : une colonne par statut). Cochez plusieurs lignes pour changer le statut, attribuer, étiqueter, exporter ou supprimer ensemble.

Une soumission affiche ses réponses, ses fichiers, d'où elle a été envoyée, et un seul historique de tout ce qui lui est arrivé : changements de statut avec qui et pourquoi, notes, réponses dans les deux sens, fichiers, et chaque étape d'automatisation avec son résultat. En bas, vous écrivez soit une note interne, soit une réponse WhatsApp. Exportez n'importe quelle vue en CSV, Excel ou JSON, et une soumission en PDF.

Votre équipe. Invitez des personnes par e-mail uniquement dans la boîte de réception. Elles obtiennent une application légère à elles à /desk et ne voient jamais le reste de votre compte. Un rôle est un ensemble de capacités de départ, et chaque capacité peut être activée ou désactivée pour une personne.

RôleDémarre avec
Propriétaire, AdminTout, y compris les formulaires, les automatisations, les connexions et l'équipe
ResponsableNotes, réponses, modification des réponses, changement de statut, attribution, fichiers, export, suppression, exécution d'actions manuelles
AgentNotes, réponses, modification des réponses, changement de statut, fichiers, exécution d'actions manuelles. Peut prendre une soumission pour lui-même
LecteurPeut lire, rien d'autre

Vous pouvez aussi restreindre ce qu'une personne voit : seulement certains formulaires, seulement ce qui lui est attribué (avec ou sans les non attribuées à prendre en charge), et les coordonnées masquées. Chaque action d'un membre de l'équipe est inscrite dans l'historique de la soumission.

La page propre à la personne. Chaque soumission a une page privée à /s/a-long-code, sans connexion : le statut, les messages et changements de statut jusqu'ici, votre question ouverte avec ses boutons, et « Ajouter des informations » quand le formulaire le permet. Les notes internes et les champs internes n'y figurent jamais.

Confidentialité. Effacer un contact efface ses soumissions et ses fichiers. Un formulaire peut avoir une durée de conservation, après laquelle les soumissions closes sont effacées.

Automatisations

Une automatisation se lit comme une phrase : quand quelque chose se passe, si certaines choses sont vraies, faire ces choses dans l'ordre. « Quand une Demande de devis est soumise, si la quantité est de 20 ou plus, l'attribuer aux Responsables et envoyer un e-mail au propriétaire. »

QuandElle s'exécute quand
submittedune soumission est complète et ses fichiers sont arrivés
status_changedle statut a changé (en option : vers ou depuis certains statuts)
assignedla personne à qui elle est attribuée a changé
updateddes réponses ou des champs internes ont été modifiés
note_addedun membre de l'équipe a écrit une note
file_addedun fichier a été ajouté plus tard
customer_repliedla personne qui l'a envoyée a ajouté du texte ou des fichiers
buttonla personne a appuyé sur un bouton de l'une de vos réponses
overdueelle est toujours au même statut après un certain nombre de minutes
dueson échéance est passée alors qu'elle était ouverte
manualun membre de l'équipe appuie sur le bouton de l'action dans la soumission

Si : des règles sur les réponses, les valeurs calculées, le statut, le canal, les étiquettes et le responsable. Une règle est un champ, un opérateur et une valeur : equals, not_equals, in, not_in, contains, empty, not_empty, gt, gte, lt, lte. Reliez les règles avec all (et) ou any (ou).

FaireCe que cela fait
set_statusla déplacer vers un statut, avec une note
assignà un membre, à tour de rôle parmi un rôle, au moins occupé d'un rôle, ou à personne
set_field, calculateécrire un champ interne, ou en calculer un avec une formule
tag, set_priority, set_dueétiquettes, priorité, une échéance
replyun message WhatsApp à la personne, avec jusqu'à 3 boutons qui font chacun changer le statut, un fichier, ou le lien vers sa page de suivi
ask_locationdemander à la personne de partager où elle se trouve
send_formenvoyer un formulaire de suivi ; ce qui revient est rattaché à cette soumission
emailau propriétaire, au responsable, à la personne, ou à toute adresse, avec les fichiers en pièces jointes
notifyun e-mail au responsable, à un rôle, ou à toute l'équipe
http, openapi, mcpappeler une connexion et conserver des parties de la réponse dans des champs
waitcontinuer plus tard, seulement si les conditions sont toujours remplies
stops'arrêter ici

Chaque exécution est journalisée étape par étape : ce qui a été envoyé, ce qui est revenu, combien de temps cela a pris. « Essayer avec une soumission » exécute une automatisation sur une vraie soumission sans rien modifier ni envoyer. Un appel à un système externe qui échoue est retenté après 1 minute, 10 minutes et 1 heure ; ensuite l'automatisation est marquée comme échouée et vos webhooks reçoivent submit.automation_failed. Les automatisations qui se déclenchent les unes les autres sont arrêtées après trois niveaux.

Recette 1 : les gros devis vont à un responsable

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

Recette 2 : envoyer le devis, demander une réponse, relancer après trois jours

quote_amount est un champ interne que votre équipe remplit avant de déplacer la soumission vers Devis envoyé. La relance ne part que si la soumission est toujours dans Devis envoyé.

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

Recette 3 : mettre de côté un relevé de compteur qui semble erroné

usage est une valeur calculée : 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."
    }
  ]
}

Connexions

Une connexion est un système externe qu'une automatisation peut appeler. Les webhooks de votre compte n'en ont besoin d'aucune : ils reçoivent chaque événement de soumission au moment où il se produit (voir les événements). Pour tout le reste, il y a trois types. « Tester » sur une connexion, et « Essayer avec une soumission » sur une action, montrent la vraie requête et la vraie réponse avant que quoi que ce soit soit activé.

Requête HTTP

Une adresse de base et un moyen de se connecter (aucun, un jeton bearer, un en-tête, un nom d'utilisateur et un mot de passe, ou une clé dans l'adresse). L'action indique la méthode, le chemin et un corps JSON. save conserve des parties de la réponse dans des champs de la soumission.

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

Document OpenAPI

Donnez l'adresse d'un document OpenAPI 3 au format JSON, ou collez-le. app2email lit ses opérations ; l'action en choisit une par son identifiant et remplit ses paramètres. Les documents YAML et Swagger 2 ne sont pas lus.

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

Serveur MCP

Donnez l'adresse d'un serveur MCP (streamable HTTP) et son jeton. app2email liste les outils du serveur ; l'action en choisit un et remplit ses arguments. $text conserve toute la réponse de l'outil sous forme de texte.

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

Bon à savoir. Une valeur qui est exactement une variable garde son type (un nombre reste un nombre, une liste reste une liste). Les secrets sont stockés chiffrés, jamais réaffichés et jamais renvoyés par l'API. Les adresses doivent être en https et publiques : les adresses privées, locales et internes sont refusées, et les redirections ne sont pas suivies. Un appel peut durer 15 secondes et sa réponse peut peser 256 Ko. Dans save, un chemin est $ (toute la réponse) ou un chemin simple comme $.data.items[0].id.

Variables

Chaque texte et chaque paramètre d'une action peut utiliser des variables entre accolades. Un nom inconnu reste tel que vous l'avez saisi.

VariableDevient
{<field key>}la réponse à cette question (aussi les champs internes, les valeurs calculées et les valeurs qu'une automatisation a enregistrées)
{reference}la référence, par exemple MR-7Q3M2A
{form} {form_key}le nom du formulaire et sa clé
{status} {status_name}la clé du statut et son nom
{channel}whatsapp, web, api ou staff
{priority} {tags}la priorité et les étiquettes
{created} {updated} {due}les dates et heures
{contact.name} {contact.phone} {contact.email}la personne qui l'a envoyée
{assignee.name} {assignee.email}le membre de l'équipe à qui elle est attribuée
{link}la page de suivi de la personne
{desk_link}la soumission dans la boîte de réception de votre équipe
{answers}toutes les réponses sous forme de lignes « Libellé : valeur »
{files} {files.<field key>}des liens vers tous les fichiers, ou vers les fichiers d'une question ; un autre système peut les récupérer pendant 7 jours
{note}la note du changement de statut, ou la note qui a déclenché l'automatisation
{button}le bouton sur lequel la personne a appuyé
{business}le nom de votre entreprise
{submission}dans un corps JSON : toute la soumission sous forme d'objet
{= formula }une formule calculée sur place, par exemple {= round(qty * 1.1, 2) }

Formules

Utilisées par les valeurs calculées, par l'action calculate, et dans {= ... } dans n'importe quel texte. Une formule travaille avec des nombres, des textes entre apostrophes et les clés de vos questions. Elle peut faire 500 caractères. Une division par zéro, ou un nombre manquant, donne une valeur vide plutôt qu'une erreur.

Vous écrivezSignification
+ - * / %arithmétique sur des nombres et des réponses
== != > >= < <=comparaisons
and or not ( )logique et parenthèses
if(condition, a, b)a quand la condition est vraie, sinon b
min(a, b, ...) max(a, b, ...)le plus petit, le plus grand
round(x, n) abs(x)arrondi à n décimales, la valeur d'un nombre sans son signe
num(x) len(x)un texte converti en nombre ; la longueur d'un texte ou d'une liste
coalesce(a, b)a, ou b quand a est vide
lower(x) upper(x) concat(a, b, ...)textes
lookup('list', id, 'column')une colonne d'une ligne de l'une de vos listes, par exemple un prix
previous('field')la dernière réponse de la même personne à cette question
count_files('field')combien de fichiers contient une question
days_since(date)les jours écoulés depuis une date jusqu'à aujourd'hui

Exemples : qty * lookup('prices', product, 'price') pour une estimation instantanée ; reading - previous('reading') pour la consommation ; if(amount > 500, 'manager', 'agent') pour décider qui approuve.

Pour les développeurs et les agents IA

Tout ce qui précède se trouve dans l'API REST sous /v1/{number}/submit, où {number} est votre numéro WhatsApp avec l'indicatif du pays, chiffres uniquement. Envoyez votre clé API sous la forme Authorization: Bearer YOUR_API_KEY (l'en-tête X-API-KEY est accepté aussi). La clé a besoin du scope submissions:manage ; les clés à accès complet l'ont, la clé par défaut non. Les clés sandbox ne peuvent pas écrire.

  1. GET /submit/guide : un seul document JSON avec tout le vocabulaire : les types de questions avec leurs options et leurs limites, les règles de statuts, les déclencheurs, les opérateurs, les actions avec leurs paramètres, les variables, les fonctions de formule, les modèles et des exemples détaillés.
  2. POST /submit/setup avec "dry_run": true : rien n'est écrit ; chaque problème revient avec son chemin et une phrase qui explique comment le corriger.
  3. POST /submit/setup sans dry_run : les listes, connexions, formulaires et automatisations sont appliqués ensemble. S'il y a le moindre problème, rien n'est écrit.
  4. POST /submit/forms/{key}/publish, ou nommez les formulaires dans "publish" du document de configuration.
  5. Partagez les liens du formulaire (GET /submit/forms/{key} les renvoie), puis lisez GET /submit/submissions ou écoutez les événements de webhook.

Un appel de configuration complet

Enregistrez le document ci-dessous sous setup.json et envoyez-le. Remplacez 61400000000 par votre numéro. Il vérifie une solution de relevé de compteur : une liste de sites, une connexion à un système de facturation, un formulaire avec trois statuts et une consommation calculée, et deux automatisations. Retirez "dry_run": true pour l'appliquer. Les formulaires, listes et connexions existants ayant la même clé sont remplacés ; les automatisations sont rapprochées par nom au sein du formulaire. "preset": "..." à la place des parties installe l'un des modèles (GET /submit/presets les liste).

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 réponse de l'appel réel (sans 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": []
}

Les autres routes

  • Paramètres : GET / PUT /submit/settings.
  • Formulaires : lister, créer (à partir d'une définition ou d'un modèle), lire, mettre à jour, supprimer, publier, et POST /submit/forms/{key}/send pour envoyer un formulaire à un numéro avec des valeurs remplies.
  • Listes : PUT /submit/lists/{key} remplace les lignes d'une liste.
  • Soumissions : lister (filtrer par formulaire, statut, responsable, étiquette, canal, contact, texte et dates ; updated_after pour la synchronisation ; CSV avec ?format=csv), créer, lire par identifiant ou référence, mettre à jour (statut, note, priorité, responsable, échéance, étiquettes, réponses, champs internes), ajouter une note, répondre avec des boutons, ajouter un fichier, supprimer.
  • Automatisations et exécutions : lister, créer, lire, mettre à jour, supprimer, POST /submit/automations/try, et le journal des exécutions.
  • Connexions : lister, définir, supprimer, tester, actualiser, et les fonctions qu'une action peut appeler.
  • Équipe et rapport : inviter, mettre à jour et retirer des membres ; totaux par formulaire, statut, jour et responsable.

Événements de webhook

Chaque webhook de votre compte reçoit tous les événements. Chacun contient la soumission telle qu'elle est à ce moment-là ; les liens de fichiers qu'il contient fonctionnent pendant 7 jours.

ÉvénementQuand
submission.createdune soumission existe (ses fichiers peuvent encore arriver)
submission.files_readyses fichiers sont enregistrés
submission.updateddes réponses, des valeurs internes, la priorité, les étiquettes ou l'échéance ont changé
submission.status_changedle statut a changé
submission.assignedle responsable a changé
submission.note_addedune note a été écrite
submission.customer_repliedla personne a ajouté du texte, des fichiers ou un suivi, ou a appuyé sur un bouton
submission.deletedsupprimée ou effacée
submit.automation_failedune automatisation a abandonné après ses nouvelles tentatives

Outils MCP

Chaque route est aussi un outil sur le serveur MCP hébergé d'app2email : un assistant peut donc faire toute la configuration dans une conversation : 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 et d'autres. Un bon premier message à l'assistant : « Lis le guide de Submit-Info, puis configure un formulaire de signalement de problème avec des photos et une position, et préviens mes responsables pour les cas urgents. »

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

Pour en savoir plus sur la connexion d'assistants et d'outils d'automatisation : Outils d'automatisation et agents.

Limites

LimiteValeur
Formulaires par numéro100
Étapes dans un formulaire, questions dans une étape12 et 12 (60 questions dans un formulaire, une seule question de position)
Listes50, chacune jusqu'à 1 000 lignes
Automatisations, connexions, membres de l'équipe200, 30, 200
Fichiers dans une soumission60
Taille d'un fichier25 Mo depuis WhatsApp, 10 Mo depuis la page web ou l'API
Une note ou une réponse4 000 caractères
Étiquettes sur une soumission20
Appels vers des systèmes externes60 par minute et 2 000 par jour et par numéro ; 15 secondes et 256 Ko par appel
Journal des exécutionsconservé 30 jours

Pas encore disponible

  • Encaisser un paiement sur une soumission (un devis est accepté, pas payé).
  • Envoyer un formulaire sous forme de formulaire WhatsApp à quelqu'un qui ne vous a pas écrit au cours des dernières 24 heures : vous obtenez à la place son lien web personnel, à envoyer avec n'importe quel modèle approuvé.
  • Les signatures.
  • Les groupes répétables (« ajouter un autre élément »).
  • Passer à un autre formulaire en cours de route.
  • Remplir un formulaire sans connexion.
  • D'autres langues dans les textes fixes de la page web (chaque texte de votre formulaire est à écrire par vous).
  • Les documents OpenAPI en YAML ou Swagger 2, et les serveurs MCP qui ne parlent que l'ancien transport SSE.
  • La lecture de valeurs sur des photos.

Tout ce qui précède se règle sur la page Submit-Info du tableau de bord (/dashboard/app/submit). Questions : support@app2email.com.