home

MinistryPlatform

RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

Tools

Certification Tool

The Certification tool integrates with MinistrySafe and allows you to track certifications for individuals who take part in ministry and volunteer opportunities.

  • This tool requires an integration with the third-party training provider, MinistrySafe.
  • With the Certification Tool, you can:
    • Create Certification records for contacts and participants.
    • View the current status of Certification records for selected individuals.
    • Facilitate Certification training for selected individuals to complete through MinistrySafe.
  • You can launch the Certification Tool from an open record or from a selection of records on the Contacts, Participants, or Participant Certification pages.
Note: SPoCs can grant user access to this tool.

Certification Tool Configuration Settings

Initial Setup

A SPoC must set up a MinistrySafe Webhook to send results back to MinistryPlatform. See the instructions in this MinistrySafe article: How to Add Webhooks.
  • For Webhook URL, enter https://[your MP CloudApps Abbreviation].cloudapps.ministryplatform.cloud/tools-dev/api/certificationstatusapi/postministrysafestatus.
  • For Webhook Username, enter a username of your choice and retain this value to add in your Configuration Settings.
  • For Webhook Password, enter a password of your choice and retain this value to add in your Configuration Settings.
  • For Webhook for, select Quizzes.

This tool relies on several configuration settings:

Note: Note that MinistrySafe is one word, so be sure to check for and eliminate any unnecessary spaces!
COMMON, CertificationsProvider
Your church's Certifications provider. If NULL, certifications cannot be completed and you will see an error indicating that no provider is configured. We currently support the value, "MinistrySafe" (case sensitive and no spaces).
COMMON, CertificationsApiAddress
The base address for the Certifications API. For MinistrySafe, this should be safetysystem.abusepreventionsystems.com/api/v2/users.
COMMON, CertificationCallbackUsername
The username value you set when you created the MinistrySafe Webhook.
COMMON, CertificationCallbackPassword
The password value you set when you created the MinistrySafe Webhook.
COMMON, CertificationsPassingScore
The number that defines the minimum score for a certification training to be considered passing, if applicable.
TOOLS, CertificationsApiKey
The private API Key provided by your Certifications provider, MinistrySafe, to interact with their API. For help, see this MinistrySafe article: How to Generate an API Key.

Create a New Certification

  1. Go to the Contacts, Participant, or Participant Certification page.
  2. From the Tools menu, select Certifications.
  3. Select the Certification Type you want to create.
  4. Under Selection Info, review the number of selected individuals in each category for this Certification Type.
    • Certifications Current/Completed: Number of individuals from the selection whose Certification record has a status of Passed set to Yes.
    • Certifications In Process: Number of individuals from the selection whose Certification record has a status of Passed set to N/A.
    • Certifications Expired/Missing: Number of individuals from the selection whose Certification record has a status of Passed set to No OR do not currently have a record for this Certification Type.
  5. Optional: Enter any notes you want to include.
  6. Click Submit.
    • A record or request is created for each selected individual in the Expired/Missing category. If the individual did not already have a Participant record, one is created.
    • Requests are sent to MinistrySafe. For details, see this MinistrySafe article: Abuse Prevention Systems API Documentation.
  7. If needed, you can search for another individual to certify. Otherwise, you can close the tool.
Outside of the Platform:
  • MinistrySafe receives information from MinistryPlatform.
  • MinistrySafe sends an email with a Certification Request form to the selected individuals.
  • Individuals receive the email, begin training, and eventually complete training.
  • MinistrySafe sends updated Certification information to MinistryPlatform.
  • Certification records and Participant records are updated via the API to include the Certification Completed date and time as well as Passed set to Yes or No.
portal
MinistryPlatform

Last updated: November 26, 2024