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

# Channels

> Configure WhatsApp, Messenger, and Shopify connections.

**Settings → Channels** contains the app credentials used by your tenants to connect WhatsApp, Messenger, and Shopify.

<Info>
  Configure these settings **once**. Tenants do not need to enter your app credentials — they only connect their own WhatsApp account, Facebook Page, or Shopify store.
</Info>

<Columns cols={3}>
  <Card title="WhatsApp" icon="message-circle" href="#whatsapp">
    Your Meta app, so tenants can connect their WhatsApp Business Account.
  </Card>

  <Card title="Messenger" icon="facebook" href="#messenger">
    Your Meta app, for connecting Facebook Pages.
  </Card>

  <Card title="Shopify" icon="shopping-bag" href="#shopify">
    Your Shopify app, so tenants can connect their own store.
  </Card>
</Columns>

## WhatsApp

Configure your Meta app so tenants can connect their WhatsApp Business Account. Create the app in the [Meta Developers Console](https://developers.facebook.com/apps).

<Note>
  Your Meta app must be approved as a **Tech Provider** before tenants can connect through Embedded Signup. See [Tech Provider Approval](/pa/tech-provider-approval) for the step-by-step process.
</Note>

### Meta App Credentials

<Frame caption="The WhatsApp tab, with the Meta app credentials and Embedded Signup switches">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/channels-whatsapp-credentials.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=ff9998df8bf775c9f86bfec2b0a4d2bb" alt="The WhatsApp tab, with the Meta app credentials and Embedded Signup switches" width="1607" height="655" data-path="images/pa/channels-whatsapp-credentials.png" />
</Frame>

| Field                                      | Description                                                                 |
| ------------------------------------------ | --------------------------------------------------------------------------- |
| **App ID**                                 | Your Meta app ID.                                                           |
| **App Secret**                             | Your Meta app secret.                                                       |
| **Embedded Signup Config ID (no catalog)** | Configuration ID from **Meta App Dashboard → Facebook Login for Business**. |

<Note>
  The **API Version** is fixed by the platform and cannot be changed.
</Note>

### Tenant Connection

**Embedded Signup (no catalog)** allows tenants to connect their WhatsApp Business Account through Meta's onboarding process.

### Webhook Configuration

<Frame caption="The Webhook Configuration card, with the webhook URL and Connect Webhook button">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/channels-whatsapp-webhook.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=5d5e649482b8bc1714ca77293f1f7234" alt="The Webhook Configuration card, with the webhook URL and Connect Webhook button" width="1259" height="390" data-path="images/pa/channels-whatsapp-webhook.png" />
</Frame>

The page shows the webhook URL and its connection status. Click **Connect Webhook** to register the webhook with Meta.

<Warning>
  Save the Meta credentials before connecting the webhook.
</Warning>

## Messenger

Configure your Meta app for connecting Facebook Pages. The same Meta app can be used for WhatsApp and Messenger, or you can use a separate app.

<Note>
  The app needs Advanced Access to the Messenger Page permissions before tenants outside your team can connect a Page. See [Messenger Permissions](/pa/messenger-permissions) for the required permissions, the Facebook Login configuration, and App Review.
</Note>

<Frame caption="The Messenger tab, with the Meta app credentials and connection switches">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/channels-messenger.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=5b471c7eeb667855f341d6124068caf3" alt="The Messenger tab, with the Meta app credentials and connection switches" width="1613" height="614" data-path="images/pa/channels-messenger.png" />
</Frame>

| Field          | Description                                             |
| -------------- | ------------------------------------------------------- |
| **App ID**     | Your Meta app ID.                                       |
| **App Secret** | Your Meta app secret.                                   |
| **Config ID**  | Configuration ID with the `pages_messaging` permission. |

### Tenant Connection Options

| Option              | How tenants connect                                           |
| ------------------- | ------------------------------------------------------------- |
| **Embedded Signup** | Tenants connect their Facebook Page through Facebook Login.   |
| **Manual Connect**  | Tenants enter their Page ID and long-lived Page Access Token. |

<Warning>
  If both options are disabled, tenants cannot connect a Facebook Page.
</Warning>

## Shopify

Configure your Shopify app so tenants can connect their own Shopify store. Create the app in your Shopify Partner Dashboard.

<Frame caption="The Shopify tab, with the URLs to register, API credentials and OAuth scopes">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/channels-shopify.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=eb3e64e1457a92df1e24ab03772d3b83" alt="The Shopify tab, with the URLs to register, API credentials and OAuth scopes" width="1623" height="797" data-path="images/pa/channels-shopify.png" />
</Frame>

<Info>
  Use a **public or unlisted app** so it can be used by multiple tenants. A Shopify custom app is limited to one store.
</Info>

### Shopify App Settings

| Field                   | Description                               |
| ----------------------- | ----------------------------------------- |
| **API Key (Client ID)** | Client ID from your Shopify app.          |
| **API Secret Key**      | Secret key from your Shopify app.         |
| **Admin API Version**   | Shopify API version used by the platform. |
| **OAuth Scopes**        | Permissions requested from each store.    |

### URLs to register

The page provides these URLs with copy buttons. Add them to your Shopify app exactly as shown.

* **App URL**
* **Allowed redirection URL**
* **Webhook endpoint**

<Warning>
  Make sure the **App URL** is registered correctly. It is used when merchants open your app.
</Warning>

### Tenant-owned Shopify Apps

**Allow tenants to use their own Shopify app** is disabled by default.

When enabled, tenants can optionally enter their own Shopify app credentials from their workspace settings. Tenants already connected through your app will continue to work.
