Source: https://gitlab-test-org.docs.pageloop.ai/integrations-introduction

# Integrations Overview

Integrations connect Fyno to the providers you already use, so you can send notifications over any channel (SMS, Email, Push, WhatsApp, and more) from one place.

This page explains the core concepts behind integrations and walks you through sharing an integration setup with someone who holds the credentials.

## Key concepts

| Concept            | What it means                                                                        |
| ------------------ | ------------------------------------------------------------------------------------ |
| **Channel**        | The method you use to reach your users, such as SMS, Email, Push, or WhatsApp.       |
| **Provider**       | The company or service that delivers messages on a channel, such as Twilio or MSG91. |
| **Account**        | A single set of credentials for a provider, added to your Fyno workspace.            |
| **Integration ID** | A unique, auto-assigned identifier for each account you add.                         |

## Channels

Channels are where every integration starts. A channel is the method of communication you use to reach your end users. Since relying on a single channel is rarely enough, Fyno supports multiple channels side by side.

Each channel has its own provider-specific setup guides, covered in the following sections.

## Providers

Providers are the companies or services that deliver your SMS, Email, Push, and other messages. Depending on your business needs, you can connect one or more providers under each channel.

Providers are grouped under the channel they serve. Select a provider to add one or more accounts for it.

> [!TIP]
>
> You can add **up to 5 accounts per provider**. For example, under the **SMS** channel, you can add up to 5 Twilio accounts.

Don't see your provider listed? Reach out to us at **<support@fyno.io>** and we'll do our best to help.

## Integration ID

Every account you add receives an **Integration ID**. To find it, open the provider from the Providers listing page and select the account you added.

> [!INFO]
>
> Integration IDs are assigned automatically by Fyno and cannot be edited.

## Public Integration Link

Don't have the credentials to set up an integration yourself? Generate a **public integration link** and share it with someone who does.

The person you share it with can complete the setup without needing access to your Fyno account. Once they finish, the integration appears in your workspace automatically.

### Generate a public integration link

1. Open the required provider from the Providers listing page.
2. Under **Accounts**, click **Add account**.

   ![Accounts panel with the Add account option](assets/add-account.png)
3. In the **Add new account** form, click **Don't have the credentials?** below the **ADD ACCOUNT** button.

   ![Add new account form with the Don't have the credentials? link](assets/add-new-account-form.png)
4. In the **Share Integration URL** pop-up, enter a name in the **Custom Integration Name** field.

   ![Share Integration URL pop-up](assets/share-integration-url.png)
5. Click **GENERATE URL**.
6. Click **COPY URL** and share the link with the person who will complete the setup.

   ![Public URL generated](assets/public-url-has-been-generated.png)

> [!INFO]
>
> A public link is valid for **up to 48 hours** from when it is generated, and expires as soon as the integration is added.

### Manage a public integration link

After you generate a link, the account appears in your Accounts list and updates once the setup is complete.

| Action              | What it does                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------- |
| **COPY URL**        | Copies the public link so you can share it again.                                           |
| **RE-GENERATE URL** | Creates a new link when the old one shows **URL expired**. The previous link stops working. |
| **Delete**          | Removes the account from the **Public Integration Link** section and invalidates its link.  |
| **VIEW DOCS**       | Opens the setup guide for that provider.                                                    |
