Participe da comunidade do Slack
API do WhatsApp: Tipos, Acesso, Preços e Limites
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'
});O que é a API do WhatsApp?
| Nome | O que é | Quem opera | Requisitos 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 escala | Meta | Aplicativo 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 faturamento | Infraestrutura da Meta, gerenciada por BSP | Mesmos 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 pareamento | Unipile, em nome do usuário autenticado | Sem verificação no Meta Business, sem novo número, sem aprovação de modelo |
Quais são os diferentes tipos de API do WhatsApp?
| Tipo | Provisionamento | Ideal para | Funciona com uma conta existente |
|---|---|---|---|
| API de nuvem | Novo número de telefone comercial + Verificação do Meta Business para maior volume | Empresas que enviam marketing ou notificações em alto volume em escala | Não, requer um novo número |
| API On-Premise | Descontinuado. A Meta o desativou e incentivou a migração para a Cloud API | Apenas integrações legadas | Não |
| Aplicativo WhatsApp Business | Aplicativo gratuito para o consumidor, configuração manual em um dispositivo | Pequenas empresas gerenciando conversas manualmente | Sim, 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 novo | Plataformas SaaS incorporando a conta de WhatsApp de cada próprio usuário no produto | Sim, este é o caso de uso principal |
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.
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.
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.
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.
Você pode integrar o WhatsApp ao seu próprio software?
Como você obtém acesso à API do WhatsApp?
O que você precisa antes de poder usar a API do WhatsApp Cloud?
Quais são os limites da API do WhatsApp?
| Limite | Valor | Observações |
|---|---|---|
| Rendimento | 80 mensagens / segundo | Taxa de envio em toda a plataforma |
| Limite de taxa da API | 200 a 5.000 requisições / hora | Escala com o status e a qualidade da conta |
| Limite de taxa do par | 1 mensagem / 6 segundos | Por destinatário, impede o envio de spam para o mesmo usuário |
| Nível de mensagens | 250 → 2.000 → 10.000 → 100.000 → ilimitado | Destinatários únicos por período contínuo de 24h, começa em 250 não verificados |
Você pode usar a API do WhatsApp com uma conta existente do aplicativo WhatsApp Business?
Como você conecta uma conta do WhatsApp com o Unipile?
// SDK para Node.js
const { qrCodeString, code } = await cliente.conta.conectarWhatsapp();
// renderizar qrCodeString para o usuário como uma imagemPOST /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..."
}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..."
}{
"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"
}O que você pode construir com a API do WhatsApp?
| Recurso | O que faz | Observações |
|---|---|---|
| Enviar mensagens | Texto, mídia, notas de voz, documentos | Notas de voz: .mp3/.m4a. typing_duration simula digitação |
| Listar e sincronizar chats | Importe todas as conversas para o seu próprio banco de dados | Paginação baseada em cursor, filtrar por conta |
| Reagir a mensagens | Adicionar uma reação com emoji a uma mensagem | WhatsApp e LinkedIn |
| Encaminhar mensagens | Encaminhar uma mensagem para outro chat | Somente WhatsApp |
| Editar / excluir mensagens | Editar ou excluir uma mensagem enviada | Excluir: WhatsApp + LinkedIn. Editar: WhatsApp + LinkedIn Classic |
| Webhooks em tempo real | Eventos de push: recebido, reação, lido, editado, excluído, entregue | Nenhuma consulta necessária |
Liste todos os bate-papos do WhatsApp em seu software
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..."
}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.
WhatsAppClássico
WhatsAppNegócios
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.
LinkedIn
Gmail
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.
Liste tudo O que são os bate-papos daApp em seu software
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.
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.
Mensagens
10 endpoints disponíveis
Conexão de conta
2 endpoints disponíveis
Anexos
2 endpoints disponíveis
Webhooks
3 eventos disponíveis
A API do WhatsApp suporta mensagens em grupo?
Quais ferramentas e APIs de automação do WhatsApp você deve usar em 2026?
| Perfil | Do que precisam | Abordagem recomendada |
|---|---|---|
| Inclusão de contas de propriedade do usuário em SaaS / CRM | Cada usuário final conecta o WhatsApp (e muitas vezes o LinkedIn, Instagram, e-mail) que ele já tem, dentro do seu produto | API de sessão unificada, sem verificação da Meta por usuário |
| Transmissão corporativa em larga escala | Um número de empresa verificado enviando modelos de marketing ou utilidade para um grande público | diretamente pela API de Nuvem da Meta ou por meio de um BSP |
| Prototipação de desenvolvedor | Caminho mais rápido possível para uma integração funcional antes de se comprometer com a infraestrutura | API de Sessão para contas pertencentes a usuários, sandbox da Cloud API para um único número comercial |
Quais são as melhores práticas da API do WhatsApp da Meta?
Para onde ir a seguir com a API do WhatsApp
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 |
| Critérios | APIs da Meta | 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.
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.
deseja se conectar
Contas
03/01/2025
02/15/2025
02/10/2025
03/01/2025
02/28/2025
02/20/2025
03/01/2025
02/25/2025
03/01/2025
02/22/2025
02/14/2025
02/12/2025
02/08/2025
02/05/2025
03/01/2025
02/15/2025
03/01/2025
02/22/2025
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.
Casos de Uso: Adicionar WhatsApp ao Seu Produto
Leve a mensagem nativa do WhatsApp para as ferramentas em que seus usuários já trabalham, desde vendas e recrutamento até contatos multicanais.
CRM / Ferramentas de vendas
Transforme as conversas em oportunidades. Traga as mensagens do WhatsApp diretamente para o seu CRM. Centralize as conversas com os clientes, responda com mais rapidez, compartilhe documentos ou anotações de voz e acione acompanhamentos automatizados, tudo em um só lugar, sem precisar trocar de ferramenta.
WhatsApp para CRMATS / Recrutamento
Conecte-se com os candidatos onde eles estão. Sincronize as conversas dos candidatos no WhatsApp e gerencie-as em uma caixa de entrada compartilhada. Atribua tópicos a colegas de equipe, colabore facilmente e mantenha todas as trocas visíveis em seu ATS para acelerar as decisões de contratação.
WhatsApp para ATSPlataformas de divulgação
Multicanal simplificado. Crie campanhas que combinem WhatsApp, LinkedIn e e-mail em um fluxo de trabalho unificado. Envie sequências personalizadas, acompanhe as respostas em tempo real e mantenha a conformidade enquanto gerencia todas as conversas em sua ferramenta de divulgação.
Ferramenta WhatsApp for OutreachExplore 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.
Suporte e recursos de integração para o sucesso da API do WhatsApp
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.
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
message_received evento de webhook em tempo real, com o texto da mensagem, remetente e anexos, para que você nunca precise consultar novas mensagens.
