Rock Mobile Docs
App Factory
  • Welcome 👋
  • 📱Getting Started
    • Building Your First App
      • Creating An App
      • App Configuration
      • Adding Content
      • Deploying Your App
    • Lexicon
  • 🧱Essentials
    • Animations
    • Blocks
      • CMS
        • Content
        • Content Channel Item View
        • Content Collection View
        • Daily Challenge Entry
        • Hero
        • Lava Item List
        • Login
          • Using Auth0
          • Using Entra
        • Profile Details
        • Register
        • Structured Content View
        • Workflow Entry
      • Check-in
        • Check-in
      • Communication
        • Communication Entry
        • Communication List Subscribe
        • Communication View
        • SMS Conversation List
        • SMS Conversation
      • Connection
        • Add Connection Request
        • Connection Type List
        • Connection Opportunity List
        • Connection Request List
        • Connection Request Detail
      • Core
        • Attribute Values
        • Notes
        • Search
        • Smart Search
        • Quick Note
        • My Notes
      • CRM
        • Group Members
        • Person Profile
      • Events
        • Live Experience Occurrences
        • Live Experience
        • Calendar Event Item Occurrence View
        • Calendar Event List
        • Calendar View
        • Event Item Occurrence List By Audience Lava
      • Finance
        • Giving
        • Scheduled Transaction List
        • Transaction Detail
        • Transaction List
      • Groups
        • Group Attendance Entry
        • Group Edit
        • Group Finder
        • Group Member Edit
        • Group Member List
        • Group Member View
        • Group Registration
        • Group View
        • Schedule Preference
        • Schedule Sign Up
        • Schedule Toolbox
        • Schedule Unavailability
      • Prayer
        • Answer To Prayer
        • My Prayer Requests
        • Prayer Card View
        • Prayer Request Details
        • Prayer Session
        • Prayer Session Setup
      • Reminders
        • Reminder Edit
        • Reminder List
        • Reminder Dashboard
      • Security
        • Onboard Person
    • Codex
      • Application Strategy
      • XAML Styling
      • Resources
      • Documentation
    • Commands
      • Communication Commands
      • Navigation Commands
      • Media Commands
      • Utility Commands
    • Controls
      • Behaviors
        • Event To Command Behavior
        • Touch Behavior
      • Content Controls
        • Activity Indicator
        • Application Info
        • Avatar
        • Bible Audio
        • Bible Browser
        • Bible Reader
        • Campus Context Picker
          • Camera Code Reader
        • Cards
          • Block Card
          • Contained Card
          • Inline Card
          • Elements of a Card
          • Masks
          • Styling Cards With CSS
        • Context Menu
        • Countdown
        • Cover Sheet
        • Divider
        • Expander
        • Field Container
        • Flip View
        • Following Icon
        • Geo Boundary View
        • HTML
        • Icon
        • Icon Button
        • Image
        • Interaction
        • Items Collection
        • Login Status
        • Login Status Photo
        • Lottie View
        • Markdown
        • Media Player
          • Legacy
        • Notification Box
        • Paragraph Text
        • QR Code
        • Ratio View
        • Redirect
        • Responsive Column
        • Responsive Layout
        • Scroll View
        • Segment Picker
        • Styled Border
        • Styled View
        • Tag
        • Toggle Button
        • Web View
      • Developer Controls
        • Execute Command
        • Bible Book And Chapter Picker
        • Command Reference
        • Field Stack
        • Media Cast Button
        • Media Progress Bar
        • Parameter
        • Scan Code
        • Validator
        • Volume Control
        • Zone
      • Effects
        • Blur Effect
        • Safe Area Padding Effect
      • Form Fields
        • Attribute Value Editor
        • Address
        • Campus Picker
        • Check Box
        • Check Box List
        • Currency Box
        • Date Picker
        • Email Box
        • Literal
        • Marital Status Picker
        • Multi Picker
        • Number Box
        • Phone Number Box
        • Picker
        • Text Box
        • Text Editor
      • XAML Extensions
        • Boolean Value Converter
        • From Json
        • Inverse Boolean Converter
        • Nullable Guid Converter
        • On Device Platform
        • On Device Type
        • Palette Color
        • Seconds To Time String Converter
    • Field Types
    • Lava
      • Context in Lava
    • Performance
    • Tips and Tricks
      • Custom Site Attributes
      • Migrating to .NET MAUI (V6)
      • Page Anchors
    • Troubleshooting
    • Advanced Topics
      • Dynamic Content
      • Deep Linking
  • 🎨Styling
    • Introduction
    • Style Guide
      • Walkthrough
      • Colors
      • Typography
      • Utilities
      • Shell Components
      • Migrating
    • Legacy
      • Colors
      • Borders
        • Border Color
        • Border Radius
        • Border Width
      • Text
        • Background Color
        • Text Size
        • Alignment
        • Color
        • Line Height
        • Weights & Styles
      • iOS Shadows
      • Styling Components
        • Tags
        • Bible
        • Button
        • Form Fields
        • Modals
      • Custom CSS
  • 👨‍💻Developers
    • Fundamentals
    • Core & Shell Dependencies
    • Custom Blocks
    • OS Version Requirements
  • 🏭App Factory
    • Overview
    • Android Keystore
    • App Store Product Page
    • Developer Accounts
    • Image Resources
    • In-App Giving
    • Publishing Requirements
    • Push Notifications
    • Rock Logins
    • Shell Update Requirements
