Pular para o conteúdo
D-APITestar grátis

api oficial · cloud api da meta

API oficial do WhatsApp para o cliente do seu SaaS que pedir

Ofereça a API oficial do WhatsApp ao cliente que exige Cloud API sem manter uma segunda integração: o mesmo sessionId, o mesmo webhook e o mesmo preço por conexão da não oficial.

SaaS testa 14 dias com o time técnico ajudando na integração.

conexões na D-API
1.875
de uptime garantido em contrato
99,9%
datacenters no Brasil
4
por ligação de WhatsApp na API não-oficial
R$ 0
  • Mesmo preço por conexão

    Na D-API a conexão oficial custa o mesmo que a não oficial. A tarifa de mensagem da Meta é cobrada pela Meta, na WABA do seu cliente.

  • Mesmo código de envio

    O connectionId devolvido no onboarding é o sessionId das rotas de envio. O seu serviço de mensagens não precisa saber qual API está do outro lado.

  • Um handler de webhook

    Com webhookMode normalized, o evento da conexão oficial chega no mesmo formato da não oficial. Quem já tem parser da Meta usa meta_passthrough.

  • Número e WABA do cliente

    O número fica no Business Portfolio e na WABA do próprio cliente. A D-API entra como app parceiro assinado na conta.

A API oficial do WhatsApp é a Cloud API da Meta, e na D-API ela chega ao seu SaaS como mais um tipo de conexão, ao lado da API não oficial. A maior parte da sua base vai continuar bem servida pela não oficial, que conecta o número do cliente por QR code em minutos e não tem tarifa por mensagem. Em algum momento, porém, um cliente maior vai pedir a oficial: uma rede de clínicas com área de compliance, um e-commerce que dispara milhares de avisos de entrega por dia, uma operação que compra anúncio de clique para WhatsApp. Esta página mostra como dizer sim a esse cliente sem abrir um segundo projeto de engenharia.

Quando oferecer a API oficial do WhatsApp ao seu cliente

A decisão fica mais fácil quando o time comercial sabe exatamente o que a oficial entrega a mais e o que ela cobra em troca. Ela faz sentido quando o cliente pede uma destas coisas:

  • Exigência formal. Contrato, área jurídica ou política interna que pede a Cloud API da Meta. É o caso mais comum em contas grandes.
  • Volume alto de notificações iniciadas pela empresa. Lembretes, confirmações, cobranças e avisos de entrega enviados por template aprovado, com a categoria definida na criação.
  • Manter o app WhatsApp Business no mesmo número. A coexistência liga a API e o app no mesmo número, com o histórico importado.
  • Outra plataforma já conectada no número. A Meta permite mais de um parceiro na mesma conta, e a D-API sabe dividir as conversas com eles. Veja API oficial com mais de um parceiro.

Para o restante da carteira, a não oficial continua sendo a escolha natural: conecta o número que o cliente já usa, envia texto livre a qualquer momento e inclui ligações de WhatsApp sem custo extra. Ter as duas no mesmo produto deixa o seu SaaS pronto para os dois perfis.

O que o cliente quer Modalidade indicada
Começar hoje, com o número que já está no cartão de visita Não oficial
Conversar e vender sem custo por mensagem Não oficial
Fazer e receber ligações de WhatsApp pelo seu produto Não oficial
Cumprir exigência contratual de Cloud API Oficial
Disparar notificações em volume com template aprovado Oficial
Usar API e app WhatsApp Business no mesmo número Oficial, por coexistência

A mesma integração para as duas APIs

O custo real de oferecer duas modalidades está no código duplicado. Na D-API ele não aparece, porque o contrato de envio e de webhook é o mesmo.

Onboarding pelo Embedded Signup hospedado

O cliente conecta o número oficial pelo Embedded Signup, que roda numa página hospedada pela D-API e abre como popup a partir do seu frontend. A Meta exige domínio cadastrado para esse fluxo, e quem está cadastrado é o domínio da D-API, então o seu não precisa passar por isso. O frontend usa uma publishable key, que só inicia o onboarding e pode ficar no navegador:

