API do WhatsApp 2026: Tipos, Acesso, Preços e Limites

Comissão Europeia
Regulamentado pela UE Lei dos Mercados Digitais (DMA)
Nossa solução se concentra exclusivamente na interoperabilidade de mensagens, sem armazenamento de perfil, sem raspagem. Espera-se que os clientes cumpram os termos de cada provedor. Saiba mais
Guia da API do WhatsApp 2026

API do WhatsApp: Tipos, Acesso, Preços e Limites

Tudo o que a Plataforma oficial do WhatsApp Business exige e as partes que ela não cobre: como conectar uma conta do WhatsApp para uso pessoal ou um Aplicativo Comercial existente, por código QR ou código de pareamento, sem verificação do Meta Business.
Teste gratuito de 7 dias, sem necessidade de cartão de crédito
Conta vinculada
QR code, sem configuração da Meta
connect-whatsapp.js
Vincular uma conta do WhatsApp existente
const conta = await cliente.conta.conectarWhatsapp();

// account.qrCodeString -> mostrar para o usuário
// ou passe um pairing_phone_number em vez disso

const bate-papos = await cliente.chats.list({
  account_type: 'WHATSAPP'
});
Conectado, em nome do usuário autenticado
Definição

O que é a API do WhatsApp?

O API do WhatsApp não é um único produto. É um termo guarda-chuva para três maneiras diferentes de enviar e receber mensagens do WhatsApp a partir de um software: a Plataforma oficial do WhatsApp Business da Meta, um Provedor de Soluções de Negócios revendendo acesso a ela e uma API de mensagens unificada que conecta uma conta do WhatsApp que o usuário já possui.
Todos os três operam em última análise na rede do próprio WhatsApp, a Meta é dona do protocolo, portanto nenhuma opção opera fora da infraestrutura da Meta. O que difere drasticamente entre eles é o modelo de acessoseja configurando um número de empresa totalmente novo de acordo com as regras da Meta, ou conectando uma conta já existente.
NomeO que éQuem o operaRequisitos de acesso
Plataforma do WhatsApp Business (API de Nuvem)API oficial da própria Meta para provisionar novos números de telefone comerciais e enviar mensagens de modelo em escalaMetaAplicativo de desenvolvedor da Meta, WABA, número de telefone comercial, verificação para níveis superiores
Acesso de Provedor de Soluções de Negócios (BSP)Um terceiro (Twilio, 360dialog e similares) revendendo a mesma API Cloud, integrada ao seu próprio painel e faturamentoInfraestrutura da Meta, gerenciada por BSPMesmos requisitos subjacentes da Meta, provisionados por meio do BSP
API de sessão unificada (Unipile)Conecta uma conta do WhatsApp, comercial ou pessoal, da mesma forma que o WhatsApp Web faz, por código QR ou código de pareamentoUnipile, em nome do usuário autenticadoSem verificação no Meta Business, sem novo número, sem aprovação de modelo
O resto deste guia cobre todos os três, com foco específico na terceira opção, já que é a que a maioria dos guias existentes da API do WhatsApp simplesmente ignora.
Orientação

Quais são os diferentes tipos de API do WhatsApp?

Existem quatro maneiras práticas de acessar o WhatsApp programaticamente hoje: o API de nuvem (superfície oficial atual da Meta), o descontinuado API On-Premise, o Aplicativo WhatsApp Business, e um API de sessão de terceiros que conecta uma conta que um usuário já tem.
TipoProvisionamentoMelhor paraFunciona com uma conta existente
API de nuvemNovo número de telefone comercial + Verificação do Meta Business para maior volumeEmpresas que enviam marketing ou notificações em alto volume em escalaNão, requer um novo número
API On-PremiseDescontinuado. A Meta o desativou e incentivou a migração para a Cloud APIApenas integrações legadasNão
Aplicativo WhatsApp BusinessAplicativo gratuito para o consumidor, configuração manual em um dispositivoPequenas empresas gerenciando conversas manualmenteSim, mas manualmente, um dispositivo por vez, não programaticamente
API de sessão unificada (Unipile)Vincula a conta do mesmo jeito que o WhatsApp Web, sem número novoPlataformas SaaS incorporando a conta de WhatsApp de cada próprio usuário no produtoSim, este é o caso de uso principal
As duas primeiras linhas são a infraestrutura da própria Meta, construída em torno do provisionamento de um novo número comercial. A terceira é um aplicativo manual, operado por humanos, sem API real. A quarta é onde fica uma API unificada como a Unipile: ela não concorre com a Cloud API, ela resolve um problema diferente, permitindo que seus próprios usuários conectem a conta do WhatsApp que eles já carregam no bolso.
A Meta também introduziu uma coexistência limitada entre o aplicativo WhatsApp Business e a Cloud API no mesmo número, para que uma empresa possa manter o aplicativo para conversas manuais enquanto um subconjunto de tráfego é executado por meio da Cloud API. Isso ainda é um número pertencente à empresa mudando a forma como é operado, não é a mesma coisa que um terceiro conectando uma conta que um usuário individual diferente já possui. O tipo que importa para este guia é o quarto: é a única opção construída em torno da conta, e não do número. Para uma análise mais profunda sobre como executar o tipo Cloud API dentro de um produto multilocatário (multi-tenant), consulte nosso Integração com a API do WhatsApp Cloud guia.

Ecossistema da API do WhatsApp

A Meta oferece duas APIs oficiais que permitem às empresas integrar o WhatsApp em seus softwares. Ambas são projetadas para viabilizar mensagens de alto volume, com recursos como mensagens pré-aprovadas, compartilhamento de mídia e ferramentas de suporte ao cliente.

