> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worldvisagroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notification Channel Providers and Integrations

> Learn about the providers that WorldVisa supports for Email, Push, SMS, and Chat channels, and how to integrate them to send notifications and receive events.

Providers are the third-party services that deliver your notifications through the various channels. These are services such as SendGrid for email, Twilio for SMS, or Slack for chat.

WorldVisa provides a unified integration layer that connects your application to all these different providers. You connect your provider accounts to WorldVisa from the Integration Store on the WorldVisa dashboard, and WorldVisa's API handles the rest.

This approach means you can add, remove, or switch providers at any time without having to change your application's code.

> [!NOTE]
>
> Email and SMS select one integration for each message. Chat and push delivery also depend on the subscriber’s configured endpoints and credentials. Delivery does not automatically fall back to another provider if a send fails. See the delivery retry policy for what happens when a provider rejects a message.

## Provider vs. Integration

Understanding the difference between a provider and an integration is key to managing your channels.

* **Provider**: A provider is the third-party service responsible for sending the actual notification such as, Twilio, SendGrid, or Slack. Every provider supported by WorldVisa is identified by a providerId. Refer to this resource to see the full list of provider IDs used in WorldVisa.

* **Integration**: An integration is your specific, configured instance of that provider. It's the provider plus your unique credentials and settings. When creating an integration, you are required to assign it a name and identifier.

  While the name can be changed, the identifier cannot be changed after creation. This identifier is called the `integrationIdentifier`.

![Integration identifier field in the WorldVisa Dashboard for naming a provider connection](https://mintcdn.com/wv-enterprise/l3bkwl1N_3mOn9aW/images/developers/channels-and-providers/integrationidentifier.png?fit=max\&auto=format\&n=l3bkwl1N_3mOn9aW\&q=85\&s=a5bd021c39a9d561dae87ac93eb108de)

This means that you can have one provider but two separate integrations for that particular provider. Each of these is a unique integration that you can manage and trigger independently.

### Primary vs. Active integrations

Each environment can have multiple active integrations for a single channel.

![Primary and active integration settings in the WorldVisa Dashboard channel configuration](https://mintcdn.com/wv-enterprise/l3bkwl1N_3mOn9aW/images/developers/channels-and-providers/primary-active-integrations.png?fit=max\&auto=format\&n=l3bkwl1N_3mOn9aW\&q=85\&s=4b5bc619ac8eb9df6eadc4a99e9439dd)

* **Active integration**: Any integration that is "on" and ready to send notifications. You can disable an active integration at any time to stop sending messages through it.
* **Primary integration**: This is the default integration used when you trigger a notification.

How the primary integration behaves depends on the channel:

* **Email and SMS channels**: You can have many active integrations, but only one can be marked as the primary at a time. This primary integration is used by default for all email or SMS notifications unless you specifically override it.

* **Push and chat channels**: These channels do not use a single primary integration. Instead, WorldVisa uses all active integrations in parallel to deliver the message.

If you disable an integration that is currently marked as "primary" for Email or SMS channels, then WorldVisa automatically promotes another active integration to be the new primary. You can also manually set which active integration you want to be the primary one from the Integration Store.

> [card] [Integration conditions](https://docs.worldvisagroup.com/developers/integrations/integration-conditions.md)
>
> Route a send to a matching provider integration from subscriber or context data.

## Managing integrations across environments

Each integration is scoped to a specific environment. This means you must configure separate integrations for each environment, even if they point to the same provider.

This separation ensures that test messages don’t accidentally go to production users, and different credentials or delivery settings can be safely isolated across environments.

## Override default settings

WorldVisa provides an `overrides` object that can be used to access features that WorldVisa doesn't currently support but are supported by certain providers. This feature includes:

* Setting custom SendGrid headers.
* Using [Slack Block Kit](https://docs.worldvisagroup.com/developers/integrations/chat/slack.md#format-messages-with-block-kit).
* Defining platform-specific sounds for FCM push notifications.

> [!NOTE]
>
> For a complete guide on Overrides, refer to the [Trigger Overrides](https://docs.worldvisagroup.com/developers/integrations/trigger-overrides.md) documentation.

## Integration guides

Select a channel below to find the list of all supported providers integrations and their detailed setup guides:

> [card] [Email](https://docs.worldvisagroup.com/developers/integrations/email)
>
> Configure email providers and settings

> [card] [SMS](https://docs.worldvisagroup.com/developers/integrations/sms)
>
> Set up SMS messaging capabilities

> [card] [Push](https://docs.worldvisagroup.com/developers/integrations/push)
>
> Enable push notification delivery

> [card] [Chat](https://docs.worldvisagroup.com/developers/integrations/chat)
>
> Integrate with chat platforms


## Related topics

- [Integrations](https://docs.worldvisagroup.com/developers/concepts/integrations.md)
- [Integration conditions](https://docs.worldvisagroup.com/developers/integrations/integration-conditions.md)
- [Slack Chat Integration](https://docs.worldvisagroup.com/developers/integrations/chat/slack.md)
- [OneSignal Push Integration with WorldVisa](https://docs.worldvisagroup.com/developers/integrations/push/onesignal.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.