Home Integrations

Integrations

Henry Lynch Mary Mittel
By Henry Lynch and 1 other •
27 articles

Integration Admin Page

Vsimple's integration admin page allows admins to update the way that data is mapped from 3rd party systems to Vsimple. Here's an overview of the key features: 1. An Active / Inactive Toggle allows you to turn an integration on or off 2. An Integration Type dropdown with the following options: - Create and Update: If Vsimple matches incoming data to an existing record, it will update it. Otherwise, Vsimple will create a new record. - Update Only: If Vsimple matches incoming data to an existing record, it will update it. Otherwise, the data will be ignored. 3. Define if the integration should update the name of the record (if no name is provided for a "Create and Update" integration the name will be the integration name plus the date and time stamp when the record was created). 4. Define if the integration should update the description of the record 5. Define if the integration should update the record type of the record (if left blank the default record type will be assigned to newly created records) 6. Define the custom field mapping between Vsimple and the Other Datasource - At least one custom field and one unique custom must be mapped - Mapped Field (enter the field id / name from the Other Datasource) - Hard-coded Value (enter a value that will always be set for a given integration) - Jsonata Expression (use code to define a more advanced mapping. Here's a link to what's possible with Jsonata and here's a sandbox to test it out) 7. Child objects can also be added to the mapping Please note that not all integrations are supported with the integration admin page. If you ever need any help making a change please reach out to Vsimple support!

Last updated on Feb 12, 2024

Microsoft Outlook Integration- Connection Status

In User Management, Vsimple now displays "Connection Status" - Pending Connection- User needs to locate a record with an email uploaded to the activity stream - Needs Attention- Microsoft has reset the connection token and the user must reconnect, following the same steps as above - Connected- User has properly connected their Outlook to Vsimple Once connected, the user will stay connected until Microsoft resets the refresh token. This can happen in a variety of ways: 1. Security & Policy Enforcement - Password change/reset: If the user changes their Microsoft account or organizational password, all existing refresh tokens are invalidated. - Multi-factor authentication (MFA) updates: If MFA requirements change, old tokens may be rejected. - Conditional Access Policies: Admins may enforce new location, device compliance, or sign-in risk rules that invalidate tokens. - Account compromise signals: Microsoft may revoke tokens if suspicious activity is detected. 2. App or Client Issues - Outlook profile corruption: Cached credentials or profiles can break token refresh. - Updates or reinstallations: Reinstalling Outlook or certain updates can clear authentication caches. - Revoked app consent: If the user or admin revokes consent for Outlook or a connected app, the refresh token is dropped 3. Environment or Device Changes - Device unenrolled or non-compliant: In organizations using Intune or device management, removing a device or falling out of compliance revokes tokens. - Sign-in from a new location or IP: Risk-based access controls may revoke old tokens to force re-authentication.

Last updated on Oct 01, 2025

Admin Outlook Integration- IT Admin Approval Guide

Overview This guide explains how an IT administrator can approve the Vsimple Outlook Integration in Microsoft Azure / Entra ID. This integration allows Vsimple users to: ·         Send emails from Outlook via Vsimple (including automated system emails sent on behalf of the user) ·         Sync and track Outlook email threads on Vsimple records to maintain a complete conversation history The integration uses Microsoft Graph delegated permissions, meaning Vsimple only acts on behalf of signed-in users who connect their Outlook account. What Permissions Are Requested The Vsimple Outlook Integration requests the following Microsoft Graph delegated permissions: ·         User.Read – Sign in and read the user’s basic profile ·         Mail.ReadWrite – Read and write the user’s mailbox (used to sync email threads) ·         Mail.Send – Send emails as the user (used for manual and automated emails) ·         offline_access – Maintain access via refresh tokens so users don’t have to reconnect frequently Option 1: Admin-Initiated Approval (Recommended) This is the most common and cleanest approach. Steps 1.      An IT administrator logs into Vsimple 2.      Navigate to a Record with an Uploaded Email 3.      Click Connect Outlook 4.      You will be redirected to Microsoft’s consent screen 5.      Review the requested permissions 6.      Select Consent on behalf of your organization 7.      Approve the app Once approved, all users in the tenant can connect Outlook without further admin involvement. Option 2: User-Initiated Admin Consent Request If a non-admin user attempts to connect Outlook and admin consent is required, Microsoft will trigger an approval workflow. Steps 1.      A user clicks Connect Outlook in Vsimple 2.      Microsoft detects that admin consent is required 3.      The user submits an Admin Consent Request 4.      An Azure / Entra ID admin receives the request 5.      Admin reviews and approves the Vsimple Outlook Integration in Azure NOTE: Some Azure accounts block users from initiating an admin consent request and will require Option 1. Verifying Approval in Azure / Entra ID After approval, you can confirm the setup: 1.      Go to Microsoft Azure 2.      Navigate to Enterprise Applications 3.      Select Vsimple Outlook Integration 4.      Open Permissions 5.      Confirm permissions are granted under Admin consent You should see Microsoft Graph delegated permissions similar to: - Mail.ReadWrite - Mail.Send - User.Read - offline_access Security & Data Handling Notes ·         Vsimple only accesses mailboxes for users who explicitly connect Outlook ·         Emails are linked to Vsimple records strictly for conversation tracking ·         No emails are deleted or modified outside of user actions ·         Access can be revoked at any time from Azure Revoking Access (If Needed) Admins can revoke access at any time: ·         Azure → Enterprise Applications → Vsimple Outlook Integration → Remove Support If you have questions or need assistance during approval: ·         Contact your internal Vsimple administrator ·         Or reach out to the Vsimple support team in app or at support@vsimple.com ✅ Once approved, users can immediately begin sending and tracking Outlook emails inside Vsimple.

Last updated on Jan 20, 2026

Sync Emails to Vsimple's Activity Stream

Methods at a glance There are six ways to get an email into a record. Copying the record email address onto your message is the fastest and works from any email app, including your phone. Method Best for Works from Setup needed Send or CC the record email Logging an email as you send it Any email app, desktop or phone None Forward to the record email Logging an email you already sent or received Any email app, desktop or phone None Drag and drop into Add file Quick logging from classic desktop Outlook Classic desktop Outlook only None Save as .eml or .msg, then upload Email apps where drag and drop doesn't work Any app that can save a message as a file None Outlook integration thread sync Keeping a whole thread logged automatically, replies included Outlook (Microsoft 365) IT admin approval once, then each user connects Email inbox (vAI Email Inbox or AI Parser) Emails that should create or update records automatically, like quote requests Any sender Set up by Vsimple support Step-by-step instructions 1. Send or CC the record email Every record has its own email address. Anything sent to it posts to that record's activity stream. 1. Open the record and click the three dots (…) at the top. 2. Click Copy Record Email. 3. Paste the address into the To, Cc, or Bcc line of your email. 4. Send the email. 5. Refresh the record in Vsimple. The email now shows in the activity stream. Use Cc when you want the customer's replies logged too. When they click Reply All, the record address stays on the thread. Recipients can't see a Bcc address, so their replies won't come back to the record. 2. Forward an email to the record Use this for an email that's already in your inbox or sent folder. 1. In Vsimple, open the record, click the three dots (…), and click Copy Record Email. 2. In your email app, open the email and click Forward. 3. Paste the record email into the To line and send. 4. Refresh the record. The forwarded email shows in the activity stream. 3. Drag and drop into Add file This works only from classic desktop Outlook. It doesn't work from browser email or the new Outlook for Windows, which doesn't let you drag emails out of it. Use method 2 or 4 instead. 1. In the record's activity stream, click Add file. 2. Drag the email from your Outlook inbox into the drop box. 3. Name the file and choose a File Type, so others can filter for it later. 4. Click Post. 4. Save the email as a file, then upload it 1. In your email app, open the email, click the three dots, and click Save As. 2. Choose .eml or .msg. 3. In the record's activity stream, click Add file and drag in the saved file (or browse to it). 4. Name the file, choose a File Type, and click Post. 5. Sync whole threads with the Outlook integration With the Outlook integration connected, Vsimple keeps an Outlook thread synced to the record once any message from it is on the record. New replies log on their own, without anyone forwarding them. One thread can sync to more than one record. One-time approval by your IT admin (Microsoft Azure / Entra ID): 1. Your IT admin logs into Vsimple and opens any record that has an email in its activity stream. 2. They click Connect Outlook. 3. On Microsoft's consent screen, they review the permissions, select Consent on behalf of your organization, and approve. After that, each user connects their own mailbox: 1. Open any record that has an email in its activity stream. 2. Click Connect Outlook and sign in with your Microsoft account. Admins can check each user's Connection Status in User Management. Pending Connection means the user hasn't connected yet. Needs Attention means Microsoft reset the connection, often after a password or MFA change, and the user needs to click Connect Outlook again. Connected means it's working. The integration also lets automations send notification emails from a user's own address instead of the record email. 6. Send emails to a dedicated email inbox Vsimple can set up an inbox address for a workflow. Emails sent or forwarded to it create a new record, or update a matching one, and the email logs to that record's activity stream. vAI can then read the email and its attachments to fill in fields. Common uses are quote requests, purchase orders, and service requests. To set one up, contact Vsimple support in the app or at support@vsimple.com. Tips and troubleshooting Most missing emails come down to a page that needs refreshing or an email app that blocks drag and drop. Find your issue below. Problem What to do An email sent to the record email isn't showing Refresh the record page. Then check the full record address was pasted into To, Cc, or Bcc. Customer replies aren't logging Put the record email on Cc , not Bcc, and ask the customer to use Reply All. Or connect the Outlook integration so the whole thread syncs. Drag and drop does nothing Browser email and the new Outlook for Windows block it. Forward the email to the record email, or save it as .eml or .msg and upload it. A logged email opens blank Update Outlook. Then go to your computer's Settings > Apps > Default Apps , search .eml , and pick the newest Outlook. Can't open .msg files on a Mac Install an MSG viewer app from the Mac App Store. Can't open logged emails on a phone or tablet Install the Letter Opener app for iOS or Android. Signature logos show up as extra attachments Add = = = = = (five equals signs with spaces) to your signature, above the logos. Make it white so it's invisible. Vsimple ignores everything below it. Outlook error: "Not Connected Users in Recipients" None of the To, Cc, or Bcc addresses belong to a connected Vsimple user. Open the email from the Files panel: three dots > Download Original Message . Outlook Connection Status shows Needs Attention Microsoft reset the connection, usually after a password or MFA change. Open a record with an email on it and click Connect Outlook again. Collaborators get notified on every email you upload Check Don't notify collaborators before you click Post . @mentioned users are still notified. When you upload an email, always pick a File Type. It lets your team filter the record's Files panel for emails later. FAQ Which method should I use? Day to day, CC the record email when you send. For long back-and-forth threads in Outlook, connect the Outlook integration so replies log on their own. For emails that should start new work, ask Vsimple support about an email inbox. Do I need Outlook? No. Sending to, CCing, or forwarding to the record email works from any email app, including Gmail. So does saving an email as a file and uploading it. Only drag and drop and the thread sync need Outlook. Can I log an email from my phone? Yes. Open the record, click the three dots, and click Copy Record Email. Then CC or forward from your phone's email app. Can a customer's email land on the record directly? Yes. Anything sent to the record email logs to the stream. If you CC the record email, the customer's Reply All logs too. Does the Outlook integration read my whole mailbox? No. Vsimple only accesses mailboxes of users who connect Outlook, and only links emails to records to track conversations. It doesn't delete or change your emails. Your IT admin can remove access at any time in Azure under Enterprise Applications > Vsimple Outlook Integration > Remove.

Last updated on Oct 20, 2026