Auto-hospedado

API do WhatsApp Business

A Business API foi a primeira solução lançada pela Meta para ajudar as empresas a interagir com seus clientes no WhatsApp. Normalmente, ela é auto-hospedada ou gerenciada por um provedor aprovado, dando às empresas mais controle sobre a infraestrutura. Ela é compatível com modelos de mensagens de saída, respostas de clientes e formatos de mídia avançada, o que a torna adequada para empresas que precisam integrar o WhatsApp diretamente ao seu CRM, contact center ou sistema de suporte.

Melhor para empresas integrando o WhatsApp em seu próprio CRM, central de atendimento ou sistema de suporte.
Meta Cloud

WhatsApp Cloud API

Lançada posteriormente, a API em nuvem é totalmente hospedada pela Meta. Ela elimina a necessidade de as empresas gerenciarem servidores ou lidarem com infraestrutura pesada. A API em nuvem oferece funcionalidades básicas semelhantes, como envio e recebimento de mensagens, gerenciamento de modelos e suporte a mídia, além de ser mais fácil de implantar para os desenvolvedores. Ela é posicionada como uma maneira mais rápida de acessar o WhatsApp programaticamente, especialmente para empresas que desejam escalabilidade sem a sobrecarga da hospedagem local.

Melhor para equipes que desejam implantações mais rápidas sem gerenciar servidores ou hospedagem local.

A complexidade da integração do WhatsApp

Embora as APIs de Negócios e de Nuvem da Meta ofereçam recursos poderosos, sua integração está longe de ser simples. Os desenvolvedores precisam gerenciar a verificação de negócios, aprovações de modelos e cotas de mensagens antes mesmo de entrarem no ar. O hospedagem ou a conexão com a API de Nuvem também exige o manuseio de webhooks, criptografia e conformidade com regras rigorosas de opt-in. Esses obstáculos frequentemente atrasam projetos e limitam o acesso de provedores de SaaS menores que desejam adicionar o WhatsApp rapidamente às suas plataformas.

Verificação de negócios Aprovações de modelo Cotas de mensagens Tratamento de Webhook Criptografia Regras de opt-in rigorosas
Viabilidade

Você pode integrar o WhatsApp ao seu próprio software?

Sim. Qualquer produto de software pode integrar mensagens do WhatsApp. Há três maneiras distintas de fazer isso, e a correta depende de você estar enviando a partir de um novo número comercial ou de uma conta que seu usuário já possui.
1Construa diretamente na API de Nuvem da Meta. Você provisiona um número de telefone comercial, registra um aplicativo de desenvolvedor da Meta e se integra aos próprios endpoints da Meta.
2Contrate por meio de um Provedor de Soluções de Negócios. Um BSP fornece o número e a Conta do WhatsApp Business para você e adiciona seu próprio painel ou API por cima.
3Conecte contas existentes por meio de uma API unificada. Cada um dos seus usuários vincula a conta do WhatsApp que ele já possui, sem nenhum número novo, sem verificação do Meta Business, em nome desse usuário autenticado.
As próximas seções detalham como obter acesso para cada caminho, passo a passo.
Pré-requisitos

O que você precisa antes de poder usar a API do WhatsApp Cloud?

A API da Nuvem da Meta exige uma conta de desenvolvedor da Meta, uma conta do WhatsApp Business (WABA), um número de telefone comercial dedicado que nunca tenha estado ativo no WhatsApp comum e, após um determinado volume, uma conta comercial da Meta verificada.
Conta de desenvolvedor da Meta com um aplicativo que tenha o produto WhatsApp adicionado
Conta do WhatsApp Business (WABA) criado dentro daquele aplicativo
Um número de telefone não está ativo no momento no WhatsApp ou WhatsApp Business
Verificação de negócios no Gerenciamento de Negócios da Meta, necessário para desbloquear os níveis de mensagens acima de 250 destinatários únicos por 24 horas
Modelos de mensagens aprovados para qualquer conversa iniciada pela empresa fora do horário de atendimento de 24 horas
Nada disso se aplica se você conectar uma conta que o usuário já possui, em vez de provisionar um novo número, já que não há uma nova identidade comercial para a Meta verificar. Mais informações sobre isso na seção sobre contas pessoais e existentes abaixo.
Processo completo de verificação comercial passo a passo, documentos necessários e tempo típico de análise: Guia da API do WhatsApp sem verificação comercial (em breve no cluster).
Limites

Quais são os limites da API do WhatsApp?

A Meta impõe três limites distintos na Plataforma do WhatsApp Business: um limite máximo de largura de banda de 80 mensagens por segundo, um limite de chamadas por hora da API de 200 a 5.000 solicitações, e um nível de mensagens que limita o número de clientes únicos para os quais você pode enviar mensagens em um período móvel de 24 horas.
LimiteValorAnotações
Rendimento80 mensagens / segundoTaxa de envio em toda a plataforma
Limite de taxa da API200 a 5.000 requisições / horaEscala com o status e a qualidade da conta
Limite de taxa do par1 mensagem / 6 segundosPor destinatário, impede o envio de spam para o mesmo usuário
Nível de mensagens250 → 2.000 → 10.000 → 100.000 → ilimitadoDestinatários únicos por período contínuo de 24h, começa em 250 não verificados
A mudança para um nível superior de mensagens requer verificação da empresa ou um histórico sustentado de qualidade no envio. Uma vez elegível, a escala para o próximo nível pode ocorrer automaticamente se o uso permanecer alto e a qualidade se mantiver.
Nenhum desses níveis da API do Cloud se aplica a uma conexão baseada em sessão. A velocidade de envio é limitada pelo comportamento da própria conta do WhatsApp e a forma como a conta é usada continua sendo uma decisão do cliente.
Classificação de qualidade, estratégia de backoff e tratamento de 429 em detalhes: Guia de limites de taxa da API do WhatsApp (em breve no cluster).
O diferencial

