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

# Meta, e API Oficial

> Como configurar a API Oficial do WhatsApp (Meta) na LíderHub

export const IconViável = () => <span style={{
  color: '#2563eb',
  display: 'inline-flex',
  verticalAlign: 'middle'
}}><svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14" /><polyline points="22 4 12 14.01 9 11.01" /></svg></span>;
export const IconNãoViável = () => <span style={{
  color: '#dc2626',
  display: 'inline-flex',
  verticalAlign: 'middle'
}}><svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><circle cx="12" cy="12" r="10" /><line x1="15" y1="9" x2="9" y2="15" /><line x1="9" y1="9" x2="15" y2="15" /></svg></span>;

## Visão geral

A Meta ganha dinheiro com o uso da API Oficial e não incentiva o uso de APIs não oficiais. O problema é que a API Oficial carrega consigo alguns desafios:

* Requer **mais compliance**
* É **mais cara** (custo por mensagem)
* É **mais limitada** (templates precisam de aprovação; não há como editar ou apagar mensagens já enviadas)

Vamos destrinchar isso neste documento. Confira o comparativo completo em <Tooltip headline="API Oficial vs Não Oficial" tip="Comparativo completo entre as duas formas de conexão: custo, estabilidade, risco e funcionalidades." cta="Ver mais" href="/whatsapp/api-oficial-vs-nao-oficial">API Oficial vs Não Oficial</Tooltip>. Se você usa **API Não Oficial** e vê o número do contato borrado em alguns casos, saiba que é por regras de privacidade da Meta (LID); detalhes em [LID e número do contato borrado](/whatsapp/lid-numero-borrado).

## Etapa 1: Criar sua Business Manager (BM)

A primeira etapa para providenciar sua API Oficial é configurar seu **Portfólio Empresarial** (também chamado de Business Manager ou BM).

<Info>
  Se você já roda tráfego pago (Facebook Ads, Instagram Ads), certamente você já tem uma BM criada e validada. Nesse caso, pule para a Etapa 3.
</Info>