import { DApiConnect } from "d-api-sdk/connect";

const connect = new DApiConnect({ publishableKey: "pk_live_…" });

const { connectionId } = await connect.start({
  webhookUrl: "https://seu-saas.com/hooks/dapi",
  webhookMode: "normalized",
  metadata: { tenantId: "clinica-sp-17" },
});

O metadata volta intacto no webhook session.created, o que permite ligar a conexão ao tenant mesmo quando o retorno do popup não chega, como acontece em navegador de celular.

Envio pela rota de sempre

A partir daí, o connectionId é o sessionId nas rotas normais de envio. O mesmo código que manda texto para uma conexão não oficial manda para a oficial:

curl -X POST https://api.d-api.cloud/api/v1/messages/send/text \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "CONNECTION_ID",
    "to": "5511999999999",
    "text": "Sua consulta de amanhã está confirmada."
  }'

A diferença de regra está nas mensagens iniciadas pela empresa fora da janela de 24 horas: a Meta exige template aprovado, enviado por POST /api/v1/messages/send/template. Essa rota só aceita conexões oficiais. Em conexão não oficial ela responde 400 com code: "NOT_CLOUD_API", então vale concentrar a escolha entre texto e template num único ponto do seu serviço de envio.

Webhook no mesmo formato

Com webhookMode: "normalized", o padrão, os eventos da conexão oficial chegam no formato canônico da D-API, o mesmo de uma conexão não oficial. Um único handler, apontado para todas as conexões, distribui pelo sessionId que vem em cada evento. Se o seu time já tem um parser do webhook da Meta, a conexão aceita meta_passthrough e repassa o corpo cru, sem tradução. O modo pode ser trocado depois, sem refazer o onboarding.

O artigo API oficial e não oficial na mesma integração detalha o modelo de dados do tenant e o handler de webhook.

Quanto custa oferecer a API oficial

A conta do seu SaaS não muda com a modalidade. A D-API cobra por conexão ativa, e a conexão oficial custa o mesmo que a não oficial, com preço por conexão que cai com o volume. A tabela está em /#preco.

O que existe só na oficial é a tarifa de mensagem da Meta, cobrada pela própria Meta na WABA do seu cliente, no método de pagamento que ele cadastra durante o Embedded Signup. A D-API não intercepta essa cobrança nem coloca margem sobre ela. Para referência, a Meta cobra no Brasil R$ 0,3217 por mensagem de marketing entregue e R$ 0,0350 por mensagem de utilidade (fonte: Meta, tabela vigente em 1º de outubro de 2026). Os valores mudam com o tempo, e o artigo quanto custa a API oficial do WhatsApp traz a tabela completa e três formas de lidar com esse custo no seu plano.

Esse arranjo tira do seu SaaS o risco de inadimplência sobre um custo variável. O cliente sabe que a fatura da Meta chega para ele, e o seu plano cobra a mesma coisa pela conexão nos dois casos.

O que o seu cliente mantém sob controle

Cliente grande pergunta quem é dono do número antes de assinar. Na D-API a resposta cabe numa linha do seu material comercial: o número fica no Business Portfolio e na WABA do próprio cliente, e a D-API entra só como app parceiro assinado na conta. O método de pagamento da Meta também é dele, assim como o histórico de cobrança das mensagens.

Para o seu SaaS, isso simplifica o questionário de fornecedor que contas corporativas costumam mandar. A relação contratual com a Meta é do cliente, a relação de plataforma é com você, e a D-API fica por baixo como infraestrutura, sem aparecer na fatura de mensagens.

Recursos da API oficial na D-API