Você pode usar a API do WhatsApp com uma conta existente do aplicativo WhatsApp Business?

Sim. Seja para uso pessoal ou para uma conta de aplicativo comercial, o Unipile conecta a conta do WhatsApp existente do próprio usuário autenticado da mesma forma que o WhatsApp Web: por código QR ou código de pareamento. Como essa conta já existe, nenhum dos pré-requisitos da API em Nuvem das seções acima se aplica.
Cada caminho descrito até agora neste guia, o acesso à Cloud API e ao BSP, pressupõe que você está provisionando um número de telefone comercial totalmente novo. Esse é o modelo correto para uma empresa que transmite campanhas de marketing ou notificações automatizadas a partir de um número compartilhado. É o modelo errado para uma plataforma SaaS, CRM ou ferramenta de caixa de entrada cujo objetivo real é permitir que cada um de seus próprios usuários traga a conta do WhatsApp que ele já possui, de uso comercial ou pessoal, da mesma forma que esse produto pode permitir que um usuário traga sua própria caixa de entrada do Gmail ou sua própria conta do LinkedIn.
Na prática, "API do WhatsApp para uso pessoal" é o que a maioria das pessoas que buscam por isso realmente quer dizer: não uma maneira de burlar as regras do WhatsApp, mas uma forma de conectar uma conta que já existe — o número de um fundador, o número de um representante de suporte, o WhatsApp do próprio freelancer — a um software sem que a Meta trate isso como uma implantação de novos negócios. Uma ferramenta de recrutamento que permite que cada recrutador envie mensagens a candidatos a partir de seu próprio número, uma caixa de entrada de suporte que unifica as contas pessoais do WhatsApp de uma equipe, ou uma agência que gerencia conversas de clientes a partir de números em que os clientes já confiam, tudo isso se enquadra nesta categoria, em vez do modelo de transmissão da Cloud API.
Esse segundo modelo é para o qual uma conexão baseada em sessão foi criada. O Unipile vincula a conta reproduzindo o mesmo fluxo de autenticação que o WhatsApp Web já usa: um QR code escaneado pelo telefone, ou um código de pareamento digitado no aplicativo do WhatsApp quando a leitura do código não for prática. Nenhum aplicativo de desenvolvedor da Meta, nenhuma conta do WhatsApp Business, nenhuma migração de número de telefone, nenhum modelo de mensagem enviado para aprovação.
Como a Unipile conecta uma conta existente
A Unipile conecta o própria conta existente do WhatsApp do usuário autenticado, via QR code ou código de pareamento, e age em nome de desse usuário. Não há verificação do Meta Business, nem WABA e nem aprovação de modelo, porque você não está provisionando um novo número de negócio, você está conectando uma conta que o usuário já possui.
Unipile é um intermediário técnico independente, não é um parceiro da Meta ou do WhatsApp e é não afiliado, endossado ou patrocinado por WhatsApp ou Meta. A frequência e a quantidade de mensagens enviadas por meio de uma conta vinculada continuam sendo um decisão do lado do cliente, e o comportamento no nível da conta do próprio WhatsApp ainda se aplica.
Este também é o modelo que escala através de canais. A mesma abordagem de conta vinculada que conecta o WhatsApp funciona para o LinkedIn, Instagram e Telegram, e para caixas de correio do Gmail, Outlook e IMAP, de modo que um produto que incorpora o WhatsApp dessa maneira pode adicionar outro canal sem uma segunda integração.
Conectar uma conta existente
Implementação

Como você conecta uma conta do WhatsApp com o Unipile?

Conectar uma conta do WhatsApp com o Unipile requer uma chamada de API e uma ação do usuário: chame o endpoint de contas com o provedor do WhatsApp, depois peça para o usuário escanear o código QR retornado ou digitar o código de pareamento retornado no telefone dele.
1Conectar por QR code
O fluxo padrão. Mostre o código QR retornado, o usuário o escaneia no WhatsApp > Aparelhos conectados.
connect-qr.js
// SDK para Node.js
const { qrCodeString, code } = await cliente.conta.conectarWhatsapp();
// renderizar qrCodeString para o usuário como uma imagem
2Conectar por código de pareamento
Para fluxos em que a leitura por scanner não é prática. Informe um número de telefone em dígitos no formato E.164.
connect-pairing.sh
POST /api/v1/accounts
X-API-KEY: sua_chave_de_api

{
  "provedor": "WHATSAPP",
  "número de telefone de pareamento": "33612345678"
}

// 201 Criado
{
  "objeto": "ContaCriada",
  "id_da_conta": "e-ma1oQ..."
}
3Enviar uma mensagem
Uma vez vinculado, envie texto, mídia, notas de voz ou documentos para qualquer chat.
send-message.sh
POST /api/v1/chats/{chat_id}/messages
X-API-KEY: sua_chave_de_api

{
  "texto": "Olá! O seu pedido foi enviado."
}

