Outlook and Microsoft 365
Artavolo works with Outlook through each person's own Microsoft account (work, school or personal). There are three parts:
- A calendar, both ways. On a calendar view, Sync with Outlook keeps the table's records and one of your Outlook calendars in step. A record with a date is an event: rename it, move it or clear its date, and the event follows. Move, rename or add an event in Outlook, and the record follows. A date alone is an all-day event; a date with a time is a timed one. The sync runs every few minutes, and Save and sync now runs it at once.
- E-mails from a folder. In any view, E-mails from Outlook turns the e-mails that arrive in one of your Outlook folders into records of the table: the subject, the text, the sender and the files go into the fields you pick. Each e-mail is taken once. A sender who is a contact of the base's client portal is linked to the record and gets its replies.
- The Outlook add-in. Save to Artavolo on an open e-mail, in Outlook on the desktop, the web or a phone, adds it to a table you pick, the same way.
Each person connects their own account, and a sync writes as them, with their permissions. Artavolo asks Microsoft for their calendars (read and write), their mail (read only) and offline access, and keeps the refresh token encrypted. Изключи forgets the account and stops its syncs.
For the administrator: the Microsoft app
Connecting uses the same Microsoft app as signing in with Microsoft (see Единичен вход).
- In the Microsoft Entra admin center, open the app registration whose client ID and secret are in Artavolo's sign-in settings (or register one: any organization's accounts and personal accounts).
- Under Удостоверяване, add the redirect URI
https://your-artavolo/microsoft/callback(type Web). - Under API permissions, add the Microsoft Graph delegated permissions
offline_access,User.Read,Calendars.ReadWriteиMail.Read. A work tenant may need an administrator to grant consent once.
The cron (site/cron.php) runs the syncs; it must run every few minutes, as it already does for other jobs.
The Outlook add-in
- Each person creates an API token in Artavolo (their account, API tokens).
- In Outlook, open Get Add-ins, then My add-ins, Add a custom add-in, Add from URL, and give
https://your-artavolo/outlook/manifest.xml. A Microsoft 365 administrator can instead deploy it to everyone from the admin center (Integrated apps, upload the manifest). - On an open e-mail, Save to Artavolo asks for the token once and keeps it in Outlook for that person. Then it lists the tables they can add records to.
The add-in fills the same fields as the table's e-mail address (Requests by e-mail in a page's settings, see E-mail in); without one, the subject goes into the primary field.