Developer Docs - Mobile Docs - Communication Commands

CallPhoneNumber

M v1.0

We're sure you can think of other uses, but wouldn't it be nice if your application had your church's phone number displayed somewhere and the user could just tap on it to call your church office? Yep. That would be nice. If only the user was on a phone or something like that.

The CommandParameter specifies the phone number to be dialed, if it's blank then nothing will happen.

SendEmail

M v1.0

With this command, you can request to create a new e-mail to be sent to a number of people. Notice that we said "request". This does not immediately send the e-mail but simply uses the OS standard e-mail application. In most cases, the user is sent over to the e-mail application and can then later return to your application.

SendSms

M v1.0

Don't you wish you could add a button with an icon of a chat bubble to your application that would allow your user to send a text message? Yeah, we did too. With this command, you can request to create a new text message to be sent to a number of people. Notice that we said "request". This does not immediately send the text message but simply uses the OS standard messaging application. In most cases, the user is sent over to the message application and can then later return to your application.

    
        
            15551239876
            15552224444
        
    

ShareContent

M v1.0

Using the ShareContent command you can open up the standard OS share dialog that lets the user share a piece of text or a URL to other apps and services.

Property UX

M v6.0

The sharing experience will change depending on the Title, Text, and Uri provided. Providing only a Title will not work ‒ a Text or Uri value is required. Let's review the options using the sample command here:

These screenshots show the OS share prompt and content received within the Messages app.

Title + Text

Title + Uri

Text + Uri

Uri

Title + Text + Uri

When sharing content via a URI, it is common for the content to include an image. The image is derived from the metadata of the webpage the URI links to. When using Rock RMS, editing this metadata can be done from within the advanced settings of the desired page.

Click here for deeper insight on metadata properties.

Without this metadata present, no image will be displayed when sharing content.