Acesse [business.facebook.com](https://business.facebook.com) e crie sua BM.

## Etapa 2: Validar sua Business Manager

Acesse a **[Central de Segurança](https://business.facebook.com/latest/settings/security_center)** da sua BM e preencha os dados solicitados.

<Frame>
  <img src="https://mintcdn.com/liderhub/2dHcqInLS3nYLPbV/images/security-center-inicio.png?fit=max&auto=format&n=2dHcqInLS3nYLPbV&q=85&s=e743d8ebc216081d4ffa9f4c262f3332" alt="Central de Segurança - início da validação" width="1816" height="929" data-path="images/security-center-inicio.png" />
</Frame>

Nesta etapa, você vai precisar:

* Fazer **autenticação de dois fatores**
* Completar a **verificação da empresa**
* Podem te solicitar um **CNPJ**, site e outros documentos

Se você já tem um CNPJ, essa etapa não deve ser um problema para você.

<AccordionGroup>
  <Accordion title="Processo de Validação">
    <img src="https://mintcdn.com/liderhub/2dHcqInLS3nYLPbV/images/processo-validacao-bm.png?fit=max&auto=format&n=2dHcqInLS3nYLPbV&q=85&s=739165d5681068540f84a3a7b8ae7dd1" alt="Processo de validação da Business Manager" style={{ backgroundColor: 'white', borderRadius: '8px', padding: '1rem' }} width="493" height="2048" data-path="images/processo-validacao-bm.png" />
  </Accordion>

  <Accordion title="Resultado final - BM validada">
    <Frame>
      <img src="https://mintcdn.com/liderhub/2dHcqInLS3nYLPbV/images/central-seguranca.png?fit=max&auto=format&n=2dHcqInLS3nYLPbV&q=85&s=0a0815399f582312bf7ecb02bfc92066" alt="Central de Segurança da Business Manager - BM validada" width="1918" height="963" data-path="images/central-seguranca.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

<Warning>
  O botão de verificação não apareceu na sua Central de Segurança? Leia abaixo.
</Warning>

<Accordion title="Botão de verificação não aparece — como resolver">
  A Meta só exibe o botão de verificação quando a sua BM tem pelo menos um **ativo vinculado** (como um app, uma WABA ou uma Página). Se você acabou de criar a BM e ainda não tem nenhum desses ativos, o botão simplesmente não aparece.

  Uma forma rápida de contornar isso é vincular sua Página ao recurso de **Páginas de notícias** da BM. Isso cria um vínculo que força o sistema a exibir o botão.

  <Steps>
    <Step title="Acesse Páginas de notícias">
      No menu lateral das Configurações da BM, clique em **Páginas de notícias**.
    </Step>

    <Step title="Clique em Selecionar Páginas">
      No canto superior direito, clique no botão **Selecionar Páginas**.
    </Step>

    <Step title="Pesquise e selecione sua Página">
      Na janela que abrir, use o campo **Pesquisar Páginas** para encontrar sua Página e selecione-a. Clique em **Concluir**.

      <Note>
        Isso não afeta sua Página de nenhuma forma. É apenas um vínculo técnico para desbloquear o botão de verificação.
      </Note>
    </Step>

    <Step title="Atualize a página e volte para a Central de Segurança">
      Atualize o navegador e acesse **Informações da empresa → Ver detalhes**. O botão de verificação vai aparecer normalmente.
    </Step>
  </Steps>
</Accordion>

Depois de validar, adicione um **meio de pagamento** (cartão de crédito). A Meta cobra por mensagem na API Oficial.

## Etapa 3: Providenciar um WABA

Depois que você tiver uma Business Manager validada, você precisa providenciar um **WABA** (WhatsApp Business Account).

<Note>
  WABA é o termo técnico para "WhatsApp válido na API Oficial".
</Note>

Nesta etapa, você pode fazer isso pela **LíderHub** ou pelo **Facebook**.

<CardGroup cols={1}>
  <Card title="Criar WABA do zero" icon="plus" href="/whatsapp/criar-waba-do-zero" cta="Ver mais" arrow={true}>
    Chip novo, sem histórico, via Cloud API.
  </Card>

  <Card title="Importar WABA" icon="arrow-right-to-bracket" href="/whatsapp/importar-waba" cta="Ver mais" arrow={true}>
    Já tem um WABA ativo e quer conectá-lo à LíderHub.
  </Card>

  <Card title="WABA - Coexistência" icon="arrows-rotate" color="#10B981" href="/whatsapp/waba-coexistencia" cta="Nossa sugestão" arrow={true}>
    Transforme seu WhatsApp existente em WABA.
  </Card>
</CardGroup>

## Etapa 4: Integração WABA e LíderHub

Agora que você já tem um WABA (ou vai criar um), é hora de integrá-lo à LíderHub.

Este fluxo é conhecido também como **Embedded Signup** — você vai conectar sua conta Facebook e Meta à LíderHub.

<Steps>
  <Step title="Iniciar nova conexão">
    Na LíderHub, acesse **[Conexões > Nova Conexão](https://chat.liderhub.ai/connections)** e selecione **API Oficial**:

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/selecionar-api-oficial.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=0c5bde8091e4697f31c1bae7e3d19cc2" alt="Seleção do tipo de conexão API Oficial na LíderHub" width="924" height="286" data-path="images/selecionar-api-oficial.png" />
    </Frame>
  </Step>

  <Step title="Aceite os termos de uso">
    Leia e aceite os termos de uso da Meta para prosseguir com a integração.

    <Frame>
      <img src="https://mintcdn.com/liderhub/L8a6FTHRiAd-xwgQ/images/termos-de-uso-meta.png?fit=max&auto=format&n=L8a6FTHRiAd-xwgQ&q=85&s=51b599e2e9bc17ab7a0fd06977925a31" alt="Termos de uso da Meta para integração com a LíderHub" width="665" height="775" data-path="images/termos-de-uso-meta.png" />
    </Frame>
  </Step>

  <Step title="Finalize o processo na Meta">
    Você tem 3 caminhos principais, de acordo com a [Etapa 3: Providenciar um WABA](#etapa-3-providenciar-um-waba):

    <Frame>
      <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/selecionar-ativos-meta.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=11d4030936bf12a25648f02d525162e1" alt="Seleção de ativos de negócios para compartilhar com a LíderHub" width="665" height="775" data-path="images/selecionar-ativos-meta.png" />
    </Frame>

    <AccordionGroup>
      <Accordion title="Portfólio Empresarial">
        Selecione seu **Portfólio Empresarial**. Note que neste momento já é necessário que sua BM esteja verificada (veja a [Etapa 2: Validar sua Business Manager](#etapa-2-validar-sua-business-manager)).

        <Frame>
          <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/portfolio-empresarial-verificado.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=c776dd19faa2b854689a55ab68389a35" alt="Seleção do Portfólio Empresarial verificado" width="594" height="360" data-path="images/portfolio-empresarial-verificado.png" />
        </Frame>
      </Accordion>

      <Accordion title="Conta do WhatsApp Business (WABA)">
        Selecione uma das 3 opções para prosseguir:

        <Frame>
          <img src="https://mintcdn.com/liderhub/Jlj76ime8oG0JILz/images/selecionar-waba-coexistencia.png?fit=max&auto=format&n=Jlj76ime8oG0JILz&q=85&s=2e5ea45e6dff9c660c99f739b7862f21" alt="Seleção do WABA para coexistência na LíderHub" width="666" height="775" data-path="images/selecionar-waba-coexistencia.png" />
        </Frame>

        <CardGroup cols={1}>
          <Card title="Criar uma conta do WhatsApp Business" icon="1" href="/whatsapp/criar-waba-do-zero" cta="Ver mais" arrow={true}>
            Crie uma nova conta do zero, novo WhatsApp, sem telefone, via Cloud API.
          </Card>

          <Card title="Conectar um app do WhatsApp Business" icon="2" color="#10B981" href="/whatsapp/waba-coexistencia" cta="Nossa sugestão" arrow={true}>
            Transforme seu WhatsApp Business existente em WABA via coexistência.
          </Card>

          <Card title="Selecione outros" icon="3" href="/whatsapp/importar-waba" cta="Ver mais" arrow={true}>
            Números WABA que você já compartilhou com a LíderHub vão aparecer aqui.
          </Card>
        </CardGroup>
      </Accordion>

      <Accordion title="Catálogo, Conta de Anúncios e Página">
        Escolha o **Catálogo**, a **Conta de Anúncios** e a **Página** que deseja vincular à sua conexão.
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

## Custos

A API Oficial tem custos cobrados pela Meta. Os custos são pagos diretamente na Meta, onde você cadastra um cartão de crédito.

Abaixo estão os tipos de template, e os preços para o Brasil:

<Warning>
  Os custos da API Oficial variam por país e são cobrados pela Meta. Consulte a [tabela de preços atualizada](https://developers.facebook.com/docs/whatsapp/pricing) para mais detalhes.
</Warning>

<AccordionGroup>
  <Accordion title="Serviço — USD 0 (grátis)">
    Mensagens de serviço são gratuitas. São respostas a mensagens iniciadas pelo cliente dentro da janela de 24 horas. **Estas são as mensagens mais comuns.**

    <Frame>
      <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/VPRhvok1FGCdITYW/images/template-service.webm?fit=max&auto=format&n=VPRhvok1FGCdITYW&q=85&s=e7c22fe41aa6afb90241ad8b48969a7d" data-path="images/template-service.webm" />
    </Frame>

    Quando a janela de conversação está aberta, as mensagens que você envia estão dentro das 24h.
  </Accordion>

  <Accordion title="Autenticação — USD 0.0068">
    Mensagens de autenticação são usadas para enviar códigos de verificação, como OTPs (senhas de uso único) para login ou confirmação de identidade.

    <Warning>
      A LíderHub não oferece suporte para este tipo de mensagem, porque entendemos que não há aplicações práticas do seu escritório enviar este tipo de conteúdo para seus leads ou clientes.
    </Warning>

    <Frame>
      <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/VPRhvok1FGCdITYW/images/template-auth.webm?fit=max&auto=format&n=VPRhvok1FGCdITYW&q=85&s=082b5bdd384b20b5b7fa31c36816a0c0" data-path="images/template-auth.webm" />
    </Frame>
  </Accordion>

  <Accordion title="Utilidade — USD 0.0068">
    Mensagens de utilidade são notificações transacionais, como confirmações de pedido, atualizações de entrega, lembretes de agendamento, entre outros.

    <Tip>
      Na LíderHub, mensagens de utilidade são úteis para atualização de status do processo do cliente.
    </Tip>

    <Frame>
      <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/VPRhvok1FGCdITYW/images/template-utility.webm?fit=max&auto=format&n=VPRhvok1FGCdITYW&q=85&s=b64e6278c20c35c30674a5f3e70e1509" data-path="images/template-utility.webm" />
    </Frame>
  </Accordion>

  <Accordion title="Marketing — USD 0.0625">
    Mensagens de marketing são promoções, ofertas, campanhas e mensagens comerciais enviadas aos contatos.

    <Tip>
      Na LíderHub, mensagens de template de Marketing são utilizadas principalmente como [Follow Up](/follow-up) no processo comercial.
    </Tip>

    <Frame>
      <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/VPRhvok1FGCdITYW/images/template-mkt.webm?fit=max&auto=format&n=VPRhvok1FGCdITYW&q=85&s=9f22a1ca5070fc2d7f4e7c2e7085bd3c" data-path="images/template-mkt.webm" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Janela de Atendimento

Na API Oficial, toda conversa funciona dentro de uma **janela de 24 horas**. A janela abre quando o cliente envia uma mensagem para você, e a partir desse momento você pode responder livremente por 24 horas sem custo adicional (mensagens de serviço).

Após as 24 horas, a janela se fecha. Para continuar a conversa, existem **2 condições**:

<Warning>
  * **Para enviar mensagem com janela fechada**: você só pode usar um **template pré-aprovado pela Meta** (autenticação, utilidade ou marketing), o que gera custo por mensagem.
  * **Para voltar a enviar mensagens gratuitas (serviço)**: a janela precisa ser **reaberta** — isso só acontece quando o **cliente responde** à sua mensagem de template. Enviar o template sozinho **não reabre** a janela.
</Warning>

|                                                                                      | <Tooltip tip="Cliente enviou alguma mensagem nas últimas 24h">Janela Aberta</Tooltip> | <Tooltip tip="Faz mais de 24h que o cliente enviou uma mensagem, ou o cliente nunca enviou">Janela Fechada</Tooltip> |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| <Tooltip tip="Há algum custo para enviar mensagens?">**Custo**</Tooltip>             | Grátis (mensagem de serviço)                                                          | Pago (custo por template enviado)                                                                                    |
| <Tooltip tip="Há alguma limitação no conteúdo a ser enviado?">**Conteúdo**</Tooltip> | Livre — texto, imagem, áudio, vídeo, documento                                        | Apenas templates aprovados pela Meta                                                                                 |

<Frame caption="Confira mais detalhes sobre mensagens de Template na LíderHub em [Gerenciar Mensagens](/templates).">
  <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/VPRhvok1FGCdITYW/images/templateweb.webm?fit=max&auto=format&n=VPRhvok1FGCdITYW&q=85&s=3e3248ffbec50f3efbd1446521dc8dda" data-path="images/templateweb.webm" />
</Frame>

Saiba mais na [documentação oficial sobre janela de atendimento](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows).

As mensagens de template na API Oficial devem ser **pré-aprovadas** pela Meta. Confira mais sobre o processo em [Solicitar Aprovação Meta](/templates/aprovacao-meta).

### Janela de Ponto de Entrada Gratuito

Quando o cliente entra em contato com você através de um **anúncio do Facebook ou Instagram** (Click-to-WhatsApp Ad) ou de um **botão de ação em uma Página do Facebook**, uma janela especial de **72 horas** é aberta — e todas as mensagens dentro dessa janela são **gratuitas**, independentemente da categoria.

<Frame caption="Se o lead veio de um anúncio, você tem **72 horas de conversação gratuita**, incluindo mensagens de marketing e utilidade.">
  <video autoPlay loop muted playsInline className="w-full rounded-xl" src="https://mintcdn.com/liderhub/arzjAb_KPU3AXP4D/images/ad-message-whatsapp.webm?fit=max&auto=format&n=arzjAb_KPU3AXP4D&q=85&s=4e04555255986460df5e0ec0d064f283" data-path="images/ad-message-whatsapp.webm" />
</Frame>

<Warning>
  * A isenção vale apenas para **templates** — você **não** tem custo extra para enviar mensagens de template nestas 72h
  * Você **não** tem liberdade para enviar mensagens de serviço (conteúdo livre) neste período de 72h
  * A [janela de serviço](#janela-de-atendimento) (24h) continua funcionando normalmente
</Warning>

Saiba mais na [documentação oficial sobre ponto de entrada gratuito](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing#free-entry-point-windows).

Para capturar o identificador de atribuição do anúncio (`ctwaClid`) e devolvê-lo à Meta para otimização de campanhas, consulte <Tooltip headline="CTWA Clid" tip="O que é o ctwa_clid e como acessá-lo via Custom Tool para otimizar campanhas." cta="Ver mais" href="/integracoes/ctwa-clid">CTWA Clid</Tooltip>.

## Editar ou excluir mensagens enviadas

A Cloud API da Meta não permite editar nem apagar mensagens depois do envio.

| Ação                    | App WhatsApp                                | Cloud API (API Oficial)               |
| ----------------------- | ------------------------------------------- | ------------------------------------- |
| Editar mensagem enviada | <IconViável /> Sim (dentro do prazo do app) | <IconNãoViável /> Não                 |
| Apagar mensagem enviada | <IconViável /> Sim (dentro do prazo do app) | <IconNãoViável /> Não                 |
| Coexistência            | <IconNãoViável /> Desativado no app         | <IconNãoViável /> Sem endpoint na API |

<Info>
  A [Message API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api/) da Meta permite enviar mensagens, mas não oferece métodos para editar ou apagar mensagens já enviadas. Isso vale para qualquer conexão via API Oficial na LíderHub - não é uma limitação da LíderHub, e sim da própria Meta.
</Info>

<Tip>
  Se a mensagem saiu errada, envie uma nova mensagem corrigindo o conteúdo. Revise o texto antes do envio, especialmente em automações, follow-ups e templates.
</Tip>

<Note>
  Veja também o comparativo completo em <Tooltip headline="API Oficial vs Não Oficial" tip="Entenda as diferenças entre a API Oficial do WhatsApp (Meta) e a API Não Oficial." cta="Ver mais" href="/whatsapp/api-oficial-vs-nao-oficial">API Oficial vs Não Oficial</Tooltip> e os detalhes de coexistência em <Tooltip headline="Limitações da Coexistência" tip="O que não funciona ou é limitado quando o número usa app WhatsApp Business e API Oficial ao mesmo tempo." cta="Ver mais" href="/whatsapp/limitacoes-coexistencia">Limitações da Coexistência</Tooltip>.
</Note>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre Meta, e API Oficial">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=Meta%2C%20e%20API%20Oficial&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="Preciso de CNPJ para usar a API Oficial?">
    Sim. A Meta exige verificação de empresa no Business Manager, que requer CNPJ ou documento equivalente.
  </Accordion>

  <Accordion title="Quanto tempo leva para ativar a API Oficial?">
    O processo completo pode levar de 3 a 10 dias úteis, dependendo da aprovação da Meta.
  </Accordion>

  <Accordion title="Posso usar API Oficial e Não Oficial ao mesmo tempo?">
    Sim, em números diferentes. Cada conexão na LíderHub pode usar um tipo diferente de API.
  </Accordion>

  <Accordion title="Posso trocar de API Não Oficial para Oficial?">
    Sim, você pode fazer isso via coexistência. O histórico de até 6 meses pode ser importado na primeira conexão.
  </Accordion>

  <Accordion title="Posso editar ou apagar uma mensagem já enviada pela API Oficial?">
    Não. A Cloud API da Meta não possui endpoints para editar ou excluir mensagens depois do envio. Se você enviou uma mensagem errada, envie uma nova mensagem corrigindo o conteúdo - não há como apagar ou alterar a mensagem original via API.
  </Accordion>
</AccordionGroup>