Use it to create a custom HTML message, show flow progress, or send custom responses in an API-triggered flow. You can use the messages as quick placeholders to help you sketch out a new flow, and if you want to craft a memorable user experience, use the Custom HTML Template capability to create complete HTML pages with your own structure, style, and scripts.

Because this connector allows you to quickly add API calls and user interfaces, it can be a valuable sketching tool in your flow design process or to prove the design for a connector your organization might build.

Setup

Configuring the HTTP connector

In DaVinci, add an HTTP connection. For help, see Adding a connector.

Connector configuration

reCAPTCHA v2 Site Key

The site key provided in your reCAPTCHA dashboard. For help, see Creating reCAPTCHA keys in the Google documentation.

This field is only needed for the connector’s reCAPTCHA capability.

reCAPTCHA v2 Secret Key

The secret key provided in your reCAPTCHA dashboard. For help, see Creating reCAPTCHA keys in the Google documentation.

This field is only needed for the connector’s reCAPTCHA capability.

Select an OpenID token management connection for signed HTTP responses

To add a selection to this list, go to Connections and add a Token Management connector.

This selection is only needed if you want to sign HTTP responses.

Using the connector in a flow

Showing simple messages

If you want to show information to the user, the Custom HTML Message capability gives you a premade page with a title, message, and button. You can’t change the structure, but you can add an icon or style the message with your own CSS. This is useful for error messages and confirmations, such as confirming a user’s registration details.

  1. In your flow, add the HTTP connector and select the Custom HTML Message capability.
  2. Add a Message Title, such as “Welcome”.
  3. Add a Message. You can include values from elsewhere in your flow by clicking {}, then selecting the attribute that holds the value you want.

    For this example, insert the username that the user entered into the registration form created by the PingOne Forms connector:

    A screen capture that shows the user inserting a variable in the Message field.
  4. If you don’t want the flow to end here, turn on Show Continue Button and customize the button Display Name.

Building a custom page

The Custom HTML Template capability lets you include an HTML page in your flow. The structure, style, and behavior is entirely up to you.

Note:

For creating forms, the PingOne Forms connector provides a drag-and-drop experience builder. Learn more in PingOne Forms Connector and PingOne Forms.

Starting with a template from the UI Studio
To start your custom HTML page, you can autofill its settings from any template you created in the UI Studio. This makes it easy to create several pages from the same template. Keep the following in mind:
  • If you modify your HTML page in your flow, it won’t affect your original template in the UI Studio.
  • When you select a UI template from within an HTTP node, it overwrites any work you've done in that node. The UI templates are best used for newly-created HTTP nodes.