Need help?
Email support@terssie.com with your vehicle model, iOS version, and a short description of the issue.

Getting started

  1. Install Terssie on your iPhone from Xcode or TestFlight (distribution depends on your build).
  2. Open Settings in the app and set Server URL to https://api.terssie.com (or your self-hosted backend).
  3. Complete Tesla OAuth through the backend and pair your virtual key at tesla.com/_ak/terssie.com.
  4. Run Diagnostics in the app to confirm vehicle and backend connectivity.
  5. Enable notifications and grant location/Bluetooth permissions when prompted for Smart Features and Phone Key.

Backend & API

  • Production API: api.terssie.com
  • Public virtual key hosted at /.well-known/appspecific/com.tesla.3p.public-key.pem
  • Vehicle commands route through the Terssie vehicle-command proxy
  • Use Diagnostics → “Backend Ready” and “Vehicle Connected” to verify status

Permissions

  • Location — approach welcome and home battery guard
  • Bluetooth — Phone Key pairing and door unlatch
  • Notifications — sentry triggers, battery alerts, and briefings
  • Background location — optional, only when Approach Welcome is enabled

Frequently asked questions

Grok briefings are empty or unavailable

Full Grok summaries require an XAI_API_KEY configured on your backend. Without it, the app still shows vehicle and trip data but AI-generated text will be limited. Check Grok → Status in the app.

Phone Key pairing fails

Phone Key requires a physical iPhone (not Simulator), Bluetooth enabled, and your VIN saved in the app. After tapping “Start BLE Pairing,” authorize with your key card on the center console. Enable “BLE unlatch on approach” in Smart Features once paired.

Vehicle shows offline in the app

Ensure your Tesla account token is valid, the virtual key is paired, and the vehicle-command proxy is running with the matching private key. Re-run Diagnostics and follow the listed next steps.

Trips are not recording

Trip recording starts automatically when the backend detects driving. Keep the server URL correct and leave trip monitoring active (shown in Grok → Status). Polling increases while the vehicle is in drive.

How do I revoke Terssie’s access?

Remove Terssie from your Tesla account’s third-party app list or use Tesla’s consent management page. You can also stop using the app and delete your device registration from the backend.

In-car delivery messages don’t appear

The vehicle must be online and awake enough to receive fleet commands. Try “Send Message to Car” from In-Car Delivery while the car is reachable, and confirm delivery toggles are saved.

Related links