From 4b78c4334b5432b650cb41829f75949f7258324c Mon Sep 17 00:00:00 2001 From: Lieven Hollevoet Date: Thu, 5 Oct 2023 07:45:58 +0200 Subject: [PATCH] Add the setup detail that ViCare is required on the device (#29161) * Add the setup detail that ViCare is required on the device I ran into the problem that the setup procedure always resulted in an 'invalid credentials' error. Reason: I was doing the integration setup on my computer. Only after some time it dawned to me that the vicare:// URI probably needs the ViCare application and hence that I needed to run the setup on my mobile phone. Once I did that I was in business. Since I lost some time finding this out I think it makes sense to explicitly add this information to the setup procedure. * tiny tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/vicare.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/vicare.markdown b/source/_integrations/vicare.markdown index 0934f9b2aac..d42265d72e9 100644 --- a/source/_integrations/vicare.markdown +++ b/source/_integrations/vicare.markdown @@ -44,6 +44,8 @@ The required Client ID can be obtained as follows: The `heating_type` can either be `auto` to automatically find the most suitable type for your device or one of `gas`, `oil`, `pellets`, `heatpump`, `fuelcell`, `hybrid`. +Important: the redirect URI that you configure requires that you perform the initial setup on a device that has the ViCare application installed. If your device does not know how to handle the `vicare://` URL, you will receive an **Invalid credentials** notification and the setup procedure will fail. This means: install the ViCare app on your phone and set up the integration from your phone. + Multiple device instances might be generated depending on the number of burners and/or circuits of your installation. If there is more than a single instance all devices are suffixed with the circuit or burner ID. ## Viessmann API limits