Além de envio e webhook, a camada oficial da D-API cobre o que o seu painel precisa para operar a conta do cliente:

  • Templates por API. Listar aprovados, listar todos com status de revisão, criar e excluir pela rota /api/v1/connections/cloud-api/{id}/templates. O guia de templates da API oficial mostra os campos e o envio com variáveis, mídia e botões.
  • Conexão manual. Para quem já tem WABA, número e token gerados no Meta Business Manager, existe a rota de cadastro manual. Ela e as rotas de detalhe da conexão estão em WhatsApp Cloud API.
  • Access token da Meta. Recuperável pelo seu backend, já descriptografado e classificado por tipo, para quem precisa chamar a Graph API por fora.
  • Saúde da conta. A rota de detalhe traz qualidade e tier de mensagens sincronizados da Meta, prontos para exibir no seu painel.
  • Vários parceiros no número. Consulta de roteamento e troca de dono da conversa com take, pass e release.

Como estruturar a oferta no seu SaaS

A forma mais limpa é tratar a modalidade como um atributo da conexão do tenant. O time comercial decide com o cliente, o onboarding grava o sessionId e o tipo, e o resto do produto segue igual.

Um roteiro que funciona:

  1. Deixe a não oficial como padrão do cadastro, com QR code ou código de pareamento.
  2. Ofereça a oficial como opção para o cliente que pedir, com um botão que abre o popup do DApiConnect.
  3. Mostre, antes da conexão, que a tarifa de mensagem da Meta será cobrada na conta Meta dele.
  4. Escreva um único serviço de envio que decide entre texto e template pela modalidade e pela janela.
  5. Aponte todas as conexões para o mesmo endpoint de webhook com webhookMode: "normalized".

Com isso, migrar um cliente da não oficial para a oficial vira uma operação de cadastro: ele conecta pelo Embedded Signup, o session.created chega com o tenantId no metadata e o seu backend troca o sessionId ativo do tenant.

Limites que valem para o número oficial

Alguns números ajudam o seu time a dimensionar a operação. A D-API não impõe limite próprio de envio nas conexões oficiais. Vale o limite da Meta, de cerca de 80 mensagens por segundo por número (20 por segundo em coexistência), além do limite diário definido pelo tier do número. A publishable key, usada só no onboarding, tem limite de 30 requisições por minuto.

O número começa com limites de envio menores enquanto o Business Portfolio do cliente não passa pela verificação da Meta. Dá para conectar antes da verificação. Ainda assim, vale incluir esse passo no checklist de onboarding de clientes que vão disparar em volume.

Por onde começar

Comece pela parte que não muda: um campo de tipo na conexão do tenant e o sessionId como chave de tudo. Depois implemente o popup do Embedded Signup, um handler de webhook normalizado e o envio de template para quando a janela estiver fechada. Os parâmetros completos do fluxo de provedor estão na documentação da D-API.

Time D-API. Atualizado em .

api oficial

Tudo sobre api oficial na D-API

Perguntas frequentes

Meu SaaS precisa virar Tech Provider da Meta para oferecer a API oficial do WhatsApp?

Não. O Embedded Signup roda no app Meta da D-API, que é Tech Provider. Basta ter conta na D-API. Quem conecta o número precisa de uma conta do Facebook e de um Business Portfolio, que pode ser criado dentro do próprio popup.

Qual nome o meu cliente vê na janela da Meta durante a conexão?

D-API. Hoje o fluxo usa o app Meta da D-API, sem suporte a app próprio ou a Solution ID do parceiro.

Se o cliente quiser sair da D-API, ele perde o número?

Não. Número, WABA, nome de exibição e templates continuam no portfólio do cliente. Para trocar de provedor, ele remove o app da D-API da WABA e conecta o novo, sem custo.

Quanto tempo leva para um número oficial começar a enviar?

A ativação é imediata ao concluir o Embedded Signup, salvo alguma verificação pendente do lado da Meta.

A conexão oficial passa pela mesma infraestrutura da não oficial?

Não. A conexão oficial nunca passa pela infraestrutura da API não oficial. Se a sua conta só tiver conexões oficiais, nenhum número usa esse canal.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.