MessageBird (SMS)

MessageBird is the SMS provider behind Full Fabric's text messages. Once your institution saves its own MessageBird token, staff can text applicants and students from their profile, and automations can send SMS messages as one of their steps. Each message is sent through your MessageBird account, and its delivery status flows back to Full Fabric. There is no enable switch: SMS messages go out as soon as a token is saved.

Connect

  1. Open Settings → Infrastructure → MessageBird.
  2. In the SMS card, click Add details (or Update details).
  3. Fill in the fields below and click Save details.
Field Required Notes
Token Yes, to send SMS API access key from your MessageBird account. Masked once saved; when updating, leave it empty to keep the saved value.
Originator No The sender name or number recipients see. Up to 11 letters, numbers and spaces, or a phone number of up to 17 digits (an optional leading +). Uses "Full Fabric" when not set.

Once an Originator is saved it cannot be cleared again, only changed.

Note: Without a token, SMS messages cannot be sent. Two-factor authentication codes still go out through Full Fabric's own MessageBird account, so staff and users keep receiving them.

Sending SMS

From a Profile

On the profile of an applicant, student or other non-staff person, the SMS tab lists every message sent to them, newest first, with the columns Message, Number, Status, Dispatched by and Dispatched at.

  1. Click Compose.
  2. In Phone number field, pick the profile field that holds the number. Number fills in from that field and can be edited.
  3. Write the Message and click Send.

Send does nothing until both Number and Message are filled in. The tab is not available on staff profiles or on scrubbed or anonymised profiles.

From Automations

When the SMS module is enabled for your institution, automations offer a send-SMS step: Send SMS message to profile in automation rules, and Send SMS in the lifecycle workflow builder. The step has three required fields:

Field Purpose
Message The text to send. It is sent exactly as written, the same for every recipient.
Dispatcher The staff member the message is sent on behalf of. It shows in Dispatched by.
Phone number field The profile field that holds each recipient's number.

Scrubbed profiles are skipped. Messages sent by automations appear on the recipient's SMS tab like any other.

Two-Factor Codes

Once a token is saved, two-factor authentication codes sent by SMS also go through your MessageBird account. The Originator applies to them whether or not a token is saved. See Two-Factor Authentication.

Delivery Status

Each message starts as draft and becomes dispatched when Full Fabric hands it to MessageBird. MessageBird then reports delivery back, and the Status column shows its latest report:

Status Meaning
scheduled MessageBird has scheduled the message
sent Sent on to the mobile network
buffered Held by the network, for example while the phone is off
delivered Delivered to the phone
expired Not delivered before it expired
delivery_failed The network could not deliver it

Common Problems

What you see Usual cause Fix
Use up to 11 letters and numbers, or a phone number of up to 17 digits. under Originator The sender is too long or has symbols Shorten it, or use a phone number
The SMS tab is missing on a profile The profile is staff, scrubbed or anonymised, or your role lacks SMS access Check the profile and your role
No send-SMS step in automations The SMS module is not enabled for your institution Contact Full Fabric
Status shows expired or delivery_failed The network could not reach the number Check the number, including its country code, and send again
The changes could not be saved. or another error in the card The save was refused, for example because your role cannot change institution settings See Permissions below

Permissions

Action Who can do it
Open the MessageBird settings page Staff with Global integrations (core.institutions.global_integration_settings), see Permissions
Save the token and originator Staff who can also change institution settings
See and send SMS on a profile Staff with Access SMS messages on profile (core.sms.profile_sms_access)