To perform a Basic App installation, install the FieldChat app from the Procore marketplace, and sign up for a company account with FieldChat using your Procore username and password.
A Basic App installation allows you to import all your Procore users from your project directories and send activity logs to Procore.
A Basic App installation uses the user account of one of your users to connect to Procore. It's a good way to get your project up and going quickly with FieldChat, however we do recommend that you set-up a service account for the Advanced App Installation to access all of the Procore integration features that FieldChat offers.
When you set-up a Basic App installation, FieldChat uses your Procore user account to connect to Procore. It relies on the security permissions of your user account to read the project directory, update the daily log, etc.
The following features are supported with the Basic App installation:
Need Help? It's easy to book a 15 minute meeting with us to help your Procore integration going.
Users of the Procore web app can run FieldChat inside the Procore web app. Simply find the FieldChat (Embedded Experience) app on the Procore marketplace and install it. To make this app available to your projects, make sure you create an App Configuration, with a suggested title of "FieldChat" and select one or more projects that can use FieldChat.
When you access FieldChat for the first time, you should signup for a company account with your Procore credentials and link your first FieldChat project to Procore.
After you have created your FieldChat company account, you can import all the users in a Procore project directory into FieldChat so that you can easily invite them to FieldChat channels by email or text message.
To do this, select the "Procore" option in the hamburger menu at top left under "Integrations". You will then be prompted to pick a Procore project and the users from that project directory will be imported. You can also import users from the "Edit Project" page.
Once your users are imported, you can add them to one or more channels in your project where you want them to be able to communicate and collaborate with other team members. When users are first imported, they are set to texting users by default. If they install the mobile app, they will automatically become app users. Texting users can only be added to channels with phone numbers assigned to them.
You can enable ongoing real-time updates from Procore to keep users in FieldChat in-synch if you perform an advanced app installation (see section below).
Note: We recommend that you update your Procore project directory with mobile phone numbers for your foremen and subcontractors. FieldChat will automatically import these numbers and use them for text messaging. When you make changes to your directory simply re-import and the users will be automatically updated in FieldChat.
Once your users are imported, they can login to the FieldChat web app and mobile apps using their existing Procore credentials. If they are accessing the FieldChat app from inside the Procore web app, no additional login is required. Users can only access the channels that you have explicitly granted them access to in FieldChat.
You can use "Enable daily digest" option under "Edit Project" to automatically create a note every day at midnight containing a summary of all messages sent across all the channels of your project.
(Procore Service Account Required)
The Advanced App installation provides some additional integration features and requires the set-up of a Procore service account. With the Advanced App Installation you can:
In order to set-up a permanent integration with Procore that is not tied to a specific user, you should create a Procore Service Account. Doing this is required for photo uploads and notifications.
Note: We recommend that you book a 15 minute meeting with us to help you get your service account going as quickly as possible.
Instructions:
You need to be an account administrator in FieldChat and an administrator in Procore in order to be able to do this. In the Procore admin area, create a new service account and note the Client ID and Client Secret. You’ll need to enter those into FieldChat.
Once you've created the service account, you'll need to find the service account user in your company directory and assign a permission template that has access to the permissions below.
In order to import your project directories, grant read permission on the Directory tab. This will allow FieldChat to be able to import all of your Procore users.
If you wish to enable photo uploads from FieldChat to Procore, you should also grant standard permission to Photos.
If you wish to enable photo uploads from FieldChat to Procore, you should also grant standard permission to Photos.
If you wish to enable video and file uploads from FieldChat to Procore, you should also grant standard permission to Documents. You will also need this setting if you want to create PDFs in Procore for any created FieldChat logs.
If you wish to enable submitting manpower, notes, visitor or delivery logs captured in FieldChat to Procore, you should also grant admin permission to Daily Log.
If you wish to enable submitting observations to Procore from an observation log in FieldChat, you should also grant standard permission to Observations.
If you wish to enable submitting observations to Procore from an RFI log in FieldChat, you should also grant standard permission to RFIs.
If you wish to enable notifications in FieldChat from Procore, you should grant the following additional permissions:
Next, add all of the projects that you want FieldChat to be able to access.
Now you can login to FieldChat and select the "Procore" option from the top-left menu under "Integrations". Click on the "Set up service account" button and enter the Client ID and Client Secret. You will then be prompted to pick a Procore project to link to the current FieldChat project.
You can test that FieldChat is correctly connected to a Procore project. Go to "Edit Project" from the ellipses menu in your project list, and use the "Test Connection" button to confirm that everything is set-up correctly for your project. Any issues with the service account security will be displayed.
Watch a step-by-step video on how to set up a Procore service account
You can configure FieldChat channels to automatically upload to Procore albums and folders. You need to set-up a Procore service account using the instructions above in order to enable this feature, with at least standard level permission access to Procore photos and files. You will also need to ensure that the FieldChat projects you want to upload pictures from are each linked to a unique Procore project in the Procore configurations screen. After the service account is enabled, you will see a new "Upload images & files to Procore" option appear when you edit or create a channel.
The pictures sent as text messages, or uploaded images or files or videos using the FieldChat app will be automatically uploaded to folders with the specified name, as shown in the example below.
After you have imported your users, you can enable ongoing updates from Procore to FieldChat, using the "Enable user updates from Procore" option under "Edit Project". With this setting enabled, every time a new user is created, or an existing user changed, FieldChat will receive this information from Procore and update the user in FieldChat automatically.
You can configure FieldChat channels to receive alerts from Procore. You need to set-up a Procore service account using the instructions above in order to enable this feature.
In FieldChat, edit the project in FieldChat and make sure it is linked the your project in Procore. Then enable "Procore notifications for this project".
Finally, edit the channel that you want to receive Procore notifications. You will see a checkbox to enable notifications, and an optional filter list of specific resource names that you want to be notified about. If you leave this field empty, the channel will notify you about all changes to all resources that are sent by the Procore webhook.
Once the channel is configured, your channel will begin to receive notifications, and automatically mention assigned users, as in the example below:
Some notifications in FieldChat will provide a details button to link back to the Procore resource, including Inspections, Observation Items, Punch Items, RFIs, Submittals, Change Events, Timecard Entries, and Logs.