// 201 Criado
{
  "objeto": "Mensagem Enviada",
  "message_id": "msg_9f2c..."
}
4Ouça novas mensagens com um webhook
Registre um webhook uma vez, e cada nova mensagem será enviada para o seu endpoint em tempo real, sem polling.
payload-do-webhook.json
{
  "id_da_conta": "e-ma1oQ...",
  "tipo_de_conta": "WHATSAPP",
  "evento": "mensagem_recebida",
  "chat_id": "chat_182...",
  "message_id": "msg_9f2c...",
  "mensagem": "Olá, este pedido ainda está disponível?",
  "remetente": { "attendee_provider_id": "33612345678@s.whatsapp.net" },
  "carimbo de data/hora": "2026-08-04T10:15:02Z"
}
As mesmas quatro chamadas, connect, send, list, listen, funcionam de forma idêntica para LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP. Você integra o padrão uma vez. Para o fluxo completo de vinculação de contas, incluindo links wa.me e tratamento de reconexão, consulte nosso Fluxo de vinculação de conta do WhatsApp guia.
Comece a construir
Capacidades

O que você pode construir com a API do WhatsApp?

Com uma conta do WhatsApp vinculada, você pode enviar e receber textos, mídias, notas de voz e documentos, listar e sincronizar cada chat em seu próprio banco de dados, reagir e encaminhar mensagens, e obter entrega em tempo real por meio de webhooks, os mesmos endpoints que o Unipile usa para LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP.
CapacidadeO que ele fazAnotações
Enviar mensagensTexto, mídia, notas de voz, documentosNotas de voz: .mp3/.m4a. typing_duration simula digitação
Listar e sincronizar chatsImporte todas as conversas para o seu próprio banco de dadosPaginação baseada em cursor, filtrar por conta
Reagir a mensagensAdicionar uma reação com emoji a uma mensagemWhatsApp e LinkedIn
Encaminhar mensagensEncaminhar uma mensagem para outro chatSomente WhatsApp
Editar / excluir mensagensEditar ou excluir uma mensagem enviadaExcluir: WhatsApp + LinkedIn. Editar: WhatsApp + LinkedIn Classic
Webhooks em tempo realEventos de push: recebido, reação, lido, editado, excluído, entregueNenhuma consulta necessária
Passo a passo completo de solicitação e resposta para o envio de mensagens do WhatsApp: API do WhatsApp para enviar mensagens.

Liste todos os bate-papos do WhatsApp em seu software

Cada chat, seja pessoal ou aplicativo de negócios, é sincronizado através do mesmo endpoint. Filtre por conta e pagine com um cursor para puxar toda a sua caixa de entrada.
list-chats.sh
GET /api/v1/chats?account_id=e-ma1oQ...&account_type=WHATSAPP&limit=50
X-API-KEY: sua_chave_de_api

// 200 OK
{
  "objeto": "Lista de Chats",
  "itens": [
    {
      "identificador": "chat_182...",
      "id_da_conta": "e-ma1oQ...",
      "nome": "Jordan Miles",
      "unread_count": 2,
      "arquivado": falso
    }
  ],
  "cursor": "eyJsYXN0X2..."
}
Construa sua integração com o WhatsApp

Como a Unipile ajuda os desenvolvedores a conectar o WhatsApp instantaneamente ao seu software

A Unipile oferece um caminho alternativo para fornecedores de SaaS que desejam integrar o WhatsApp sem passar pelo programa oficial de parceiros da Meta. Somos não é um parceiro MetaEm vez disso, oferecemos uma API de mensagens unificada que permite aos desenvolvedores conectar contas pessoais ou comerciais do WhatsApp instantaneamente por meio de um fluxo de autenticação de código QR. Essa abordagem torna possível adicionar o WhatsApp a outros canais em apenas algumas etapas.

Seu aplicativo
MO
Michel Opra
LinkedIn Instagram WhatsApp Gmail Google Agenda
Mensagem Email Calendário
Atividades Novo
Gmail
Aqui está o contrato assinado
Hoje 3:08 PM
Eu te enviei o contrato
Hoje 1:02 PM
Google Agenda
Evento agendado para segunda-feira, 05/02
Ontem 11:54 AM
WhatsApp Clássico WhatsApp
Clássico
WhatsApp Business WhatsApp
Negócios
API do WhatsApp

Integração de Mensagens do WhatsApp com Unipile

Com o Unipile, os desenvolvedores podem integrar todos os principais recursos de mensagens do WhatsApp diretamente em seu SaaS em apenas algumas etapas. A API suporta mensagens de texto simples, mídia e sincronização em tempo real para que seus usuários nunca percam uma interação.

Mensagens de texto : envie e responda mensagens instantaneamente.
Notas de voz : grave e envie mensagens de áudio diretamente na conversa.
Compartilhamento de mídia : troca de fotos, documentos e vídeos.
Histórico e recibos de mensagens Sincronize o histórico de bate-papo, liste as reações e acompanhe os recibos de leitura em tempo real.
Webhooks em tempo real notificações instantâneas para alterações de status da conta, novas mensagens, reações e confirmações de leitura.
Crie já
João Rodrigues
Gmail
WhatsApp
LinkedIn LinkedIn
Gmail Gmail
JR
Mensagem de voz enviada
0:45
JR
Mensagem
Obrigado John, vou revisar os detalhes e retorno em breve.
Pino
Silenciar
Arquivo
Responda ao John via WhatsApp
Michel Opra
João Rodrigues
Alicia Smith
Emma Ward
Grupo Q1
Sessão de recrutamento - Reino Unido - 16 pessoas
Michel Opra
Michel Opra
Olá a todos, bem-vindos à sessão de recrutamento.
Alicia Smith
Alicia Smith
Obrigado, Michel, por favor, encontre os detalhes aqui.
João Rodrigues
João Rodrigues
Obrigado, Alicia. Revisarei os detalhes e retornarei em breve.
Responder ao grupo via WhatsApp
Grupos do WhatsApp

