Applicable plans:


The free planThe complete planOn-demand plan
This feature is in beta version.



There are three options for check-in:

  1. Via the Teams notification.
  2. Via the Waldo calendar.
  3. Via the API, as described in this article.


These three methods can be used simultaneously. For example, Bob could check in on Monday via the Waldo calendar, on Tuesday via the bot notification, and on Wednesday via the badge system (using the APIs).


You can find more information about the regular check-in process at https://customer.hellowaldo.app/en/support/solutions/articles/8000100864-activate-or-deactivate-the-check-in


Prerequisites:


  1. Get your IP. You can find your IP with this website.

  2. Generate your API key with your IP at https://admin.hellowaldo.app/apikey


  3. Get your tenant ID at https://admin.hellowaldo.app/globalsettings


Sample script:


You can find attached a powershell sample script and a csv sample file.


  1. Save the csv file to your computer. Edit the file and replace the emails by the ones you want to check-in.

  2. Save the powershell script to your computer and edit the script.

  3. Set the apiKey with your API key.

    For example:

    $apiKey = 'CA+tyusuVrHIrqXvupPdDreydQP81//ZZAu6zcJ4h/g='

  4. Replace tenantId by your tenant ID.

    For example:

    $tenantId = 'g56d6a56-672c-412a-9a1d-a6979b7c559f'


  5. Replace pathFile by the location of the csv file.

    For example:

    $pathFile = 'c:\myscripts\emails-to-check-in.csv'


  6. Replace timezone by your timezone, using IANA format.

    For example:

    $timezone = 'Europe/Paris'


    You can find your timezone with this website.

  7. Replace startDate by the date and time the user checked-in.

    For example:

    $startDate = (Get-Date).ToString('2024-11-24T08:25:00')


When you book a desk for the same day, check-in is disabled.


If you want to check-in for multiple days, you can also change the endDate value.


Known issues: API Key is not valid or remote IP is not allowed 


You may encounter the following error message: Api Key is not valid or remote IP is not allowed.



In that case, check that the API key and the IP provided in the admin portal match those mentioned in the error message. Indeed, it is possible that you are making requests to the Waldo API using an IPv6 address.