Skip to main content

Overview

In this guide, you’ll create your first GoBlue form for automated iMessage follow-ups. We’ll walk through the entire process from form creation to sending your first automated message.
This tutorial assumes you’ve already installed the GoBlue app via TestFlight and signed in to your account. If you haven’t, start with our Quickstart Guide.

What You’ll Build

By the end of this guide, you’ll have:
  • A functional GoBlue form with custom fields
  • A personalized message template
  • A working webhook URL for external integrations
  • The ability to send automated iMessages
Use Case: We’ll create a “Website Inquiry” form that automatically sends follow-up messages when someone contacts you through your website.

Step 1: Create Your Form

1

Open Forms Tab

Launch the GoBlue app and tap the “Forms” tab at the bottom of the screen.
2

Add New Form

Tap the ”+” button in the top-right corner to create a new form.
3

Name Your Form

Enter a descriptive name for your form. For this example, use:
Website Inquiry Follow-up
Choose names that clearly describe the form’s purpose. You’ll likely create multiple forms for different scenarios.
4

Create Form

Tap “Create Form” to save your new form. You’ll be redirected to the form configuration screen.

Step 2: Configure Form Fields

Your form needs to collect the right data to personalize messages. Let’s add some essential fields:
1

Review Default Fields

GoBlue automatically creates a phoneNumber field (required for sending messages). You’ll see this in the “Form fields” section.
2

Add First Name Field

In the “Form fields” section, tap “Add Field” and enter:
firstName
Tap “Add” to save.
3

Add Last Name Field

Tap “Add Field” again and enter:
lastName
Tap “Add” to save.
4

Add Service Interest Field

Add one more field for the type of service they’re interested in:
serviceType
Tap “Add” to save.
Your form should now have these fields:
  • phoneNumber (required, auto-created)
  • firstName
  • lastName
  • serviceType

Step 3: Create Message Template

Now let’s create a personalized message template that uses the data from your form:
1

Enable Auto Follow-up

Toggle “Auto Follow-up” to ON. This enables automatic message sending when data is received.
2

Configure Message

Tap “Configure Message” to open the message template editor.
3

Write Your Template

In the text editor, enter this personalized message template:
Hi {{firstName}}, 

Thanks for reaching out about {{serviceType}} on our website! 

I received your inquiry and wanted to personally follow up. I'd love to learn more about your project and see how we can help.

Are you available for a quick 15-minute call this week to discuss your {{serviceType}} needs?

Looking forward to hearing from you!

Best regards,
[Your Name]
Variables in double curly braces {{fieldName}} will be automatically replaced with data from your webhook submissions.
4

Test Quick Fields

Use the “Quick Fields” section to easily insert field variables by tapping on them. This helps avoid typos in variable names.

Step 4: Enable Form Capturing

1

Go Back to Form Settings

Tap the back button to return to the main form configuration screen.
2

Enable Capturing

Toggle “Enable capturing” to ON. This allows your form to receive and process webhook data.
3

Copy Webhook URL

Tap “Copy Capture URL” to copy your form’s webhook URL to the clipboard. You’ll need this for integrations.The URL format will be:
https://api.goblue.app/v1/forms/{your-form-id}/webhook

Step 5: Test Your Form

Let’s test your form with sample data to make sure everything works:
1

Send Test Data

Open Terminal or a tool like Postman and send a test webhook request:
curl -X POST https://api.goblue.app/v1/forms/{your-form-id}/webhook \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "phoneNumber": "+1234567890",
    "serviceType": "web development"
  }'
Replace {your-form-id} with your actual form ID from the webhook URL.
2

Check for Success

You should receive a response like:
{
  "status": "success",
  "message": "Message queued successfully"
}
3

Verify Message Queue

In the GoBlue app, go to the “Messages” tab. You should see your test message queued for sending with the personalized content:
Hi John, 

Thanks for reaching out about web development on our website!
...
4

Check Contacts

Go to the “Contacts” tab. You should see “John Doe” added as a new contact with the phone number and associated form information.

Step 6: Setup iOS Shortcuts (Optional)

To actually send the queued messages, you’ll need to set up and run the GoBlue iOS Shortcut:
1

Get API Key

