Zum Hauptinhalt springen

Checkr

Checkr führt Hintergrundprüfungen für Mitarbeitende und Ehrenamtliche durch – ein nahezu allgemeiner Bedarf für jede Gemeinde mit einem Kinder- oder Jugendprogramm. B1 hat keine eingebaute Funktion für Hintergrundprüfungen – das Beauftragen von Prüfungen, das Nachverfolgen der Ergebnisse und die Einhaltung der Prüfvorgaben finden alle bei Checkr statt; das folgende Rezept verbindet lediglich B1-Ereignisse mit Checkr. Checkr hat keine Zapier-App, aber die Checkr-Integration von Make.com ist geprüft und stellt die Aktionen bereit, die Sie benötigen, um aus einem B1-Ereignis eine Prüfung zu starten.

Vorsicht

Dieses Rezept verwendet die Make-App für B1.church, die noch nicht veröffentlicht ist (siehe Make). Bis dahin muss die B1-Seite dieser Szenarien mit dem Modul HTTP von Make aufgebaut werden, das die REST-API von B1 aufruft.

Bevor Sie beginnen

  • Ein Checkr-Konto mit API-Zugang und mindestens einem konfigurierten Prüfpaket
  • Ein Make-Konto
  • Ein B1Admin-Benutzer mit der Berechtigung Einstellungen bearbeiten

Was Sie verbinden können​

Die Checkr-App von Make stellt 1 Auslöser und 6 Aktionen bereit:

RichtungB1- / Make-AuslöserAktion
B1 → CheckrB1 group.member.added (gefiltert auf ein Ehrenamtsteam)Checkr: Kandidat erstellen → Einladung zur Hintergrundprüfung erstellen
Checkr → B1Checkr-Webhook (Einladungs- / Berichtsereignis)B1: Datensatz der Person aktualisieren (z. B. Markierung „Checkr bestanden“)

Die Checkr-Aktionen von Make: Kandidat erstellen, Einladung zur Hintergrundprüfung erstellen, Kandidat abrufen, Bericht abrufen, voraussichtliche Dauer des Berichts abrufen und Einladung abrufen. Dazu kommen 4 Suchmodule.

Einrichtung​

1. Einen B1-API-Schlüssel erstellen​

Einstellungen → Entwickler → API-Schlüssel → Neuer API-Schlüssel:

  • settings:write – für den Auslöser-Webhook
  • people:read – um Name und E-Mail-Adresse der Person nachzuschlagen, wenn eine Prüfung gestartet wird
  • (Optional) people:write, wenn Sie den Berichtsstatus als benutzerdefiniertes Feld oder als Markierung zurückschreiben möchten

2. Das Szenario „Prüfung bei Anmeldung von Ehrenamtlichen starten“ in Make erstellen​

  1. Auslöser – B1.church: Ereignisse beobachten (group.member.added).
  2. Filter – nur fortfahren, wenn data.groupId mit Ihrem Team „Ehrenamtliche Kinderarbeit“ (oder einem gleichwertigen Team) übereinstimmt.
  3. Aktion – B1.church: Person suchen (anhand von data.personId), um E-Mail-Adresse sowie Vor- und Nachname zu erhalten.
  4. Aktion – Checkr: Kandidat erstellen. Ordnen Sie Vorname, Nachname und E-Mail-Adresse aus Schritt 3 zu.
  5. Aktion – Checkr: Einladung zur Hintergrundprüfung erstellen. Ordnen Sie die neue Kandidaten-ID aus Schritt 4 dem Feld candidate_id zu. Wählen Sie das Prüfpaket (z. B. tasker_standard oder was Ihr Konto anbietet).
  6. (Optional) Aktion – Slack: Ihre Koordination für den Schutz von Minderjährigen darüber informieren, dass eine Prüfung eingeleitet wurde.

Schalten Sie das Szenario ein. Neue Ehrenamtliche im betreffenden Team erhalten automatisch eine Checkr-Einladung per E-Mail; sie füllen sie auf ihrem Telefon oder Laptop aus, und Checkr führt die Prüfung durch.

