LinkedIn
Participe da comunidade do Slack Índice
Noções básicas
Categorias e velocidade
Construir e avaliar
Solução e Perguntas Frequentes
API do WhatsApp
API do WhatsApp ProvedoresAPI de Nuvem, BSP ou Conta Conectada
A API On-Premises do WhatsApp da Meta parou de entregar mensagens em 23 de outubro de 2025. Os únicos caminhos restantes em 2026 são a API de Nuvem da Meta diretamente, um Provedor de Soluções de Negócios revendendo-a, ou uma API de conta conectada que autentica um número do WhatsApp existente. Este guia compara o tempo de configuração, verificação da Meta, custo e limites entre os três, para desenvolvedores que integram o WhatsApp em seu próprio produto.
Construir com Unipile Consulte a documentação da API do WhatsApp
#: vincular uma conta existente do WhatsAppcurl -X POST "https://.unipile.com:/api/v1/accounts"" -H "X-API-KEY: " -F provedor=WHATSAPP
// resposta: escanear ou parear, sem a etapa do Meta Business
{
"objeto": "Ponto de controle",
"qrCodeString": "2@AbC..."),
"id_da_conta": "ACo_9F21"
}Conectado em menos de um minuto, sem verificação do Meta Business
Definição
O que é um provedor da API do WhatsApp?
Um provedor de API do WhatsApp é qualquer parte que dê ao seu software acesso programático ao envio de mensagens do WhatsApp. Em 2026, isso significa uma de três categorias: a própria Meta por meio da Cloud API, um Provedor de Soluções de Negócios (BSP) aprovado pela Meta que revende essa mesma Cloud API, ou uma API de conta conectada que autentica um número do WhatsApp já ativo em nome de seu proprietário.
Em sumaA Provedor da API do WhatsApp quem estiver entre o seu produto e o WhatsApp: a própria API Cloud da Meta, um BSP revendendo-a, ou uma API de conta conectada que vincula um número existente em vez de criar uma nova identidade comercial.
As três categorias não são intercambiáveis, e confundi-las é uma causa comum de paralisações em integrações do WhatsApp. A Cloud API da Meta coloca um número de telefone comercial sob uma Conta do WhatsApp Business (WABA) pertencente à empresa, com a Meta cobrando por mensagem diretamente. Um BSP revende essa mesma Cloud API, adicionando suporte de integração, ferramentas e sua própria margem ou assinatura por cima. Uma API de conta conectada ignora completamente o caminho da WABA: ela autentica um número do WhatsApp que já está ativo, da mesma forma que o WhatsApp Web faz, sem criar uma nova identidade comercial na plataforma da Meta.
Para uma equipe de marketing que compra uma ferramenta de WhatsApp, a diferença geralmente aparece como uma linha em uma fatia. Para um desenvolvedor que lança o WhatsApp como um recurso dentro de um produto SaaS, isso muda qual fluxo de integração um cliente precisa concluir antes que a primeira mensagem seja enviada, que é a pergunta que o resto deste guia responde para cada um dos três tipos de provedores da API do WhatsApp. Algumas equipes procuram um Provedor de API de conversas do WhatsApp em vez disso: são as mesmas três categorias com um nome diferente, já que toda integração do WhatsApp é, no fundo, uma forma de enviar e receber conversas.
O cenário de 2026
Quais são as três formas de acessar a API do WhatsApp em 2026?
Como a Meta descontinuou a API On-Premises, apenas três caminhos de acesso permanecem: a API Cloud da Meta diretamente, um BSP revendendo a API Cloud ou uma API de conta conectada. A escolha não é mais entre hospedagem em nuvem e local (on-premise), mas sim sobre quem possui a Conta do WhatsApp Business e quão rápido uma primeira mensagem pode ser enviada.
Por que "Cloud API vs Business API" é a pergunta errada agora
9 de jan. de 2024 Novos recursos do WhatsApp são lançados apenas na Cloud API. O cliente On-Premises recebe correções de bugs, nada mais.
1 de jul. de 2024 Novos números de telefone comerciais só podem ser registrados na Cloud API.
23 de out. de 2025 A última versão On-Premises (v2.63) expira. As mensagens para números que ainda estão nela não são mais entregues.
Origem: Meta, descontinuação da API On-Premises do WhatsApp, consultado em 6 de agosto de 2026.
Critério
API Cloud direta
BSP
Conta conectada
Quem é o proprietário da WABA
Você
O BSP, na maioria dos casos
Sem WABA
Verificação da Meta for Business
Obrigatório
Obrigatório, tratado pelo BSP
Não é necessário
Tempo para a primeira mensagem
Dias a semanas
Horas para dias
Minutos
Modelos de mensagens
Necessário fora da janela de atendimento
Obrigatório
Não se aplica
Faturamento
Meta, por mensagem
Pass-through da Meta, mais margem ou assinatura
Preço do fornecedor
Mensagens de grupo
Apenas Conta Comercial Oficial, limite de 8 participantes
O mesmo requisito do Meta passa
Nativo, sem tampa separada
Histórico de entrada
Apenas webhook, da conexão
Somente webhook
Conversas existentes acessíveis
Melhor para
Equipes que precisam de uma identidade de marca oficial
Equipes que querem o processo de integração resolvido
Produtos que incorporam a própria conta do usuário
As mensagens em grupo funcionam de maneira diferente em todos os três caminhos, e o limite de participantes atrapalha mais integrações do que qualquer outra linha nesta tabela. Veja a análise completa em Mensagens em grupo do WhatsApp.
Construir o caminho da conta conectada Camada opcional
Você precisa de um BSP para usar a API do WhatsApp?
Não. Desde que a Cloud API ficou geralmente disponível em 2022, uma empresa pode integrar-se diretamente com a Meta sem passar por um Provedor de Soluções de Negócios (BSP). Um BSP é opcional e oferece suporte de integração, ferramentas e geralmente uma margem sobre o preço por mensagem da Meta.
Ir direto significa lidar com o próprio console de desenvolvedor da Meta, configuração do WABA e verificação de negócios sem um fluxo guiado, o que é adequado para uma equipe com tempo de engenharia para construir seu próprio gerenciamento de modelos e tratamento de webhooks. Um BSP existe para remover esse atrito: ele pré-preenche grande parte da burocracia de verificação, fornece um painel sobre a API bruta e geralmente inclui suporte. Um BSP aprovado pela Meta às vezes é chamado de provedor oficial da API do WhatsApp, uma vez que ele opera dentro do próprio programa Business Solution Provider da Meta, em vez de revender o acesso informalmente. Nada disso altera a API de Nuvem subjacente, sua cobrança por mensagem ou o requisito de verificação da Meta: um BSP gerencia o processo, ele não o substitui.
O que um BSP normalmente adiciona
Integração guiada para a criação do WABA e verificação do negócio
Um painel além dos endpoints brutos da Cloud API
Gerenciamento de modelos ferramentas e controle de aprovação
Suporte e gerenciamento de contas, cobrado como uma assinatura ou uma margem sobre o preço da Meta
O que permanece o mesmo em ambos os casos: a WABA, os preços por mensagem da Meta subjacentes e a verificação comercial do número.
A categoria que importa
O que é uma API do WhatsApp de terceiros e quais são seguras para construir?
Uma API de terceiros do WhatsApp abrange duas coisas muito diferentes. Os BSPs aprovados pela Meta e as APIs de contas conectadas operam dentro dos termos de serviço do WhatsApp. Bibliotecas de engenharia reversa que emulam o cliente do WhatsApp não fazem isso, e colocam o número de telefone subjacente em risco de ser bloqueado. Uma busca por API não oficial do WhatsApp geralmente significa uma dessas três categorias, raramente todas de uma vez.
Em conformidade
BSP aprovado pela Meta
Revende a API oficial do Cloud sob o programa Business Solution Provider da Meta. Uma WABA e a verificação do Meta Business ainda são necessárias, o BSP apenas gerencia o processo e adiciona uma camada de ferramentas por cima.
Em conformidade
API de contas conectadas
Autentica uma conta do WhatsApp existente por meio de um código QR ou de um código de emparelhamento, em nome do usuário autenticado. No WABA, sem verificação do Meta Business. Esta é a categoria em que o Unipile opera. Buscas por uma "API não oficial do WhatsApp" geralmente significam esta categoria, embora ela autentique o mesmo cliente que o WhatsApp Web usa, em vez de burlar os próprios sistemas do WhatsApp.
Alto risco
Bibliotecas de engenharia reversa
Projetos de código aberto que reimplementam o protocolo do WhatsApp sem qualquer envolvimento da Meta ou do WhatsApp. Frequentemente quebrados por atualizações de clientes, sem manutenção e em violação dos Termos de Serviço do WhatsApp, o que coloca o número conectado em risco de ser bloqueado. Não há links para eles neste guia.
Para um desenvolvedor que precisa decidir onde construir, o teste prático para qualquer API de terceiros do WhatsApp é simples: o provedor se autentica por meio do comportamento do próprio cliente do WhatsApp (código QR, código de pareamento, API de Nuvem da Meta), ou ele reimplementa o protocolo do WhatsApp de forma independente? As duas primeiras categorias respondem que sim e permanecem dentro dos termos do WhatsApp. A terceira não, e nenhuma quantidade de paridade de recursos compensa um número que pode ser bloqueado sem aviso prévio.
Construa sua integração de conta conectada Comparação de velocidade
Quanto tempo cada tipo de provedor leva para enviar uma primeira mensagem?
A integração direta com a API do Cloud leva de dias a semanas porque a verificação do Meta Business é executada em paralelo com a configuração da WABA. Um BSP reduz isso para horas ou dias ao pré-preencher grande parte da burocracia. Uma API de conta conectada atinge uma primeira mensagem em minutos, porque não há WABA para criar nem verificação para passar.
Dias-semanas
API Cloud direta
Horas-dias
BSP
Minutos
Conta conectada
A lacuna vem inteiramente do que precisa acontecer antes da primeira mensagem, e não de qualquer limite técnico. Para ver a lista de verificação completa que a Meta exige antes que um número da Cloud API possa enviar qualquer coisa, consulte Requisitos de acesso à API do WhatsApp.
Preços
Quanto custa a API do WhatsApp com cada tipo de provedor?
A Meta cobra por mensagem desde 1º de julho de 2025, com preços definidos pela categoria do modelo: marketing, utilidade ou autenticação. A janela de atendimento ao cliente de 24 horas ainda existe, mas agora ela determina quais mensagens são gratuitas em vez do que é cobrado. Um BSP adiciona uma assinatura ou uma margem sobre esse preço por mensagem.
Ambos os caminhos da API Cloud, direto e através de um BSP, estão na mesma tabela de preços da Meta abaixo: um BSP não pode fazer o custo por mensagem da Meta desaparecer, ele só pode adicionar sua própria taxa de integração e ferramentas, ou absorver parte dela em uma assinatura fixa. Uma API de conta conectada funciona com um modelo totalmente diferente. Não há WABA e nenhum requisito de template, então não há nada para a Meta cobrar por mensagem: a precificação vem do próprio provedor, tipicamente uma assinatura fixa em vez de uma cobrança por mensagem.
Origem: Preços da plataforma do WhatsApp Business da Meta, consultado em 6 de agosto de 2026.
Para obter o detalhamento completo das categorias de modelos, janelas gratuitas e tabela de preços da Meta, consulte Preços da API do WhatsApp Business.
Esforço de integração
Qual provedor da API do WhatsApp é mais fácil de integrar?
O esforço de integração é impulsionado por quatro fatores: o modelo de autenticação, se os webhooks funcionam sem configuração extra, se existe um ambiente de teste (sandbox) e quantos canais a mesma API cobre. Dos três caminhos, uma API de conta conectada é o provedor de API do WhatsApp mais fácil de integrar para mensagens e verificação, porque a autenticação é um código QR ou código de pareamento, em vez de um processo de verificação da Meta.
1Enviar a primeira mensagem
#: inicie um bate-papo e envie mensagens de texto em uma única ligaçãocurl -X POST "https://.unipile.com:/api/v1/chats"" -H "X-API-KEY: " -F conta_id=<ACCOUNT_ID> -F attendees_ids=<ATTENDEE_ID> -F A tradução para o português do Brasil seria:
"texto=""Olá, esta é a minha primeira mensagem"
// 201 Criado
{
"objeto": "Chat Iniciado",
"chat_id": "cWh_18a2",
"message_id": "mWh_77e0"
}2Receber como webhook
// POST para a URL do seu webhook cadastrado
{
"evento": "mensagem_recebida",
"id_da_conta": "ACo_9F21",
"tipo_de_conta": "WHATSAPP",
"chat_id": "cWh_18a2",
"message_id": "mWh_77e2",
"carimbo de data/hora": "2026-08-06T10:32:04Z",
"mensagem": "A caminho, 10 minutos",
"remetente": { "nome": "..." }
}Ambas as chamadas são executadas na mesma conta assim que ela é vinculada: nenhuma etapa separada de inscrição de webhook, nenhum modelo para enviar para aprovação, nenhum número de sandbox do qual sair. Onde uma integração direta com a Cloud API significa registrar um aplicativo de desenvolvedor da Meta, criar uma WABA, enviar para verificação comercial e criar um ouvinte de webhook antes que a primeira mensagem de modelo possa ser enviada, uma integração de conta conectada consiste em duas chamadas: autenticar a conta e, em seguida, enviar.
Referência completa de requisição e resposta: enviar mensagens do WhatsApp via API e o Documentação da API do WhatsApp.
Comece a construir em minutos Critérios de avaliação
Como você avalia um provedor da API do WhatsApp como desenvolvedor?
Avalie um provedor de API do WhatsApp com base em sete critérios: modelo de autenticação, requisitos de verificação, tempo para a primeira mensagem, confiabilidade do webhook, cobertura de tipos de mensagem, transparência de cobrança e se a mesma API também cobre seus outros canais.
Não existe um único melhor provedor de API do WhatsApp para todos os produtos. Se ele é chamado de provedor de API do WhatsApp ou de provedor de mensagens do WhatsApp depende de quem está perguntando, e não do que ele faz, e os sete critérios abaixo se aplicam em ambos os casos. A maioria das listas dos melhores provedores de API do WhatsApp classifica ferramentas para uma equipe de marketing que está escolhendo um chatbot, e não uma API para um desenvolvedor construir em cima, o que explica por que elas raramente ajudam neste caso.
1
Modelo de autenticação
Código QR, código de pareamento ou um fluxo completo de verificação do Meta Business antes que qualquer coisa possa ser testada.
2
Requisitos de verificação
Se uma WABA e a verificação do Meta Business são obrigatórias antes da primeira mensagem, ou se não são necessárias.
3
Tempo para a primeira mensagem
Minutos, horas ou semanas, testados de ponta a ponta em vez de medidos a partir da "permissão de acesso à API".
4
Confiabilidade do webhook
Entrega em tempo real para mensagens recebidas e alterações de status, sem a necessidade de uma etapa de assinatura separada para configurar primeiro.
5
Cobertura de tipos de mensagem
Texto, mídia, modelos, notas de voz e grupos, se o produto precisar deles.
6
Transparência na cobrança
Por mensagem, assinatura fixa ou uma margem sobre o próprio preço da Meta, divulgada antecipadamente em vez de descoberta na primeira fatura.
7
Cobertura multicanal
Se a mesma conta e API também lidam com LinkedIn, Instagram, Telegram ou e-mail, portanto, o WhatsApp não é uma integração única para manter sozinha.
Conta conectada
Você pode conectar uma conta existente do WhatsApp em vez de criar uma WABA?
Sim. Uma API de conta conectada autentica uma conta do WhatsApp existente por meio de um código QR ou de um código de emparelhamento, em nome do usuário autenticado. Nenhuma conta do WhatsApp Business é criada e nenhuma verificação do Meta Business é necessária.
É assim API do WhatsApp da Unipile funciona: atua como um intermediário técnico independente entre um produto e o WhatsApp, e cada chamada é executada em nome do titular da conta que autorizou a conexão, e não como uma integração comercial permanente com a Meta. Uma vez vinculados, chats e grupos existentes tornam-se acessíveis por meio da mesma API de mensagens unificada usada para LinkedIn, Instagram, Telegram e e-mail, de modo que o WhatsApp não precisa de um caminho de integração separado do resto da interface de mensagens de um produto.
Manuseio de dados
Os dados recuperados por meio de uma conta do WhatsApp conectada não são armazenados em um sistema paralelo nem mantidos como um arquivo independente. O acesso permanece restrito à sessão do usuário autenticado que vinculou a conta.
Limites da plataforma
A Unipile repassa os próprios limites de taxa nativos do WhatsApp, em vez de impor um separado. A frequência com que a conta envia mensagens continua sendo uma decisão do cliente, tomada dentro dos limites do próprio WhatsApp para aquele número.
Este é um caminho diferente de um número da Cloud API: veja usando a API do WhatsApp com uma conta existente pela forma como o guia do pilar enquadra ambas as opções lado a lado.
Construa com Unipile Por caso de uso
Qual provedor da API do WhatsApp se adapta ao seu caso de uso?
Se o WhatsApp é um canal entre vários, uma única API cobrindo WhatsApp, LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP elimina a necessidade de manter uma integração por provedor.
CRM e ferramentas de vendas
Registre conversas do WhatsApp ao lado de mensagens do LinkedIn e threads de e-mail na mesma linha do tempo do contato, em vez de um silo exclusivo do WhatsApp anexado ao CRM.
Helpdesk e suporte
Encaminhe conversas do WhatsApp, Instagram e Telegram para uma caixa de entrada compartilhada, com o mesmo modelo de ticket e resposta nos três canais.
Agentes de IA
Forneça a um agente uma única API para ler e responder em todos os canais, em vez de um SDK separado por provedor, desde o WhatsApp até caixas de correio IMAP.
ATS e recrutamento
Alcance candidatos pelo WhatsApp ou LinkedIn e, em seguida, sincronize as entrevistas confirmadas diretamente para o Google Agenda ou Outlook Calendar.
Provedores da API do WhatsApp, perguntas frequentes
Verificação da Meta, preços, mensagens em grupo e onde o Unipile se encaixa entre os caminhos da API Cloud, BSP e contas conectadas.
Não, não para uso comercial. A Meta cobrou pela API Cloud por mensagem desde 1 de julho de 2025, por categoria de modelo: marketing, utilidade ou autenticação. As mensagens enviadas dentro da janela de atendimento ao cliente de 24 horas são gratuitas, assim como as janelas de Ponto de Entrada Gratuito abertas a partir de anúncios ou botões de página. Uma API de conta conectada é cobrada separadamente pelo provedor, normalmente como uma assinatura fixa em vez de uma taxa por mensagem da Meta.
Apenas para o caminho da API do Cloud, direto ou por meio de um BSP: ambos exigem uma conta do WhatsApp Business e verificação do Meta Business antes da primeira mensagem. Uma API de conta conectada é diferente, ela autentica uma conta do WhatsApp existente em nome do usuário autenticado através de um QR code ou código de pareamento, sem nenhuma verificação do Meta Business.
Sim, de duas formas. Uma empresa pode integrar-se diretamente com a API em Nuvem da Meta, sem um Provedor de Soluções de Negócios (BSP), desde que ela se tornou amplamente disponível em 2022. Uma API de conta conectada ignora tanto o BSP quanto a WABA completamente, autenticando um número de WhatsApp existente.
A Meta descontinuou o recurso. Novos recursos pararam de ser lançados para ele em 9 de janeiro de 2024, novos números de telefone comerciais não podiam mais se registrar nele a partir de 1º de julho de 2024, e a versão final, v2.63, expirou em 23 de outubro de 2025mensagens trocadas com um número que ainda o utiliza não são mais entregues. A própria documentação da Meta recomenda a migração para a Cloud API. Fonte: Meta, descontinuação da API On-Premises do WhatsApp.
Depende do caminho. A API de Grupos da Cloud API requer uma Conta Comercial Oficial e grupos de limite em 8 participantes, sem um endpoint para adicionar um participante diretamente. Uma conta conectada segue as mecânicas de grupo nativas do WhatsApp, sem um limite separado de participantes.
Não. O Unipile é um intermediário técnico independente que conecta uma conta do WhatsApp existente em nome do usuário autenticado, por meio de código QR ou código de pareamento. O Unipile é não afiliado, endossado ou patrocinado por Meta ou WhatsApp.
Ainda tem dúvidas? Nossa equipe está aqui para ajudar.
Comece a construir
Construa com o provedor da API do WhatsApp que melhor se adapta ao seu produto
Vincule uma conta existente do WhatsApp por código QR ou código de pareamento, em nome do usuário autenticado, e envie a primeira mensagem através da mesma API que abrange LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP.
Construir com Unipile Leia a documentação da API do WhatsApp
BR 
EN 
FR 
ES 
DE 
IT 
NL 
PL 
TR