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

# API oficial da Meta

> Disparo por templates aprovados, sem risco de banimento, com custo por mensagem.

A API oficial da Meta (Cloud API) é o caminho **sem risco de banimento**: os números são registrados na Meta, e os envios seguem as regras de templates e janelas.

## Conectar um número

Em **Ferramentas › API oficial da Meta**, conecte pelo **WhatsApp Embedded Signup** (número novo ou coexistência com o app WhatsApp Business) ou colando o token de usuário do sistema. O uso da API oficial é um **add-on mensal** da plataforma (número na API oficial), pago com cartão, Pix ou créditos.

O botão de Embedded Signup é o caminho recomendado: a Meta faz a verificação do número dentro do fluxo, com o Business verificado.

## Templates

Fora da janela de 24 h (a pessoa não escreveu há pouco), a Meta só permite **templates aprovados**. O disparo em massa usa template aprovado; a plataforma sincroniza os templates e o status de aprovação.

<Note>
  Mensagens de **marketing** saem pela **Marketing Messages API**, com volta automática para a Cloud API quando faz sentido.
</Note>

## Custo por mensagem

A Meta cobra por mensagem entregue. A plataforma mostra o **custo estimado** na criação da campanha e o **custo real** no relatório (tabela editável pelo superadmin em Plataforma › Integrações).

Preços de referência (Brasil, por mensagem entregue): marketing ≈ R$ 0,32; utilidade e autenticação ≈ R$ 0,034. A Meta reajusta periodicamente.

## Webhook assinado

A conexão recebe um webhook assinado (`X-Hub-Signature-256`) com status de entrega, leitura e falha, e o **BSUID** (identificador do usuário por empresa), usado no envio por `recipient`.

## Regras

* Disparos em massa com API oficial exigem template aprovado.
* Cobrança e reenvio automático (fora da janela de 24 h) exigem template, então essas opções ficam restritas a texto livre nos outros provedores.