3. (Optional) Den Bericht zurückerhalten​

  1. Auslöser – Checkr: Ereignisse beobachten (Webhook). Make registriert beim Aktivieren einen Checkr-Webhook.
  2. Filter – nur fortfahren, wenn event_type = report.completed.
  3. Aktion – Checkr: Bericht abrufen (mit der Berichts-ID aus dem Webhook).
  4. Aktion – B1.church: Person suchen (anhand der E-Mail-Adresse des Kandidaten).
  5. Aktion – Bedingte Benachrichtigung über Slack / E-Mail: die Koordination mit dem Status clear / consider / suspended informieren.

Hinweis: B1 hat derzeit kein eingebautes Feld für den Status der Hintergrundprüfung. Praktische Möglichkeiten sind (a) das Ergebnis zur Prüfung in einen privaten Slack-Kanal zu posten, (b) es zur Nachvollziehbarkeit in eine Google Tabelle zu schreiben oder (c) die Person bei clear einer B1-Gruppe „Geprüfte Ehrenamtliche“ hinzuzufügen.

Häufige Rezepte​

Ehrenamtliche alle 2 Jahre erneut prüfen​

Kombinieren Sie das Obige mit einem zeitgesteuerten Auslöser in Make:

  • Auslöser – Make: Zeitplan (monatlich)
  • Aktion – HTTP – Anfrage senden: GET auf /membership/groupmembers?groupId=… der B1-API für Ihre Gruppe „Geprüfte Ehrenamtliche“ (die B1.church-App hat keine Listenaktion)
  • Aktion – Filter in Make: Prüfdatum älter als 22 Monate
  • Aktion – Checkr: Einladung zur Hintergrundprüfung erstellen (wie beim ersten Ablauf)

Zugang der Stufe 1 sperren, bis die Prüfung abgeschlossen ist​

Wenn Ihre Gemeinde die Gruppenzugehörigkeit in B1 nutzt, um den Zugang zu steuern (z. B. erscheinen nur Mitglieder der Gruppe „Geprüft“ in den Dienstplänen), halten Sie neue Ehrenamtliche in einer Wartegruppe, bis das Checkr-Ereignis report.completed sie freigibt.

Einschränkungen und Hinweise​

  • Checkr ist für die meisten Prüfpakete nur in den USA verfügbar. Gemeinden in Australien, Großbritannien und Kanada benötigen eine Alternative.
  • Die Preisgestaltung erfolgt pro Prüfung – jede Einladung, die Sie in Make erstellen, verbraucht eine echte Prüfung. Testen Sie zuerst in der Sandbox- bzw. Testumgebung von Checkr (die Checkr-App in Make verwendet die Zugangsdaten der Verbindung, daher wechseln Sie zwischen Test- und Live-Betrieb, indem Sie die Zugangsdaten tauschen).
  • Der API-Zugang bei Checkr hängt vom Tarif ab. Kleinere Checkr-Konten sind unter Umständen nur über die Oberfläche nutzbar; wenden Sie sich an Checkr, um die API freizuschalten.

Fehlerbehebung​

  • Kandidat erstellen schlägt mit 403 fehl – das Checkr-API-Token ist nur lesend oder hat nicht die richtigen Kontoberechtigungen. Stellen Sie es im Checkr-Dashboard mit Schreibberechtigung neu aus.
  • Die Einladung kommt nie an – prüfen Sie die E-Mail-Adresse des Kandidaten in Schritt 3; in B1 ist das Feld für diese Person unter Umständen leer. Fügen Sie vor dem Checkr-Schritt einen Filter ein, der eine E-Mail-Adresse verlangt.
  • Der Webhook-Auslöser startet nicht – die Webhook-Registrierung bei Checkr schlägt manchmal stillschweigend fehl, wenn Ihr Make-Konto nicht in einem kostenpflichtigen Tarif ist, der ausgehende Webhooks unterstützt. Prüfen Sie auf der Seite Webhooks im Checkr-Dashboard, ob die URL von Make aufgeführt ist.

Siehe auch​