# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.butlr.io/faqs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.