FAQs

Commonly Asked Questions about Webhook

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.