Powered by GitBook

Resources

  • Release Notes
  • Community Chat
  • Ask Chip

Documentation

  • Rock Manuals
  • Lava

⚙️ Powered by Rock RMS

On this page
  • Setup
  • Settings
  • Page Parameters
  • Security (Approving Communications)
Export as PDF
  1. Essentials
  2. Blocks
  3. Communication

Communication Entry

Allows you to send out Email/SMS communications to a group of recipients.

Last updated 8 months ago

This block is relatively simple to use, but it requires a decent understanding of .

Setup

For this block to work correctly, you must pass in a valid EntitySetGuid page parameter. This will populate the list of recipients that receive the communication. The EntitySetType should be of Person.

You can generate these EntitySetGuid parameters auto-magically, using the Group Member List block.

Settings

Setting
Description

Enable Email

Enable 'Email' as a communication transport.

Enable SMS

Enable 'SMS' as a communication transport.

Show From Name

Show the 'From Name' field for the email communication transport.

Show Reply To

Show the 'Reply To' field for the email communication transport.

Show Parent Communication Toggle

Show the toggle that enables/disables parent communication. You can use this in accordance with the 'ForceSendToParents' parameter.

Is Bulk

Whether or not the communication should be flagged as bulk.

Allowed SMS Numbers

The system phone numbers that are available to use as the 'From Number' for SMS communication. If none are supplied, all of the numbers in the list are available.

Show Only Personal SMS Number

Only SMS numbers tied to the current individual will be shown. Those with ADMIN rights will see all SMS numbers.

Hide Personal SMS Number

Only SMS numbers that are not tied to an individual will be shown.

Person Profile Page

This page is navigated to from the list of recipients that the communication failed to send to. The page is pushed to with a PersonGuid and a GroupMemberGuid parameter, of the person that the communication failed to deliver to.

SMS Character Limit

The amount of characters to limit an SMS message to.

Show Additional Email Recipients

Whether or not the field should be enabled to show additional email recipients.

Page Parameters

This block supports many query strings that can be used to override the block settings. This allows you to set a default, then customize the experience for each individual based on something like the group role or other data from Rock.

Name
Type
Description

EntitySetGuid

Guid

The EntitySet that sets the recipients for the communication.

EnableSms

bool

Takes precedence over the 'Enable Sms' block setting. Use this to enable/disable the sending of an SMS communication.

EnableEmail

bool

Takes precedence over the 'Enable Email' block setting. Use this to enable/disable the sending of an Email communication.

FromEmail

string

The email to send the communication from. If none are supplied, the block will assume the email of the current person.

FromNumberGuid

Guid

The Guid of the System Phone Number to set this block to use. Note, that this number must be available to the block. You can see more information in the configuring phone numbers section.

MaxRecipients

int

ForceSendToParents

bool

If parent communication is enabled, this will force any communication to also be sent to the parents of any children in the recipients.

ShowFromName

bool

Whether or not to show the 'From Name' Email field.

ShowReplyTo

bool

Whether or not to show the 'Reply To' Email field.

IsBulk

bool

Takes precedence over the 'Is Bulk' block setting. Whether or not to set the communication as bulk or not.

ReplyTo

string

When provided (and Show Reply To is enabled), the "Reply To" value for an Email communication will be hard-coded to the provide value.

FromNumberGuid

Guid

The Guid of the system phone number to limit the SMS communication to (From Number). Note that this number must be available to the block.

Security (Approving Communications)

This block uses a unique security verb, named Approve. This security role determines if someone is allowed to instantly queue a communication, or if it must be submitted for approval beforehand. It is highly recommended to configure the security on this block, to ensure not anyone can send a communication to a large number of people.

Here is the security action configured to behave exactly the same as the web block:

This doesn't limit the number of email recipients but is the maximum number before . The confirmation message on the final page will change to say the message has been submitted for approval.

🧱
approval is required
Communications in Rock