Page tree

This is the documentation for ConfiForms CLOUD app

ConfiForms app on Atlassian marketplace


This tutorial explains how to create forms to send emails using ConfiForms CLOUD

If you are unfamiliar with ConfiForms app, please start with the basics: Creating a form in Confluence

This is how the form will look like after you complete this tutorial

The form has 2 fields of type text and one texarea field to input the message

The form's configuration in the Confluence editor looks like this

And we will have a ConfiForms FormView Registrations Control macro to render the form, like this

Configuration for ConfiForms Field Definitions is very simple - just 3 fields, with names and titles, selecting the field type as "text" for the first two, and "textarea" for the 3rd field

The interesting part is the IFTTT Integration Rule, which is configured like this. We reference field's values via [entry.field_name] notations in corresponding macro parameters

The macro has the reference to "message" field definition in it's body (via ConfiForms Field macro), which will be used as a message contents for the email


Complete solution in storage format could be found here

<ac:structured-macro ac:name="confiform" ac:schema-version="1" ac:macro-id="93168f84-1c27-431b-8549-8f7bfdb7ce5a">
  <ac:parameter ac:name="formName">emailer</ac:parameter>
  <ac:rich-text-body>
    <p>
      <ac:structured-macro ac:name="confiform-field-definition" ac:schema-version="1"
                           ac:macro-id="53e663eb-6627-4ad1-bf3f-d84c1dd0374f">
        <ac:parameter ac:name="fieldName">recipient</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Recipient email</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
        <ac:parameter ac:name="required">true</ac:parameter>
      </ac:structured-macro>&nbsp;- text field to input phone number
    </p>
    <p>
      <ac:structured-macro ac:name="confiform-field-definition" ac:schema-version="1"
                           ac:macro-id="ae84d7d2-218a-4231-b8b1-a1d84ecd8dbd">
        <ac:parameter ac:name="fieldName">subject</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Message subject</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
        <ac:parameter ac:name="required">true</ac:parameter>
      </ac:structured-macro>&nbsp;- text field to input email message subject
    </p>
    <p>
      <ac:structured-macro ac:name="confiform-field-definition" ac:schema-version="1"
                           ac:macro-id="9e3af553-2845-4002-9154-f77608a1808b">
        <ac:parameter ac:name="fieldName">message</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Message</ac:parameter>
        <ac:parameter ac:name="type">textarea</ac:parameter>
      </ac:structured-macro>&nbsp;- textarea field to input email message text
    </p>
    <p class="auto-cursor-target"><br/></p>
    <p class="auto-cursor-target">-- ConfiForms IFTTT rule to send email message</p>
    <ac:structured-macro ac:name="confiform-ifttt" ac:schema-version="1"
                         ac:macro-id="81144b22-1890-4b56-a1de-acffd0d129c2">
      <ac:parameter ac:name="action">Send Email</ac:parameter>
      <ac:parameter ac:name="event">onCreated</ac:parameter>
      <ac:parameter ac:name="title">[entry.subject]</ac:parameter>
      <ac:parameter ac:name="who">[entry.recipient]</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:name="confiform-field" ac:schema-version="1"
                               ac:macro-id="5db403eb-7abb-458f-acf3-66109a0c9b29">
            <ac:parameter ac:name="fieldName">message</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target"><br/></p></ac:rich-text-body>
</ac:structured-macro>
<p class="auto-cursor-target"><br/></p>
<ac:structured-macro ac:name="confiform-entry-register" ac:schema-version="1"
                     ac:macro-id="3495c8ac-35b6-40ad-9ecf-9fe66b10d7dd">
  <ac:parameter ac:name="overrideSaveButtonLabel">Send</ac:parameter>
  <ac:parameter ac:name="formName">emailer</ac:parameter>
  <ac:parameter ac:name="formTitle">Send email message</ac:parameter>
  <ac:parameter ac:name="successMessage">Message has been sent</ac:parameter>
  <ac:rich-text-body>
    <p><br/></p></ac:rich-text-body>
</ac:structured-macro>


ConfiForms cloud uses SendGrid infrastructure to send emails

Please make sure to whitelist email server IP

168.245.6.168