Gerenciar Grupos do WhatsApp com API da Unipile

A API do WhatsApp da Unipile permite que desenvolvedores integrem gerenciamento completo do grupo diretamente em seus aplicativos. Seus usuários podem criar ou participar de grupos do WhatsApp, enviar e responder a mensagens de grupo, e sincronizar conversas em tempo real.

Seja coordenando uma sessão de recrutamento, gerenciando discussões de vendas ou conduzindo o engajamento da comunidade, cada interação de grupo pode ser centralizada em seu CRM ou ATS. Com suporte para texto, imagens, documentos e notas de voz, as equipes permanecem conectadas e produtivas sem sair de sua plataforma.

Criar e ingressar em grupos
Mensagens de grupo
Sincronização em tempo real
Crie já
Seu aplicativo
Painel de controle
Inbox
Contatos
Calendário
Lembretes
Produtos
Citações
Chamadas
Michel Opra
Michel Opra
Obrigado!
Sofia Rivera
Sofia Rivera
Oi Sarah, sou espanhol...
Daniel Martinez
Daniel Martinez
Quando você o comprou?
Gabriel Lopez
Gabriel Lopez
Você pode me ajudar com isso?
Elena Garcia
Elena Garcia
Prezada Sarah,
Natalia Diaz
Natalia Diaz
Portanto, depende de você!
Victor Harris
Victor Harris
Eu sou Victor da Polônia.
Oscar Ward
Oscar Ward
Obrigado por perguntar!
API do WhatsApp

Liste tudo O que são os bate-papos daApp em seu software

Listar todos os bate-papos
OBTER
enrolar --request OBTER
     --url https://api1.unipile.com:13111/api/v1/chats
     --header 'accept: application/json'

A API da Unipile facilita a recuperação de todas as conversas do WhatsApp vinculadas a uma conta de usuário. Se tratam de mensagens individuais, discussões em grupo ou tópicos arquivados, os desenvolvedores podem extrair lista completa de conversas com uma única solicitação. Isso garante que sua plataforma SaaS possa centralizar todas as interações do WhatsApp em tempo real, oferecendo aos usuários uma experiência de caixa de entrada completa e unificada.

Unipile - Recursos da API do WhatsApp
API do WhatsApp

Recursos da API do WhatsApp com Unipile

Integre mensagens do WhatsApp ao seu CRM, ATS ou ferramenta de prospecção com uma única API. Sincronize chats, grupos e contatos em tempo real, em nome de seus usuários autenticados, sem sair da sua plataforma.

Explorar todos os pontos de extremidade
Mensagens
Conexão de contaConta
Anexos
Webhooks

Mensagens

10 endpoints disponíveis

Enviar e responder mensagens
Enviar mensagens de voz
Enviar mensagens de vídeo
Listar mensagens, bate-papos e participantes
Histórico de sincronização
Reações
Excluir mensagem
Ler recibos
Criar grupo
Listar grupos e contatos

Conexão de conta

2 endpoints disponíveis

Auth Hospedada: white label para conectar seus usuários finais
Autenticação personalizada: conecte usuários com credenciais, cookies, sua extensão do Chrome

Anexos

2 endpoints disponíveis

Enviar anexos de arquivos
Receber anexos de arquivos

Webhooks

3 eventos disponíveis

Status da conta
Nova mensagem
Nova reação / leitura / evento
Grupos

A API do WhatsApp suporta mensagens em grupo?

Sim. A Meta adicionou uma API de Grupos oficial à Plataforma WhatsApp Business, mas ela vem com restrições reais que a maioria das equipes não espera.
E aí
Conta Comercial Oficial obrigatória
8
Máximo de participantes por grupo
10,000
Máximo de grupos por número
Por mensagem
Cobrado como qualquer outra conversa
Não suportado: chamadas, mensagens temporárias, visualização única, mensagens interativas, comércio, modelos de autenticação ou edição e exclusão de mensagens em grupo. Contas conectadas ao Unipile seguem a mecânica de grupos nativa do WhatsApp em vez dessas restrições da Cloud API.
O comportamento dos grupos difere significativamente entre a API de Grupos da Meta e as conexões baseadas em sessão. Análise completa em nosso Guia da API de Grupos do WhatsApp.
Perspectivas para 2026

Quais ferramentas e APIs de automação do WhatsApp você deve usar em 2026?

Isso depende do que você está construindo. Uma plataforma SaaS que integra o WhatsApp de cada usuário precisa de uma API unificada baseada em sessões. Uma empresa que faz disparos em massa precisa da API em Nuvem da Meta ou de um BSP. Um desenvolvedor prototipando uma ideia precisa de qualquer opção que coloque uma integração funcional para funcionar hoje.
PerfilO que eles precisamAbordagem de melhor ajuste
Inclusão de contas de propriedade do usuário em SaaS / CRMCada usuário final conecta o WhatsApp (e muitas vezes o LinkedIn, Instagram, e-mail) que ele já tem, dentro do seu produtoAPI de sessão unificada, sem verificação da Meta por usuário
Transmissão corporativa em larga escalaUm número de empresa verificado enviando modelos de marketing ou utilidade para um grande públicodiretamente pela API de Nuvem da Meta ou por meio de um BSP
Prototipação de desenvolvedorCaminho mais rápido possível para uma integração funcional antes de se comprometer com a infraestruturaAPI de Sessão para contas pertencentes a usuários, sandbox da Cloud API para um único número comercial
Estes não são mutuamente exclusivos. Alguns produtos usam ambos: um número de API em nuvem para marketing de saída e uma conexão baseada em sessão para incorporação de contas dentro do próprio produto.
O que mudou com a chegada de 2026 tem menos a ver com novas APIs e mais com a pressão de cobrança e acesso. A precificação por mensagem premia a precisão em vez do volume, então ferramentas criadas em torno de transmissões em massa precisam de um direcionamento mais rigoroso do que no antigo modelo baseado em conversas. Ao mesmo tempo, a demanda pelo caso de uso de uso pessoal — indivíduos e pequenas equipes conectando uma única conta em vez de provisionar um número comercial — continua crescendo, razão pela qual as APIs baseadas em sessão passaram de um contorno alternativo de nicho para uma categoria dominante por direito próprio.
Se o WhatsApp for um dos vários canais que você planeja oferecer suporte, uma API unificada elimina a necessidade de integrar o SDK de cada provedor separadamente. Veja API multicanal para agentes de IA.
Práticas recomendadas

