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
- Open Settings → Infrastructure → MessageBird.
- In the SMS card, click Add details (or Update details).
- 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.
- Click Compose.
- In Phone number field, pick the profile field that holds the number. Number fills in from that field and can be edited.
- 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) |