Skip to main content

PeoplePow Integration

You can send people detection data from Plate Recognizer PeopleTracker straight into PeoplePow, the queue and occupancy management platform, by configuring a webhook in your people-config.ini.

PeoplePow receives PeopleTracker events through a webhook endpoint. PeopleTracker sends a people_detected event when a person enters the frame, and a dwell_time event when they leave, allowing PeoplePow to track head counts, queue times, and occupancy per camera.

Requirements​

Step 1. Create a camera in PeoplePow​

  1. Sign in to PeoplePow.
  2. In the left navigation, click Cameras, then click Create Camera.
  3. Fill out the form. The most important field is the Camera Code, a short unique identifier such as entrance-1.
caution

The Camera Code must exactly match the [[camera-id]] you use in people-config.ini. PeoplePow uses this value to look up the correct camera, and events for an unknown camera code are rejected.

  1. Scroll down to the Schedules section within the same form and add at least one schedule covering the time window you expect detections.
warning

If a camera has no active schedule at the time an event is received, PeoplePow silently discards the event and no data is saved. For testing, add a schedule that covers 24/7 so no detections are dropped.

  1. Click Save to create the camera and its schedule simultaneously.
tip

You can add, edit, or remove schedules at any time in the camera settings page.

Step 2. Generate an API key​

  1. Click your profile avatar near the bottom of the left sidebar, then go to Profile and scroll to the API Keys section.
  2. Select your team from the dropdown, then click New API Key.
  3. Copy the full key immediately, it is shown only once.

Step 3. Configure PeopleTracker​

Navigate to the PeopleTracker working directory, locate the people-config.ini file, and open it. Use the following examples to configure the Webhooks and Cameras sections.

Webhooks section​

people-config.ini
[webhooks]
  [[peoplepow]]
    url = https://app.peoplepow.com/api/v1/log-people/
    header = Authorization: Token YOUR_PEOPLEPOW_API_KEY
    image = yes
danger

Replace YOUR_PEOPLEPOW_API_KEY with the key you copied in Step 2. Never commit this value to source control.

For On-Premise PeoplePow deployments, replace the host in url with your own PeoplePow domain, for example https://peoplepow.example.com/api/v1/log-people/. Make sure HTTPS is set up properly and avoid self-signed certificates.

Cameras section​

people-config.ini
[cameras]
  [[entrance-1]]
    active = yes
    url = rtsp://<rtsp_user>:<rtsp_password>@<rtsp_url>:<rtsp_port>/<rtsp_camera_path>
    webhook_targets = peoplepow
    dwell_time = true
    trajectory = true
    max_dwell_delay = 15
info
  • The [[camera-id]] (entrance-1 in the example) must match the Camera Code you created in Step 1. If you use multiple cameras, give each one a different id.
  • webhook_targets = peoplepow tells PeopleTracker to send detection data from that camera to the peoplepow webhook defined above. See Webhook Parameters for more details.
  • dwell_time = true is required for occupancy and duration metrics. It tells PeopleTracker to send a dwell_time event when a person leaves the frame; without it, visits never receive an end time. trajectory = true is optional and includes the movement path in the payload.

Step 4. Restart PeopleTracker​

To apply the changes, restart the Docker container:

docker restart people-tracker
tip

To confirm that the changes have taken effect, check the container logs:

docker logs -f people-tracker

Step 5. Verify the data flow​

  1. Have a person walk in front of the camera. PeopleTracker sends a people_detected event when they enter the frame, and a dwell_time event when they leave (after max_dwell_delay seconds).
  2. Go to the PeoplePow dashboard and confirm the per-camera metrics update, such as the current head count, the rolling average queue times, and the last updated timestamp.

Congrats! Your PeopleTracker detections are now flowing into PeoplePow.

API Reference​

Looking to automate your setup? You can manage cameras, visits, teams, and all other platform resources programmatically through our API. Explore the full PeoplePow API Reference for authentication guides, request structures, and webhooks.