Quais são as melhores práticas da API do WhatsApp da Meta?

As melhores práticas oficiais da Meta para a Plataforma do WhatsApp Business centram-se em seis pontos: obter consentimento real, proteger sua classificação de qualidade, usar a categoria de modelo correta, respeitar a janela de atendimento de 24 horas, lidar com erros adequadamente e permanecer dentro dos limites de taxa.
01
Obtenha consentimento real
Envie mensagens apenas para usuários que concordaram explicitamente em ser contatados no WhatsApp pela sua empresa. A Meta exige um opt-in claro e verificável antes de você enviar uma mensagem de modelo.
02
Proteja sua avaliação de qualidade
A Meta rastreia as taxas de bloqueio e denúncia por número de telefone. Uma baixa classificação de qualidade restringe o seu nível de mensagens e pode pausar o envio completamente.
03
Use a categoria de modelo correta
Escolha marketing, utilidade ou autenticação com precisão no envio. Categorias incorretas têm modelos rejeitados ou cobrados pela taxa errada.
04
Respeite a janela de atendimento de 24 horas
Reserve respostas livres e sem modelo para uma janela que o usuário abriu enviando a primeira mensagem. Use modelos aprovados fora dessa janela.
05
Tratar erros com repetição com atraso exponencial
Implemente a lógica de nova tentativa (retry) para erros de limite de taxa (rate-limit) e transitórios, em vez de sobrecarregar a API em caso de falha.
06
Mantenha-se dentro dos limites de taxa
O uso excessivo sustentado dos limites de taxa de transferência, por hora ou por par, degrada sua classificação de qualidade antes mesmo que você atinja um bloqueio rígido.
Meta para Desenvolvedores, documentação da Plataforma do WhatsApp Business.
Unipile - Por que escolher Unipile
Meta vs Unipile

Por que escolher o Unipile em vez de construir no Meta

Supere as limitações das APIs da Meta. Veja como o Unipile se compara em velocidade, esforço e acesso, para que você possa focar em construir em vez de lidar com a configuração.

Critérios Meta APIs Unipile
Hora de integrar Semanas ou meses 2-3 dias
Esforço de desenvolvimento Alta Baixo (REST + SDKs)
Manutenção Manual Totalmente gerenciado
Acesso aos recursos Parcial (após aprovação) Completo, instantaneamente
Suporte Somente autoatendimento Equipe de tecnologia dedicada
Hora de integrar
Meta APIsSemanas ou meses
Unipile2-3 dias
Esforço de desenvolvimento
Meta APIsAlta
UnipileBaixo (REST + SDKs)
Manutenção
Meta APIsManual
UnipileTotalmente gerenciado
Acesso aos recursos
Meta APIsParcial (após aprovação)
UnipileCompleto, instantaneamente
Suporte
Meta APIsSomente autoatendimento
UnipileEquipe de tecnologia dedicada
Critérios Meta APIs Unipile
Hora de integrar Semanas/mêses 2-3 dias
Esforço de desenvolvimento Alta Baixo (REST + SDKs)
Manutenção Manual Totalmente gerenciado
Acesso aos recursos Parcial (após aprovação) Completo, agora
Suporte Somente autoatendimento Equipe de tecnologia dedicada

Integração rápida e simplificada

Com a Unipile, a integração do WhatsApp leva apenas alguns minutos. Os desenvolvedores podem autenticar contas por meio de um código QR seguro, começar a enviar e receber mensagens imediatamente e se beneficiar do suporte dedicado durante a configuração. Essa abordagem reduz drasticamente o tempo de colocação no mercado, facilitando para os editores de SaaS o lançamento de novos recursos de mensagens.

Recursos completos de mensagens

A API Unipile fornece acesso total às funções essenciais do WhatsApp: envio e recebimento de mensagens, notas de voz, imagens, vídeos, documentos e sincronização de conversas em tempo real. Todas as comunicações são centralizadas em uma caixa de entrada unificada, garantindo que nada seja perdido. Além do WhatsApp, a mesma API conecta o LinkedIn, o Instagram, o Telegram, o Messenger, o X/Twitter, o Gmail e o Outlook.

Painel de controle unificado

Um painel de controle para todas as suas integrações

Gerencie todas as suas contas do LinkedIn, WhatsApp, Gmail e muito mais em uma única interface intuitiva.

/
Acme
/
Aplicativo
Documentação
Referência da API
Changelog
Conectar uma nova conta
Selecione o tipo de conta que você deseja
deseja se conectar
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Instagram
Instagram
Telegrama
Telegrama
Google
Google
IMAP
IMAP
Microsoft
Microsoft
Google Agenda
Google Agenda
Calendário do Outlook
Calendário do Outlook

