← Back to Documentation Home

The Communications module lets authorized staff send email and SMS messages to church members directly from the platform — no need to switch to a separate email or texting tool. Target specific groups, events, or individual people, preview your recipient list before sending, and track delivery status afterward.

What It Does

Communications provides a single place to compose and send messages to your congregation. Key capabilities include:

Two Channels

Send via email or SMS text message. Toggle between channels with one click.

Smart Recipient Filters

Target all members, a specific church group, small group, event registrants, or hand-picked individuals.

Preview Before Sending

See the exact list of recipients and their contact info before committing to send.

Delivery Tracking

Message history shows sent/failed counts and per-recipient delivery status.

Communications compose tab with email channel selected

Communications page — Compose tab with email channel, recipient filter, subject, and message body.

Email & SMS

The compose form lets you choose between two delivery channels:

ChannelHow It WorksBest For
Email Sent via the platform's configured email service (Gmail SMTP). Includes a subject line and full message body. Detailed announcements, event info, newsletters, anything with links or formatting
SMS Sent via Twilio using your church's approved toll-free number. Character counter shows 0/160 per segment. Urgent reminders, short notices, time-sensitive updates (e.g., "Service cancelled due to weather")
SMS character limit: Standard SMS messages are 160 characters per segment. Messages longer than 160 characters are split into multiple segments. The character counter in the compose form helps you stay within a single segment when possible.
SMS opt-in required: SMS messages are only sent to phone numbers where the person has opted in to receive text messages. Members who have not verified their phone number or who have opted out will not receive SMS broadcasts.
← Back to Documentation Home

Compose a Message Admin

To send a new message, navigate to Communication in the sidebar and use the Compose tab.

  1. Select the channel — click Email or SMS at the top of the compose form.
  2. Choose your recipients using the filter dropdown (see Recipient Filters below).
  3. For email: enter a subject line. For SMS: the subject field is hidden.
  4. Write your message in the body textarea.
  5. Click Preview Recipients to see exactly who will receive the message.
  6. Click Send and confirm in the confirmation dialog.
Compose tab in email mode with subject line and message body

Compose tab — email mode with subject line, message body, and recipient filter.

Compose tab in SMS mode with 160-character counter

Compose tab — SMS mode with character counter (0/160) and group recipient filter.

Recipient Filters Admin

Five filter types let you target exactly who should receive your message:

Filter TypeDescription
All Members Every person in the system who has an email address (for email) or a verified phone number with SMS opt-in (for SMS).
Church Group Members of a specific department or ministry group. Select the group from a dropdown.
Small Group Members of a specific small group. Select the group from a dropdown.
Event Registrants People registered for a specific event. Select the event from a dropdown.
Individual Hand-pick specific people by searching their name. Add multiple people as chips.
Tip: After selecting a filter, click Preview Recipients to see a table of resolved recipients with their name and email/phone. This confirms exactly who will receive the message before you send.

Preview & Send Admin

Before sending, the platform shows you a summary of your message:

  • Recipient count — how many people will receive the message
  • Recipient table — each person's name and email address or phone number
  • Channel — email or SMS

When you click Send, a confirmation dialog appears asking you to verify. Once confirmed, the message is dispatched immediately. You'll see a success message when all messages have been queued.

Important: Messages are sent immediately upon confirmation — there is no undo. Double-check your recipient list and message content using the preview before sending.
← Back to Documentation Home

Viewing Message History

The History tab shows all messages that have been sent or drafted, newest first. Each row displays:

ColumnDescription
DateWhen the message was sent
ChannelEmail or SMS icon
Subject / PreviewThe email subject line, or a preview of the SMS message text
RecipientsTotal number of people the message was sent to
StatusCurrent delivery status (Draft, Sending, Sent, Completed, Failed)

Click any row to expand the detail view, which shows the full message body, sender info, and a per-recipient delivery table.

Delivery Status

Each message and each individual recipient has a delivery status:

StatusMeaning
DraftMessage saved but not yet sent. Can be deleted.
SendingMessage is actively being dispatched to recipients.
SentMessage delivered to the email/SMS provider.
CompletedAll recipients have been processed.
FailedDelivery failed for this recipient. Error details shown in the expanded view.
BouncedEmail bounced back (invalid address, full mailbox, etc.).

The expanded detail view shows a breakdown: how many were sent successfully, how many failed, and the specific error for each failed delivery.

Note: Message recipient detail records are archived after 6 months to keep the database lean. The message summary (subject, date, total count, status) is retained indefinitely.

Who Can Access What

Access to the Communications module is controlled by two permissions:

PermissionWhat It Grants
communications.viewView the Communication page and message history
communications.manageCompose and send new messages (email and SMS)

The Communications module must also be enabled via the Feature Modules admin page. When disabled, the sidebar item and route are hidden.

← Back to Documentation Home

Setup & Requirements Admin

The Communications module requires the following to be configured:

For Email

  • Gmail SMTP credentials in Email section of application settings (same as password reset emails)
  • If email is already working for password resets, no additional setup is needed

For SMS

  • Twilio account with an approved toll-free number for sending broadcast messages
  • Sms:AccountSid, Sms:AuthToken, and Sms:FromNumber configured in application settings
  • Recipients must have verified phone numbers with SMS opt-in

Enabling the Module

  1. Navigate to Feature Modules in the Configuration section of the sidebar (SUPERADMIN only).
  2. Toggle the Communications module to Enabled.
  3. Assign the communications.view and communications.manage permissions to appropriate roles via the Permissions admin page.
Tip: The ADMIN and STAFF roles include communications permissions by default. For other roles, use the Permissions admin page to grant access as needed.
← Back to Documentation Home