Creating an SMS Notification

Prerequisites

To follow the steps in this tutorial, you must understand how notifications work. Use the sign-up form created in a previous tutorial and the user property. You also need to ensure that the number is formatted according to Twilio's phone number format guideline.

• Form Configuration Options
• Notifications
• Creating a Database Field for All Users
• Creating a Sign-Up Form
• Twilio's phone number format guideline

Steps

Creating an SMS Notification is a two-step process:

• Step 1: Create an SMS Notification
• Step 2: Add the SMS Notification to the Sign-Up Form

Step 1: Create an SMS Notification

app/smses/welcome_user.liquid

---
to: "{{ form.properties.phone_number }}"
---
Hello {{ form.first_name }} via sms.

This assumes that you have already created a Sign-Up Form and configured the phone_number property.

The phone number should include a country code. On the production site, users might need to learn their country code or what a country code is. For simplicity in this example, though, assume that the user provides the correct input. For production, you might find the to_mobile_number Liquid filter useful.

Step 2: Add the SMS Notification to the Sign-Up Form

Add your SMS Notification to the Sign-Up Form configuration.

The SMS notification name is a path of the file relative to the directory, without extension.

In our example, the path to the file is app/smses/welcome_user.liquid, and the bolded part is the name - . As the result of adding:

sms_notifications:
  - welcome_user

to the Sign-Up Form, the content of in the configuration section should look as follows:

---
name: developer_sign_up
resource: User
resource_owner: anyone
fields:
  email:
  password:
  first_name:
    validation: { presence: true }
  properties:
    phone_number:
      validation:
        phone_number: true
  ...
sms_notifications:
  - welcome_user
---

Next steps

Congratulations! You have created an SMS Notification. Now you can learn about creating an API Call Notification: Creating an API Call Notification