Contas

20 Operacional
0 Autenticação necessária
0 Interrupção do serviço
0 Em pausa
Nome ID Status Vinculado
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/15/2025
Operacional Ligado em
02/10/2025
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/28/2025
Operacional Ligado em
02/20/2025
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/25/2025
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/22/2025
Operacional Ligado em
02/14/2025
Operacional Ligado em
02/12/2025
Operacional Ligado em
02/08/2025
Operacional Ligado em
02/05/2025
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/15/2025
Operacional Ligado em
03/01/2025
Operacional Ligado em
02/22/2025
Experimente gratuitamente
Demonstração do painel
Autenticação de código QR da API do WhatsApp para conectar dispositivos

Integração rápida da API do WhatsApp com autenticação por código QR

Com a Unipile, conectar uma conta do WhatsApp leva apenas alguns minutos. O fluxo é simples, seguro e evita o longo processo de aprovação comercial da Meta. Veja como funciona:

1. Solicitar um código QR

Seu aplicativo gera um código QR exclusivo por meio da API Unipile. Os usuários simplesmente o escaneiam com o WhatsApp para iniciar a autenticação.

2. Exibir o código QR

O código QR pode ser exibido diretamente em seu aplicativo usando bibliotecas padrão (PHP ou JS). Os usuários o escaneiam com o telefone para vincular a conta.

3. Confirmar a autenticação

Quando o código é lido, o status da conta muda para conectado. Você pode ouvir esse evento pesquisando o status da conta ou configurando um webhook para confirmação em tempo real.

4. Iniciar o envio de mensagens

Assim que a conta estiver ativa, você poderá enviar e receber mensagens de texto, compartilhar imagens, vídeos, documentos e notas de voz. Os webhooks em tempo real também o notificam sobre novas mensagens, reações e recibos de leitura.

Unipile - Casos de Uso WhatsApp

Explore mais com
nossa API de mensagens

A Unipile não se limita ao WhatsApp. Nossa API unificada também se conecta ao LinkedIn, Instagram, Messenger, X (Twitter) e Telegram. Ao centralizar todos esses canais em um só lugar, seus usuários podem gerenciar todas as conversas sem problemas. De mensagens diretas a comentários e bate-papos em grupo, tudo fica acessível em uma única caixa de entrada, ajudando as equipes a responder mais rapidamente, acompanhar o envolvimento e proporcionar uma experiência consistente ao usuário em todas as plataformas.

Unipile – Suporte e Recursos de Integração
API do WhatsApp

Suporte e recursos de integração para o sucesso da API do WhatsApp

Cofundadores da Unipile, CTO e CEO
Chamada de integração
Marque uma reunião sob demanda com nossos fundadores (CTO e CEO) para alinhar a estratégia técnica e de produto.
Conecte-se com o suporte ao vivo
Nosso suporte ao vivo está à sua disposição antes, durante e depois da integração, garantindo orientação em todas as etapas sem custo adicional.

Configuração técnica simplificada

Integre rapidamente recursos de mensagens do WhatsApp usando nossa API totalmente documentada e exemplos de SDK. Quer seja para enviar mensagens, compartilhar mídia ou sincronizar conversas, nossas ferramentas são projetadas para ajudá-lo a entrar em operação em dias, em vez de semanas.

Suporte especializado para uma implantação tranquila

Nossa equipe técnica trabalha diretamente com seus desenvolvedores para garantir uma integração perfeita. Desde a autenticação com código QR até o gerenciamento de webhooks e a depuração de fluxos de mensagens em tempo real, os especialistas da Unipile orientam sua integração em cada etapa do processo.

Aprimoramentos contínuos e compatibilidade

Alinhamos continuamente nossos pontos de extremidade da API do WhatsApp com as atualizações mais recentes. Isso garante que seu produto se beneficie dos novos recursos sem alterações ou interrupções inesperadas. Você se mantém atualizado e em conformidade, sem nenhuma sobrecarga de manutenção.

Unipile - Considerações Finais

Considerações finais

O WhatsApp se tornou um canal essencial para engajamento, suporte e vendas de clientes, com bilhões de usuários.

A Unipile elimina essas barreiras com um API de mensagens unificadas o que torna a integração do WhatsApp rápida, segura e amigável para desenvolvedores. Através de uma simples autenticação por código QR, empresas de software podem habilitar mensagens de texto, compartilhamento de mídia, notas de voz e conversas em grupo em apenas minutos, sem precisar se tornar parceiro da Meta ou hospedar infraestrutura. Webhooks em tempo real, sincronização de mensagens e compatibilidade multicanal garantem uma experiência integrada entre WhatsApp, LinkedIn, Instagram, Telegram, Gmail e Outlook.

Ao escolher a Unipile, as plataformas SaaS podem oferecer verdadeira comunicação omnichannelUma API, uma integração, um potencial ilimitado. Independentemente de você estar criando uma solução de CRM, ATS ou de alcance, a Unipile acelera o tempo de colocação no mercado, reduz os custos de manutenção e garante a conformidade com a Lei de Mercados Digitais.

Agora é a hora de transformar o WhatsApp em um ativo poderoso para o seu produto. Comece a construir com a Unipile hoje mesmo e ofereça aos seus usuários a experiência de comunicação que eles esperam.

API do WhatsApp - Perguntas Frequentes

