Get Started with App‑to‑App Communication

App‑to‑App communication is a way to exchange data between apps on a device, even if the device is offline. App‑to‑App communication includes both inbound requests (“calls”) to the ProntoForms app and, on the Advanced and Enterprise tiers, outbound “callbacks” to an allowed domain or app.

Video demo

Learn from an expert! This video shows you how to build and use an App‑to‑App request.

App‑to‑App Cookbook

Get “recipes” for frequently used App‑to‑App requests and callbacks.

 

 

Key Concepts

App‑to‑App communication is a way to exchange information between a mobile app on your device—such as a work order management system—and the ProntoForms app.

An inbound App‑to‑App request directs the ProntoForms app to launch in the foreground and complete an action. On the Advanced and Enterprise tiers, “callbacks” define the data that the ProntoForms app returns to the source app.

Configuration

If you share data from forms in App‑to‑App callbacks, we recommend that you define an allow list. This limits the URLs and apps that can receive the data and guards against unintended sharing of information.

With your allow list configured, you can specify form data and meta-data to send back to your source app in the form of custom callback parametersClosed App‑to‑App custom callback parameters are user-defined parameters that indicate which answers and metadata to pass from the ProntoForms app to another app on a user’s device..

Technical Details

An App‑to‑App request uses the x-callback-url specification and follows this structure, with UTF-8 percent encoding for some special characters:

prontoforms://x-callback-url/action?[actionParameters]

You can use any of the following callback actions:

  • launch
  • list
  • open
  • send
  • search

On the Advanced and Enterprise tiers, you can also define x-callback parametersClosed As part of an App‑to‑App call to the ProntoForms app, x-callback parameters provide a way to launch and send data to the calling app. These include x-success, x-cancel, and x-error parameters. to return the form status, metadata, and submitted data.