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

# Connect your WhatsApp Business number

> Add a business number from your WhatsApp Business Account by its Phone Number ID, and get it approved by Brudcast.

export const DemoVideo = ({id, title, embedUrl, src, poster, duration}) => {
  if (embedUrl) {
    return <figure className="brd-media" data-media-id={id}>
        <iframe className="brd-media-frame w-full aspect-video" src={embedUrl} title={title} allow="accelerometer; autoplay; clipboard-write; encrypted-media; picture-in-picture" allowFullScreen />
      </figure>;
  }
  if (src) {
    return <figure className="brd-media" data-media-id={id}>
        <video className="brd-media-frame w-full aspect-video" src={src} poster={poster} controls playsInline preload="metadata" />
      </figure>;
  }
  const label = duration ? `Video walkthrough coming soon · ${duration}` : "Video walkthrough coming soon";
  return <Placeholder id={id} kind="video" label={label} description={title} ratio="16 / 9" icon={<PlayIcon />} />;
};

export const Screenshot = ({id, src, srcDark, alt, caption}) => {
  if (!src) {
    return <Placeholder id={id} kind="screenshot" label="Screenshot coming soon" description={alt} icon={<ImageIcon />} />;
  }
  return <figure className="brd-media" data-media-id={id}>
      <img className="brd-media-frame block dark:hidden" src={src} alt={alt} />
      <img className="brd-media-frame hidden dark:block" src={srcDark || src} alt={alt} />
      {caption && <figcaption className="brd-media-caption">{caption}</figcaption>}
    </figure>;
};

<Snippet file="early-access.mdx" />

By the end of this page you'll have a business number from your WhatsApp Business Account submitted
to Brudcast, and you'll know how to follow its review.

<Screenshot id="ss-whatsapp-connect-your-waba-hero-numbers" alt="The Numbers tab with one business number marked Approved and a Default badge" />

<Info>
  **Before you start**, you need a WhatsApp Business Account with a verified phone number, and that
  number's **Phone Number ID**. You don't need credits or a subscription to add a number. See
  [What you need](/channels/whatsapp/overview#what-you-need).
</Info>

<Accordion title="Watch the walkthrough" icon="circle-play">
  <DemoVideo id="V17" title="Connect your WhatsApp Business number" duration="3 min" />
</Accordion>

<Steps>
  <Step title="Copy the Phone Number ID from Meta">
    In your WhatsApp Business Account, find the phone number you want to use and copy its
    **Phone Number ID**. It's a long number that identifies the phone number in Meta, such as
    `123456789012345`. It isn't the phone number itself.
  </Step>

  <Step title="Add the number in Brudcast">
    Go to **Channels > WhatsApp**, open the **Numbers** tab, and select **Add Number**. The
    **New WhatsApp Sender** dialog opens.

    <Screenshot id="ss-whatsapp-connect-your-waba-02-add-number" alt="The New WhatsApp Sender dialog on the Details step with the Label and Phone Number ID fields" />
  </Step>

  <Step title="Enter the details">
    | Field                               | What to enter                                   |
    | ----------------------------------- | ----------------------------------------------- |
    | **Label**                           | A name for your own use, such as `Support line` |
    | **Phone Number ID**                 | The ID you copied from Meta                     |
    | **Set as default for this channel** | Optional                                        |

    Select **Continue**.
  </Step>

  <Step title="Review and submit">
    Check the summary, then select **Submit for Approval**. The number appears in the list as
    **Pending**.
  </Step>

  <Step title="Wait for Brudcast's review">
    Brudcast reviews the number. The **Awaiting Review** counter shows how many numbers are waiting.
    When the review is done, the number becomes **Approved**, or **Rejected** with the reason shown
    under the status.
  </Step>
</Steps>

## Statuses

| Status        | Value       | What it means                                              |
| ------------- | ----------- | ---------------------------------------------------------- |
| **Pending**   | `pending`   | Submitted. Review hasn't started                           |
| **In review** | `in_review` | Brudcast is reviewing it                                   |
| **Approved**  | `approved`  | Brudcast approved the number                               |
| **Rejected**  | `rejected`  | Brudcast rejected it. The reason is shown under the status |

This review is Brudcast's own. Meta approves your message templates separately. See
[Message templates](/channels/whatsapp/overview#message-templates).

## Manage a number

* **Edit** (pencil icon): change the label or the default. The **Phone Number ID** locks once
  review starts. To use a different one, add it as a new number.
* **Set as default** (star icon): only an approved number can be the default.
* **Delete** (bin icon): removes the number for good.

## Troubleshooting

<AccordionGroup>
  <Accordion title="A whatsapp sender identity with this value already exists for this organization" icon="circle-alert">
    **Why:** you've already added a number with that Phone Number ID.

    **Fix:** use the existing entry in the **Numbers** tab.
  </Accordion>

  <Accordion title="The Phone Number ID can't be changed once its review has started. Register a new sender to use a different one." icon="circle-alert">
    **Why:** Brudcast reviews that exact ID, so it locks once review begins.

    **Fix:** add the other Phone Number ID as a new number.
  </Accordion>

  <Accordion title="The number shows Rejected" icon="circle-alert">
    **Why:** Brudcast rejected it. The reason is shown under the status.

    **Fix:** fix the problem the reason describes, then add the number again. Email
    [support@brudcast.com](mailto:support@brudcast.com) if it isn't clear.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="WhatsApp overview" icon="message-circle" href="/channels/whatsapp/overview">
    Requirements, Meta-approved templates, and what a message costs.
  </Card>

  <Card title="Sender identities" icon="id-card" href="/channels/overview#sender-identities">
    How sender identities work across channels.
  </Card>
</Columns>