# Integrations

<p class="lead">Connect ERP Instfy to email, Slack, Twilio (SMS), Zoom, Google Calendar and Webhook: what each one is for, what you need and how to test it.</p>

Integrations carry information from ERP Instfy to the tools your team already uses: automatic emails, Slack alerts, SMS, Zoom meetings, Google Calendar events and sending data to other systems. All of them are set up by the Company user on the Settings screen.

[[roles: Company]]

!image[Email notification tab in Settings, next to Slack, Twilio, Zoom and Google Calendar](/assets/img/erp/integrations.webp)

## Before you start

- Log in with the **Company** user.
- Have an active account with the service you will connect and access to its credentials (keys, tokens or server details).
- Finish the basic company settings. See [Company settings](#/settings).

:::warn
Integration credentials give access to external accounts. Store them carefully, do not share them by chat or email and change them if someone who had access leaves the company.
:::

**Menu path:** *Settings*, tab for the integration you want

## Overview

| Integration | Tab in Settings | What it is for | What you need |
|---|---|---|---|
| Email | Email Settings | Sending system emails | Your provider's outgoing server (SMTP) details |
| Email notifications | Email Notification Settings | Choosing which events trigger an email | Email already set up |
| Slack | Slack Settings | Receiving alerts in a Slack channel | A Slack workspace and access to create the connection |
| Twilio | Twilio Settings | Sending SMS | A Twilio account with a number and credentials |
| Zoom | Zoom Meeting Settings | Creating meetings from the ERP | A Zoom account and app credentials |
| Google Calendar | Google Calendar Settings | Sending events to Google Calendar | A Google account and project credentials |
| Webhook | Webhook Settings | Sending events to other systems | A URL that receives the calls |

## Email (Email Settings and Email Notification Settings)

Email is the most important integration: without it, password recovery, sending documents and automatic alerts may not work.

<ol class="steps">
<li>Ask your email provider for the outgoing (SMTP) details: server, port, encryption type, username and password.</li>
<li>Open <strong>Settings > Email Settings</strong> and fill in the fields with those details and the sender.</li>
<li>Click <strong>Save Changes</strong>.</li>
<li>Use the test email option, if available, or trigger a password recovery for a test user.</li>
<li>Open <strong>Settings > Email Notification Settings</strong>, turn on the events you want and click <strong>Save Changes</strong>.</li>
</ol>

:::tip
Use an address on your company's domain as the sender. Emails sent from your own domain are less likely to land in spam.
:::

## Slack (Slack Settings)

Sends alerts about ERP events to a Slack channel, so the team can follow along without opening the system.

<ol class="steps">
<li>In Slack, create the connection for the channel that will receive the alerts, following Slack's own instructions, and copy the connection detail it generates.</li>
<li>Open <strong>Settings > Slack Settings</strong> and paste the information into the indicated fields.</li>
<li>Choose the events that should trigger an alert, if the screen offers that option.</li>
<li>Click <strong>Save Changes</strong>.</li>
<li>Test it: create a record that triggers an alert (for example, a lead or an invoice) and check that the message reached the channel.</li>
</ol>

## Twilio for SMS (Twilio Settings)

Sends SMS messages based on system events.

<ol class="steps">
<li>In the Twilio console, copy the account credentials and the number that will send the messages.</li>
<li>Open <strong>Settings > Twilio Settings</strong> and fill in the fields with those details.</li>
<li>Choose the events that trigger an SMS, if the screen offers that option.</li>
<li>Click <strong>Save Changes</strong>.</li>
<li>Test it with an event that sends an SMS to your own number.</li>
</ol>

:::note
SMS sending is billed by Twilio, to your Twilio account, according to its terms.
:::

## Zoom (Zoom Meeting Settings)

Lets you create and track Zoom meetings from the *Zoom Meetings* item in the menu.

<ol class="steps">
<li>In the Zoom developer area, create the app credentials for your account.</li>
<li>Open <strong>Settings > Zoom Meeting Settings</strong> and fill in the fields with those credentials.</li>
<li>Click <strong>Save Changes</strong>.</li>
<li>Test it: open <strong>Zoom Meetings</strong> in the menu and create a meeting. See <a href="#/zoom-meetings">Zoom meetings</a>.</li>
</ol>

## Google Calendar (Google Calendar Settings)

Sends ERP events to Google Calendar, so appointments also appear on the team's calendar.

<ol class="steps">
<li>In the Google console, create or use a project with access to the Google Calendar API and generate the required credentials.</li>
<li>Open <strong>Settings > Google Calendar Settings</strong> and fill in the fields or upload the credentials file, as the screen requests.</li>
<li>Click <strong>Save Changes</strong>.</li>
<li>Test it: create an event in the ERP <strong>Calendar</strong> and check that it appears in Google Calendar. See <a href="#/calendar">Calendar</a>.</li>
</ol>

## Webhook (Webhook Settings)

Sends an automatic call to a URL whenever an event happens in the ERP. This is how you connect the ERP to other systems and to automation tools.

<ol class="steps">
<li>Have a URL ready to receive the calls (from your own system or an automation tool).</li>
<li>Open <strong>Settings > Webhook Settings</strong> and add a webhook: choose the event and enter the destination URL.</li>
<li>Click <strong>Save</strong> or <strong>Save Changes</strong>.</li>
<li>Test it: trigger the event in the ERP and check in the destination system that the call arrived.</li>
</ol>

For automation ideas, see [Process automation](#/automation).

## Frequently asked questions

### Do I need to set up every integration?

No. Only email is recommended for everyone, because password recovery and sending documents depend on it. The others are optional and should be turned on according to your company's routine.

### The integration was saved, but nothing happens. What should I check?

Check the credentials, whether the account with the external service is active and whether the events you want are checked. Then trigger a test event. See [Troubleshooting](#/troubleshooting).

### Do integrations cost anything?

Setup in ERP Instfy is part of the system, but some external services charge for usage on your own account, such as sending SMS through Twilio. Check each service's terms.

### Can I connect the ERP to my own system?

Yes, through Webhook. You enter your system's URL and the ERP sends the data when the event happens.

## Next steps

With the integrations on, review your plan and follow the dashboards.

:::related
settings, plan, dashboards, troubleshooting
:::