Respostas diretas sobre uso pessoal, custo, limites e acesso, obtidas da própria documentação da Meta.
Sim. É isso que API do WhatsApp para uso pessoal significa na prática: conectar uma conta que você já possui. O Unipile vincula a própria conta existente do WhatsApp do usuário autenticado, aplicativo pessoal ou empresarial, por código QR ou código depareamento, e atua em nome de aquele usuário, do mesmo jeito que o WhatsApp Web faz. Não há verificação do Meta Business, nem WABA e nem aprovação de modelos, porque você não está provisionando um novo número comercial. A própria API em Nuvem da Meta, em contraste, foi criada para empresas que provisionam um novo número, não para contas pessoais. Como uma conta vinculada é usada depois, cadência e volume, continua sendo um decisão do lado do cliente. A Unipile é um intermediário técnico independente e é não afiliado, endossado ou patrocinado por WhatsApp ou Meta.
O acesso à própria API não é cobrado por mensagem do lado da Unipile além da sua assinatura, mas a Meta cobra a Plataforma do WhatsApp Business por mensagem entregue desde 1º de julho de 2025. Os modelos de marketing e autenticação são sempre cobrados. Os modelos de utilidade e as respostas de formato livre só são gratuitos quando enviados dentro de uma janela de atendimento ao cliente aberta de 24 horas. Consulte Preços da API do WhatsApp Business para a tabela de preços completa.
Isso depende do caminho. A Cloud API da Meta autentica cada solicitação com um token de acesso permanente vinculado ao seu aplicativo Meta e à WABA. Uma conexão baseada em sessão não usa nenhum token da Meta: a conta é autenticada uma vez por código QR ou código de pareamento, e as solicitações para o próprio Unipile são autenticadas com sua própria chave de API do Unipile.
Não. "WhatsApp Business API" é o nome mais antigo e geral para toda a plataforma. A Cloud API é a superfície oficial atual que a Meta hospeda para ela, após a Meta descontinuar a API On-Premise. No uso diário, os dois termos agora são usados quase de forma intercambiável para significar a mesma plataforma hospedada pela Meta.
Depende inteiramente do caminho. Uma conexão baseada em sessão com uma API unificada pode entrar no ar em minutos: criar uma conta, escanear um código QR, começar a enviar. A API em Nuvem da Meta demora mais: criar uma WABA, adicionar um número de telefone comercial e, para níveis de mensagens mais altos, concluir a verificação comercial da Meta, o que pode levar de alguns dias a algumas semanas por si só.
Apenas para a API da Nuvem da Meta, e apenas acima de um determinado volume. Uma WABA não verificada ainda pode enviar para até 250 destinatários exclusivos por 24 horas. A verificação é necessária para desbloquear níveis mais altos de mensagens. Conectar uma conta existente por meio de uma API baseada em sessão ignora esse requisito completamente, pois nenhum novo número comercial está sendo provisionado.
Sim. Tanto a Cloud API quanto uma conexão baseada em sessão entregam mensagens recebidas por meio de webhooks. Com o Unipile, uma conta do WhatsApp vinculada aciona um message_received evento de webhook em tempo real, com o texto da mensagem, remetente e anexos, para que você nunca precise consultar novas mensagens.
A Meta adicionou uma API de Grupos oficial à Cloud API, limitada a 8 participantes por grupo e restrita a uma Conta Oficial do Business. Conexões baseadas em sessão seguem o comportamento de grupo nativo do WhatsApp. Detalhes completos em nosso Guia da API de Grupos do WhatsApp.
Os preços da Meta variam por categoria de modelo e pelo país do destinatário, e não por uma única taxa fixa. Como regra geral, os modelos de autenticação e marketing custam mais, enquanto os modelos de utilidade custam menos e costumam ser gratuitos dentro de uma janela de atendimento aberta. Consulte nosso Preços da API do WhatsApp Business guia para números em nível de país.
A Meta limita a API da Nuvem a aproximadamente 80 mensagens por segundo, 200 a 5.000 solicitações de API por hora dependendo do status da conta, e uma mensagem a cada 6 segundos para o mesmo destinatário. Um nível de mensagens também limita quantos clientes únicos você pode alcançar em 24 horas, começando em 250 e aumentando com a verificação e a qualidade.
Sim, de duas maneiras diferentes. Você pode se integrar diretamente à Cloud API da Meta como um Provedor de Tecnologia registrado, sem passar por um Provedor de Soluções de Negócios (BSP). Ou você pode ignorar completamente a pilha da Cloud API e conectar uma conta do WhatsApp existente por meio de uma API unificada baseada em sessão, o que nunca foi território de BSP para começar.
Sim, mas não da mesma forma. A Meta introduziu uma coexistência limitada entre o aplicativo WhatsApp Business e a Cloud API no mesmo número, com restrições. Uma conexão baseada em sessão segue um caminho mais simples: ela vincula a conta do aplicativo Business diretamente, por código QR ou código de pareamento, da mesma forma que o WhatsApp Web faz, sem uma configuração paralela da Cloud API.
Ainda tem dúvidas? Nossa equipe está aqui para ajudar.
Fale com um especialista

Você também pode gostar

Como enviar uma mensagem à API do LinkedIn a partir de um aplicativo

Como enviar uma mensagem à API do LinkedIn a partir de um aplicativo

Enviar mensagem LinkedIn APIIntegrar os recursos de mensagens do LinkedIn em seu aplicativo pode aumentar significativamente o envolvimento do usuário e simplificar a comunicação. Este guia o orientará no uso da API do LinkedIn para enviar mensagens diretamente do seu aplicativo, detalhando as etapas, as ferramentas e os...

ler mais
pt_BRBR