Software and connections

Authorising a piece of software, seeing action by action what the connection genuinely permits, and cutting it whenever you want.

What you will have at the end

A connection authorised with your own account at your provider, and a Connections screen that lists each connection and the account that authorised it. The authorisation states, action by action, what the connection permits: read, create, modify, cancel.

You will also know who decides on appointments: the calendar you connect stays yours — the receptionist reads availability there and writes appointments into it.

Have at hand the account allowed to authorise a connection at your provider.

Before you start

  • The exact name of the software and its edition: two editions of one product do not permit the same actions
  • An account allowed to authorise a connection at that provider
  • The calendar that receives appointments, one per site
  • If your software has no page with us, the “your software” page explains what to do

No password for your software reaches us: authorisation happens at the provider, and the token is encrypted on our side.

The steps

  1. Step 1

    Open the Connections screen and pick the software

    The entry states the provider, the edition and the account's region. Those three change what is permitted: they are not an administrative detail.

  2. Step 2

    Authorise with your account

    You are sent to the provider, you sign in there, and you come back. Your account grants the access, and you can withdraw it from their side as well as ours.

  3. Step 3

    Read what the connection permits

    Read, create, modify, cancel: the authorisation says whether the action is permitted with your account. An action that is not permitted is not attempted — the receptionist collects a request instead.

  4. Step 4

    Keep a single appointment calendar

    For appointments, a single calendar decides: the one you connected. That avoids two calendars overwriting each other in turn.

  5. Step 5

    Check the list of connections

    The Connections screen lists each connection with the account that authorised it. A connection you withdraw no longer appears there, and the receptionist then takes a request rather than announcing a confirmation.

Why state what the connection permits rather than a switch

“Connected” means nothing to an owner. What matters is what the connection can do: read availability, create an appointment, change it, cancel it. Two products of the same name, in two different editions, do not permit the same actions — and the difference shows up during a call.

So the four actions are told apart, including the refused ones. An action that is not permitted is not attempted: the receptionist takes a request, the customer knows a confirmation is coming, and you are not left repairing a promise the system could not keep.

The calendar that decides, tokens and revocation

For appointments, a single calendar decides. That choice is not a matter of taste: with two calendars, a change made here and a change made there overwrite each other in turn, and the last write wins by accident of timing.

Authorisation happens at your provider, with your account. We do not receive your password; the access token is encrypted on our side and can be withdrawn from either end — from the Connections screen, or from your account at the provider. Each withdrawal is logged with the time.

The edge cases

Your software has no page here

Describe what you want linked rather than the product name: reading availability, creating a customer record, filing a request. That is what the “my software” page is for, and many needs are covered by the tools already in the workspace.

Someone else administers your account

Authorisation needs an account allowed to grant application access at the provider. Have that person do it: an authorisation attempted from an ordinary account fails, and the error comes from the provider, not from us.

The connection drops overnight

If the provider refuses access, the receptionist falls back on taking a request rather than announcing a confirmation she cannot verify.

You switch software

Revoke the old connection before authorising the new one, and keep a single appointment calendar. Appointments already created stay where they are: revoking cuts access, it erases nothing at your former provider.

Two sites, two accounts

Each site carries its own connection. A single account wired to both mixes availability up and offers times from one site to customers of the other.

If something does not work

Authorisation fails at the provider

The account used probably lacks the right to grant application access. Try again with an administrator account for your organisation at that provider.

The connection reads, but creates nothing

That is a normal, displayed state: some actions are not permitted at that provider. The receptionist then collects a request, and you confirm inside your software.

Two appointments contradict each other between the systems

Two calendars are receiving appointments. Keep a single one for the receptionist, then correct once by hand: the rest holds on its own afterwards.

You want to cut the access

Revoke from the Connections screen, or from your account at the provider. Both work, and the withdrawal is logged with the time.

Frequently asked questions

The questions about connections.

Do I have to connect software to start?

No. The receptionist answers, qualifies and summarises with no connection at all. Software gets linked when it brings something specific: real availability, an existing customer record, a follow-up already in place.

Do you see my password?

No. Authorisation happens at your provider, on their sign-in screen. We hold an encrypted access token, which you can withdraw from their side as well as from ours.

What does a non-permitted action mean?

That your software, in its edition, does not permit that action through the connection, so it is not attempted. The receptionist takes a request instead, and the screen says so rather than letting you assume everything goes through.

That is why every line stays on screen, permitted or not.

How do I know the connection still works?

The Connections screen lists your connections with the authorised account; if the provider refuses access, the receptionist takes a request rather than confirming an appointment she cannot write.

Can I cut access without warning?

Yes, from either side, and it takes effect immediately. The withdrawal is logged with the time, so what was done before the cut can be established.

Who decides when the two disagree?

The connected calendar. If two calendars are receiving appointments, keep a single one, then correct the entry once by hand: after that it holds on its own.

Write to a person

If this article does not settle your case, write to the address below: a person reads it and answers you in writing. Give your business name, what you were trying to do and, for a call, its date and time.

[email protected]Contact us: what to write depending on your request