Consent UI enable your users to securely provide consent to their EV data to you. You can use the following information to build a customized url and redirect your customer to it
Base URL
This is the entry point to consent UI from your app.
https://connect.telematica.so/connect
Query Params
app
*
App-id for your app
user
*
User-id of user in your database
deviceType
One of vehicle
, charger
, hvac
, inverter
. Defaults to vehicle
.
brand
Brand of the device, if known beforehand. This will skip the brand selection screen
callbackUrl
(deprecated)
This param is deprecated and will be dropped soon. Please use the callbackEnv
param instead.
callbackEnv
One of dev
, stage
, prod
.
If multiple callback urls are registered with Telematica, this param will dictate where the webhook event for user.devices-connected
will be sent.
If your app has only 1 endpoint registered, you can ignore this param.
If your app has multiple endpoints registered, leaving this empty will send events to all endpoints.
If your app has multiple endpoints registered, and the value of this param is valid, the event will be sent to endpoint corresponding to your chosen environment.
Note: Callback URLs must be registered with Telematica beforehand. For more details contact us
redirectUrl
url where we will redirect the end user using webview browser redirect. This will typically be an app URL (yourApp://somepage
). The redirect URL schema must be registered with Telematica beforehand.
region
One of EU
, US
or IN
. This will show only the supported device models on brand-selection page.
siteId
SiteId of the device in your database. This will be forwarded to you in the callback. A site
is an abstraction at Telematica level to represent group of devices (EV, charger, HVAC and solar inverter) in single location that should be controlled together.
siteName
Site name of the device in your database. This will be forwarded to you in the callback.
metadata_*
All query params with key starting with prefix of metadata_
are pass through params. These will be passed as-is to the callback you receive on device connection success.