Preview · This help is still growing and will be extended over time.
Configure the Bexio integration
Connecting Bexio to echo for caller identification, invoices and projects
With the Bexio integration, echo searches your Bexio contacts when a call comes in or when you search in echo, and shows the matching person or company in the contact cockpit. For a contact from Bexio, echo can also show their invoices and bills and projects, and users can create new contacts in Bexio.
Bexio is set up in two parts:
- Once for the organization – an administrator adds Bexio as an integration, either during the initial setup or later under Settings → Integrations.
- Once per user – every user connects their own Bexio account under Settings → My accounts. echo searches Bexio only for users who have connected, and each user sees exactly what their Bexio account is allowed to see.
Prerequisites
- An echo administrator adds the integration. Users can connect their own account themselves.
- Every user who wants to see Bexio data needs a Bexio login with access to the contacts. For invoices, bills and projects, their Bexio user also needs access to those areas.
Permissions echo requests
When a user connects, Bexio asks them to confirm that echo may access their account. echo requests these permissions:
- Show contacts (
contact_show) – search people and companies - Edit contacts (
contact_edit) – create new contacts from echo - Show invoices (
kb_invoice_show) – invoices in the contact cockpit - Show bills (
kb_bill_show) – bills in the contact cockpit - Show projects (
project_show) – projects in the contact cockpit
echo also reads the user's name and email address from the sign-in and keeps the connection active (offline_access), so users don't have to sign in to Bexio again every time.
Add Bexio as an integration (administrator)
- In echo, open Settings → Integrations.
- Click Add integration and select Bexio.
- Bexio now appears below Integrations in the settings menu. Its page holds no connection details; it points users to My accounts and lets you remove the integration.
Then connect your own Bexio account as described below. Your colleagues each do the same (user guide: Sign in to Bexio).
Connect your Bexio account (every user)
Open My accounts
In echo, open Settings → My accounts and scroll to the Bexio section.
Sign in to Bexio
Click 1 Login. A Bexio sign-in window opens. Sign in with your Bexio account and confirm the requested permissions. The window closes by itself afterwards.
Check the connection
The panel now shows your name and the email address of your Bexio account with the status Connected.
As long as a user has not connected, echo shows a banner at the top: Please log in with your personal Bexio account to connect Bexio. Open settings leads straight to My accounts. Users can close the banner or hide it with Don't show again; they can still connect at any time under Settings → My accounts.
What echo shows from Bexio
Caller identification. echo looks up the caller's number in the phone and mobile fields of your Bexio contacts. It tries the common notations of the number, for example +41 44 123 45 67, +41441234567 and 044 123 45 67. A person found in Bexio is shown together with the company they belong to.
Search. In echo you can also search Bexio by name or email address.
Links to Bexio. Open person in Bexio and Open company in Bexio open the record in Bexio.
Depending on the features enabled for your organization, the contact cockpit also shows these sections for a contact from Bexio:
- Invoices & Bills – the contact's invoices and bills with amount and status, filterable by status and year.
- Projects – the contact's projects with their duration and an Open in Bexio link.
- Create new contact – if echo finds nobody, users can create the person or company in Bexio (Create in → Bexio).
Disconnect and reconnect
- Logout 1 removes your personal connection. echo then no longer searches Bexio for you. Click Login to connect again.
- If Bexio no longer accepts the stored sign-in, for example because access was revoked in Bexio, the status changes to Connection error and echo shows the banner Your Bexio connection has expired. Click Login and sign in again.
- An administrator can remove the whole integration on the Settings → Bexio page under Remove integration: click Remove Bexio and confirm with Remove. echo then no longer searches Bexio for anyone. You can add the integration again at any time.
Troubleshooting
There is no Bexio section under My accounts. Bexio has not been added as an integration. An administrator adds it under Settings → Integrations.
Callers from Bexio are not recognized. Check that:
- your connection under Settings → My accounts shows Connected;
- the number is stored in the phone or mobile field of the contact in Bexio, in a usual notation;
- your Bexio user can see that contact.
Invoices, bills or projects are missing. These sections only appear for contacts that come from Bexio. Check that your Bexio user has access to invoices, bills and projects in Bexio.
“An unknown error occurred. Please try again.” The sign-in did not complete. Click Login again and finish the sign-in in the Bexio window without closing it.