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
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.