# FAQs

## **General Questions About Webhook**

**Do FPS values limit webhook frequency (e.g., 8 FPS in traffic mode, 3 FPS in presence mode)?**

No, FPS values relate to sensor sampling, not directly to webhook emission rates.

\
**What timezone are webhook timestamps in?**

All timestamps are in UTC.

\
**Do timestamps reflect sensing time, API receipt, or payload transmission?**

Timestamps reflect the moment of sensing.

**Are there rate limits or throttling mechanisms?**

No, there are no enforced rate limits.

\
**Do FPS values limit webhook frequency (e.g., 8 FPS in traffic mode, 3 FPS in presence mode)?**

No, FPS values relate to sensor sampling, not directly to webhook emission rates.

\
**How does the system handle high traffic or burst scenarios?**

Our backend infrastructure auto-scales and includes caching mechanisms to handle burst loads.

\
**What happens if a webhook delivery fails?**

We retry up to 3 times. If all retries fail, the message is dropped. We recommend querying `/v3/reporting` to retrieve any missed events.

\
**How long is the retry window?**

Retries are attempted within 10 seconds.

\
**What happens to events during a network outage or endpoint downtime?**

Events are queued and delivered once the system comes back online—starting from where it left off.

## Detections Webhooks

**What units are used in coordinate data?**

Butlr’s coordinate system uses meters. The \[x, y] values represent distances from the origin (typically the lower-left corner of the floor plan in Butlr Studio).

\
**How accurate are the coordinates in detection events?**

Accuracy is within 1–2 feet.

\
**How frequently are coordinates updated for the same person?**

Coordinate updates occur at approximately 1 to 3 messages per second.

\
**Is there a movement threshold to trigger a detection event?**

No—movement is not required to trigger a detection.

\
**What’s the difference between “local” and “world” coordinates?**

* World coordinates: Refer to the floor plan origin (0,0) in Studio.
* Local coordinates: Refer to the sensor’s internal coordinate system relative to its own field of view.

\
**How are tilted or angled sensors handled?**

Detections are only available from presence sensors, which are not installed at an angle, so no additional transformations are needed.

## Traffic Webhooks

**Traffic events include “in” and “out” counts - what is the aggregation window?**

Traffic counts are reported per event. It is not a fixed time window aggregation.