Go to Settings tab in GoBlue and copy your API key.
3

Test Message Sending

Run the shortcut to send your test message. The shortcut will:
  • Retrieve queued messages from GoBlue
  • Open Messages app
  • Send the personalized message to the test phone number

Step 7: Integrate with Your Website

Now let’s connect your form to your website contact form:

HTML Form Integration

Update your website’s contact form to send data to GoBlue:
<form id="contact-form">
  <input type="text" name="firstName" placeholder="First Name" required>
  <input type="text" name="lastName" placeholder="Last Name" required>
  <input type="tel" name="phoneNumber" placeholder="Phone Number" required>
  <select name="serviceType" required>
    <option value="">Select Service</option>
    <option value="web development">Web Development</option>
    <option value="mobile app">Mobile App</option>
    <option value="consulting">Consulting</option>
  </select>
  <button type="submit">Submit</button>
</form>

<script>
document.getElementById('contact-form').addEventListener('submit', async function(e) {
  e.preventDefault();
  
  const formData = new FormData(this);
  const data = Object.fromEntries(formData);
  
  try {
    const response = await fetch('https://api.goblue.app/v1/forms/{your-form-id}/webhook', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(data)
    });
    
    if (response.ok) {
      alert('Thank you! We\'ll be in touch soon.');
      this.reset();
    } else {
      alert('Something went wrong. Please try again.');
    }
  } catch (error) {
    alert('Something went wrong. Please try again.');
  }
});
</script>

WordPress Integration

For WordPress sites, you can use a plugin or add custom code:
// Add to your theme's functions.php
add_action('wp_ajax_submit_to_goblue', 'handle_goblue_submission');
add_action('wp_ajax_nopriv_submit_to_goblue', 'handle_goblue_submission');

function handle_goblue_submission() {
    $data = array(
        'firstName' => sanitize_text_field($_POST['firstName']),
        'lastName' => sanitize_text_field($_POST['lastName']),
        'phoneNumber' => sanitize_text_field($_POST['phoneNumber']),
        'serviceType' => sanitize_text_field($_POST['serviceType'])
    );
    
    $response = wp_remote_post('https://api.goblue.app/v1/forms/{your-form-id}/webhook', array(
        'headers' => array('Content-Type' => 'application/json'),
        'body' => json_encode($data),
        'timeout' => 30
    ));
    
    if (is_wp_error($response)) {
        wp_send_json_error('Failed to submit');
    } else {
        wp_send_json_success('Submitted successfully');
    }
}

Step 8: Monitor and Optimize

1

Track Performance

Monitor your form’s performance in the GoBlue app:
  • Check the Messages tab for sent messages
  • Review the Contacts tab for new submissions
  • Note any failed deliveries or errors
2

Refine Your Template

Based on responses (or lack thereof), consider:
  • Adjusting message tone
  • Shortening or lengthening content
  • Adding more personalization
  • Testing different call-to-action approaches
3

Add More Forms

Create additional forms for different scenarios:
  • Different service types
  • Various traffic sources
  • Different message timing needs

Troubleshooting Common Issues

Check:
  • Form capturing is enabled
  • Webhook URL is correct
  • JSON payload includes required phoneNumber field
  • Content-Type header is set to application/json
Verify:
  • Variable names in template match form field names exactly
  • Using correct syntax: {{fieldName}} not {fieldName}
  • Webhook data includes the referenced fields
Ensure:
  • Phone numbers include country code (e.g., +1 for US)
  • Numbers are valid mobile numbers capable of receiving iMessages
  • No spaces or special characters that might cause parsing issues

Next Steps

Congratulations! You’ve created your first GoBlue automation form. Here’s what to explore next:

Form Configuration Checklist

Use this checklist to ensure your forms are properly configured:
  • Form has a descriptive name
  • Required phoneNumber field exists
  • Additional fields match your data source
  • Message template uses correct variable syntax
  • Auto Follow-up is enabled
  • Form capturing is enabled
  • Webhook URL has been copied and integrated
  • Test data has been sent successfully
  • iOS Shortcut is configured and tested
  • Message template has been refined based on testing
Save this checklist and use it each time you create a new form to ensure consistency across your automation workflows.