{"id":39,"date":"2026-10-20T19:07:38","date_gmt":"2026-10-20T19:07:38","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/"},"modified":"2026-10-25T13:16:58","modified_gmt":"2026-10-25T13:16:58","slug":"api-oficial-do-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/","title":{"rendered":"API Oficial do WhatsApp: guia completo (2026)"},"content":{"rendered":"\n<p><em>Atualizado em 25\/10\/2026<\/em><\/p>\n\n\n\n<p>A API oficial do WhatsApp \u00e9 a WhatsApp Business Platform da Meta, oferecida hoje como Cloud API: uma API HTTP hospedada pela pr\u00f3pria Meta que permite enviar e receber mensagens a partir do seu sistema. Para us\u00e1-la, voc\u00ea precisa de um portf\u00f3lio empresarial na Meta, um n\u00famero registrado na plataforma, templates aprovados para iniciar conversas e uma forma de pagamento, j\u00e1 que a cobran\u00e7a \u00e9 feita por mensagem entregue. \u00c9 o \u00fanico caminho que a Meta autoriza para automatizar o WhatsApp de uma empresa.<\/p>\n\n\n\n<p>Este guia explica o que separa a API oficial das bibliotecas n\u00e3o oficiais, quais s\u00e3o os requisitos, como escolher entre integrar direto com a Meta ou usar um intermedi\u00e1rio, quanto custa em linhas gerais e em que cen\u00e1rios a troca compensa.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que \u00e9 a API oficial do WhatsApp<\/h2>\n\n\n\n<p>A WhatsApp Business Platform \u00e9 o conjunto de APIs que a Meta disponibiliza para empresas. Na pr\u00e1tica, quando algu\u00e9m fala em &#8220;API oficial do WhatsApp&#8221; hoje, est\u00e1 falando da <strong>Cloud API<\/strong>: endpoints da Graph API (<code>graph.facebook.com<\/code>) que recebem JSON e devolvem JSON, e webhooks que avisam seu servidor quando chega uma mensagem ou muda o status de uma mensagem enviada.<\/p>\n\n\n\n<p>Alguns termos aparecem o tempo todo na documenta\u00e7\u00e3o da Meta. Vale conhecer antes de come\u00e7ar:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><th>Onde aparece<\/th><\/tr><\/thead><tbody><tr><td>Portf\u00f3lio empresarial<\/td><td>A conta da empresa na Meta (antes chamada de Business Manager). Pode ser verificada.<\/td><td><code>business_id<\/code><\/td><\/tr><tr><td>Conta de mensagens (WABA)<\/td><td>A antiga conta do WhatsApp Business (WABA). Desde 23\/09\/2026, a Meta separou a WABA em duas: a <strong>conta do WhatsApp<\/strong>, que det\u00e9m os n\u00fameros, e a <strong>conta de mensagens<\/strong>, que guarda templates, cobran\u00e7a e webhooks. Os IDs de WABA existentes viraram IDs de conta de mensagens.<\/td><td><code>waba_id<\/code><\/td><\/tr><tr><td>N\u00famero de telefone comercial<\/td><td>O n\u00famero registrado na Cloud API, usado para enviar e receber.<\/td><td><code>phone_number_id<\/code><\/td><\/tr><tr><td>Template (modelo de mensagem)<\/td><td>Mensagem pr\u00e9-aprovada, obrigat\u00f3ria para iniciar contato fora da janela de atendimento.<\/td><td><code>type: \"template\"<\/code><\/td><\/tr><tr><td>Janela de atendimento<\/td><td>Per\u00edodo de 24 horas aberto a cada mensagem do cliente, em que voc\u00ea pode responder com mensagens livres.<\/td><td>regras de envio e pre\u00e7o<\/td><\/tr><tr><td>Webhook<\/td><td>URL do seu sistema que recebe eventos (mensagens recebidas, status de entrega).<\/td><td><code>object: \"whatsapp_business_account\"<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">API oficial \u00d7 API n\u00e3o oficial<\/h2>\n\n\n\n<p>Bibliotecas como Baileys e WPPConnect, e ferramentas constru\u00eddas sobre elas (como o modo Baileys da Evolution API), funcionam emulando o WhatsApp Web: voc\u00ea l\u00ea um QR Code com o celular e o software passa a controlar aquela sess\u00e3o. N\u00e3o existe contrato com a Meta, n\u00e3o existe template, n\u00e3o existe cobran\u00e7a por mensagem. Tamb\u00e9m n\u00e3o existe garantia de que a pr\u00f3xima atualiza\u00e7\u00e3o do WhatsApp n\u00e3o v\u00e1 quebrar a integra\u00e7\u00e3o.<\/p>\n\n\n\n<p>Os <a href=\"https:\/\/www.whatsapp.com\/legal\/terms-of-service\">Termos de Servi\u00e7o do WhatsApp<\/a> pro\u00edbem acessar ou usar o servi\u00e7o &#8220;por meios automatizados&#8221; n\u00e3o autorizados e criar contas &#8220;por meios n\u00e3o autorizados ou automatizados&#8221;. O texto tamb\u00e9m cita envio em massa e mensagens autom\u00e1ticas entre os usos n\u00e3o permitidos. \u00c9 por isso que n\u00fameros usados com APIs n\u00e3o oficiais podem ser banidos sem aviso.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Crit\u00e9rio<\/th><th>API oficial (Cloud API)<\/th><th>API n\u00e3o oficial (Baileys, WPPConnect etc.)<\/th><\/tr><\/thead><tbody><tr><td>Autoriza\u00e7\u00e3o da Meta<\/td><td>Sim, \u00e9 o produto da Meta para empresas<\/td><td>N\u00e3o; contraria os Termos de Servi\u00e7o<\/td><\/tr><tr><td>Conex\u00e3o<\/td><td>Token de acesso e chamadas HTTP<\/td><td>Sess\u00e3o do WhatsApp Web via QR Code<\/td><\/tr><tr><td>Risco de banimento por uso da ferramenta<\/td><td>N\u00e3o; o risco vem de qualidade e pol\u00edtica<\/td><td>Alto e imprevis\u00edvel<\/td><\/tr><tr><td>Iniciar conversa<\/td><td>S\u00f3 com template aprovado<\/td><td>Mensagem livre (e \u00e9 a\u00ed que mora o risco)<\/td><\/tr><tr><td>Custo de mensagens<\/td><td>Por mensagem entregue, tabela da Meta<\/td><td>Sem cobran\u00e7a da Meta<\/td><\/tr><tr><td>Estabilidade<\/td><td>Versionada, com changelog e prazos de descontinua\u00e7\u00e3o<\/td><td>Depende de engenharia reversa<\/td><\/tr><tr><td>Webhooks<\/td><td>Formato documentado pela Meta<\/td><td>Formato pr\u00f3prio de cada biblioteca<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>A Evolution API, vale notar, tamb\u00e9m oferece integra\u00e7\u00e3o com a API oficial, al\u00e9m do modo baseado em Baileys. O que define o risco \u00e9 o canal usado, n\u00e3o o nome da ferramenta. Se voc\u00ea est\u00e1 nessa situa\u00e7\u00e3o, o artigo <a href=\"https:\/\/vectalk.com.br\/blog\/migrar-para-api-oficial-do-whatsapp\/\">Como migrar de uma API n\u00e3o oficial para a API oficial do WhatsApp<\/a> traz o passo a passo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Requisitos para usar a API oficial<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Portf\u00f3lio empresarial na Meta<\/h3>\n\n\n\n<p>Todo uso da plataforma parte de um portf\u00f3lio empresarial. \u00c9 nele que ficam a conta de mensagens, os n\u00fameros, os usu\u00e1rios do sistema e a forma de pagamento.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Verifica\u00e7\u00e3o da empresa<\/h3>\n\n\n\n<p>A verifica\u00e7\u00e3o n\u00e3o \u00e9 obrigat\u00f3ria para dar os primeiros passos, mas muda o que voc\u00ea consegue fazer. Segundo a <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/messaging-limits\">documenta\u00e7\u00e3o de limites de mensagens da Meta<\/a>, portf\u00f3lios novos come\u00e7am com limite de 250 destinat\u00e1rios \u00fanicos por 24 horas fora da janela de atendimento. Verificar a empresa \u00e9 um dos caminhos para subir para 2.000. O limite de n\u00fameros registrados tamb\u00e9m depende disso: portf\u00f3lios novos podem registrar dois n\u00fameros, e o teto sobe para 20 quando a empresa \u00e9 verificada ou chega ao limite de 2.000 mensagens.<\/p>\n\n\n\n<p>No fluxo da Vectalk, o <a href=\"https:\/\/docs.vectalk.com.br\/quickstart\">guia r\u00e1pido<\/a> pede uma conta Meta Business verificada para conectar o n\u00famero. Por isso, trate a verifica\u00e7\u00e3o como parte do projeto, n\u00e3o como etapa opcional.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">N\u00famero de telefone<\/h3>\n\n\n\n<p>Pela <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/phone-numbers\">documenta\u00e7\u00e3o de n\u00fameros da Cloud API<\/a>, o n\u00famero precisa:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>pertencer \u00e0 sua empresa;<\/li>\n\n\n<li>ter c\u00f3digo de pa\u00eds e de \u00e1rea (c\u00f3digos curtos n\u00e3o s\u00e3o aceitos);<\/li>\n\n\n<li>conseguir receber SMS ou liga\u00e7\u00e3o de voz para o c\u00f3digo de verifica\u00e7\u00e3o.<\/li>\n\n<\/ul>\n\n\n\n<p>Um ponto que pega muita gente: n\u00fameros que j\u00e1 est\u00e3o em uso no WhatsApp n\u00e3o podem ser registrados na Cloud API sem antes serem exclu\u00eddos do aplicativo. A exce\u00e7\u00e3o \u00e9 o n\u00famero do <strong>app WhatsApp Business<\/strong>, que pode ser conectado \u00e0 API mantendo o app em uso, no recurso conhecido como coexist\u00eancia. Explicamos requisitos e limita\u00e7\u00f5es em <a href=\"https:\/\/vectalk.com.br\/blog\/coexistencia-whatsapp-api\/\">Coexist\u00eancia no WhatsApp<\/a>.<\/p>\n\n\n\n<p>Voc\u00ea tamb\u00e9m vai precisar de um nome de exibi\u00e7\u00e3o, que a Meta analisa antes de liberar.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Forma de pagamento<\/h3>\n\n\n\n<p>Desde 1\u00ba de outubro de 2026, a Meta voltou a cobrar mensagens de servi\u00e7o depois de uma franquia mensal gratuita por n\u00famero. A <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/pricing\">p\u00e1gina de pre\u00e7os<\/a> avisa que contas sem forma de pagamento deixam de ter mensagens de servi\u00e7o entregues ap\u00f3s o uso dessa franquia. Na pr\u00e1tica, toda opera\u00e7\u00e3o em produ\u00e7\u00e3o precisa de um meio de pagamento ativo na conta de mensagens.<\/p>\n\n\n\n<p>Na Vectalk, essa etapa fica com a gente: o cliente paga a Vectalk, e a Vectalk paga a Meta pelas mensagens. Voc\u00ea n\u00e3o precisa cadastrar cart\u00e3o nem linha de cr\u00e9dito na Meta.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Consentimento (opt-in) dos contatos<\/h3>\n\n\n\n<p>A <a href=\"https:\/\/business.whatsapp.com\/policy\">Pol\u00edtica de Mensagens Comerciais do WhatsApp<\/a> s\u00f3 permite contatar quem forneceu o n\u00famero e deu permiss\u00e3o para receber mensagens. Pedidos para parar de receber precisam ser respeitados, inclusive quando feitos fora do WhatsApp. Isso vale para qualquer integra\u00e7\u00e3o oficial e \u00e9 um dos fatores que mais pesam na qualidade do n\u00famero.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Limites que voc\u00ea precisa conhecer<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Limite<\/th><th>Valor padr\u00e3o<\/th><th>Observa\u00e7\u00e3o<\/th><\/tr><\/thead><tbody><tr><td>Limite de mensagens (fora da janela)<\/td><td>250 destinat\u00e1rios \u00fanicos \/ 24 h em portf\u00f3lios novos<\/td><td>Sobe para 2.000, 10.000, 100.000 e ilimitado, conforme verifica\u00e7\u00e3o, volume e qualidade. Vale para o portf\u00f3lio inteiro.<\/td><\/tr><tr><td>N\u00fameros registrados por portf\u00f3lio<\/td><td>2 inicialmente<\/td><td>Passa a 20 com verifica\u00e7\u00e3o ou ao atingir o limite de 2.000<\/td><\/tr><tr><td>Taxa de envio (throughput)<\/td><td>At\u00e9 80 mensagens por segundo por n\u00famero<\/td><td>Pode ser ampliada; n\u00fameros em coexist\u00eancia ficam em 20 mps<\/td><\/tr><tr><td>Janela de atendimento<\/td><td>24 horas a partir da \u00faltima mensagem do cliente<\/td><td>Fora dela, s\u00f3 templates<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fontes: <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/messaging-limits\">limites de mensagens<\/a>, <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/overview\">vis\u00e3o geral da Cloud API<\/a> e <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/phone-numbers\">n\u00fameros de telefone<\/a>.<\/p>\n\n\n\n<p>Um detalhe importante: o limite de mensagens \u00e9 do portf\u00f3lio, n\u00e3o do n\u00famero. Se voc\u00ea tem tr\u00eas n\u00fameros no mesmo portf\u00f3lio, um deles pode consumir toda a capacidade do dia.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Como a conversa funciona: janela de 24 horas e templates<\/h2>\n\n\n\n<p>A regra central da API oficial \u00e9 simples. Quando o cliente manda uma mensagem, abre-se uma janela de atendimento de 24 horas. Dentro dela, voc\u00ea responde com qualquer tipo de mensagem: texto, imagem, bot\u00f5es, listas. Cada nova mensagem do cliente reinicia o contador.<\/p>\n\n\n\n<p>Fora da janela, s\u00f3 \u00e9 poss\u00edvel enviar templates. Eles s\u00e3o criados com categoria (marketing, utilidade ou autentica\u00e7\u00e3o), passam por aprova\u00e7\u00e3o da Meta e aceitam vari\u00e1veis. Um template de confirma\u00e7\u00e3o de pedido, por exemplo:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-json\">{\n  \"messaging_product\": \"whatsapp\",\n  \"to\": \"5584999999999\",\n  \"type\": \"template\",\n  \"template\": {\n    \"name\": \"order_confirmation\",\n    \"language\": { \"code\": \"pt_BR\" },\n    \"components\": [\n      {\n        \"type\": \"body\",\n        \"parameters\": [\n          { \"type\": \"text\", \"text\": \"Maria\" },\n          { \"type\": \"text\", \"text\": \"#12345\" }\n        ]\n      }\n    ]\n  }\n}<\/code><\/pre>\n\n\n\n<p>Esse \u00e9 o mesmo payload aceito pela Meta e pela Vectalk. A categoria do template tamb\u00e9m define o pre\u00e7o da mensagem, assunto que detalhamos em <a href=\"https:\/\/vectalk.com.br\/blog\/api-whatsapp-preco-brasil\/\">Quanto custa a API do WhatsApp no Brasil em 2026<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">BSP, Provedor de Tecnologia ou Cloud API direta<\/h2>\n\n\n\n<p>H\u00e1 tr\u00eas jeitos de chegar \u00e0 Cloud API. A diferen\u00e7a est\u00e1 em quem cuida do app na Meta, dos tokens, dos webhooks e da cobran\u00e7a.<\/p>\n\n\n\n<p><strong>Integra\u00e7\u00e3o direta.<\/strong> Voc\u00ea cria um app no painel da Meta, gera um token de usu\u00e1rio do sistema, configura o webhook com verifica\u00e7\u00e3o e assinatura, assina os campos da conta de mensagens e cuida da rota\u00e7\u00e3o de credenciais. N\u00e3o h\u00e1 intermedi\u00e1rio, mas toda a opera\u00e7\u00e3o fica com o seu time.<\/p>\n\n\n\n<p><strong>Parceiros da Meta.<\/strong> A <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/solution-providers\">documenta\u00e7\u00e3o para parceiros<\/a> divide os intermedi\u00e1rios em tr\u00eas tipos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>Parceiros de Solu\u00e7\u00f5es<\/strong> (o que o mercado chama de BSP): s\u00e3o Parceiros de Neg\u00f3cios da Meta, podem estender linha de cr\u00e9dito aos clientes e cobrar deles diretamente pelo uso da plataforma.<\/li>\n\n\n<li><strong>Provedores de Tecnologia<\/strong>: oferecem servi\u00e7os sobre a plataforma, mas sem linha de cr\u00e9dito. O cliente cadastra a pr\u00f3pria forma de pagamento e a Meta cobra o uso da API diretamente dele.<\/li>\n\n\n<li><strong>Parceiros de Tecnologia<\/strong>: Provedores de Tecnologia que tamb\u00e9m foram aprovados como Parceiros de Neg\u00f3cios da Meta.<\/li>\n\n<\/ul>\n\n\n\n<p><strong>Proxy gerenciado.<\/strong> \u00c9 o modelo da Vectalk (nos docs, o produto aparece como Vectax Hub). Sua aplica\u00e7\u00e3o fala com a Vectalk, que repassa as chamadas para a Cloud API. Os payloads s\u00e3o os mesmos da Meta; mudam apenas a URL base e o token:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><\/th><th>Cloud API direta<\/th><th>Vectalk<\/th><\/tr><\/thead><tbody><tr><td>URL base<\/td><td><code>https:\/\/graph.facebook.com\/vXX.X<\/code><\/td><td><code>https:\/\/apis.vectalk.com.br\/api<\/code><\/td><\/tr><tr><td>Token<\/td><td>Token de acesso da Meta (usu\u00e1rio do sistema)<\/td><td>Token gerado na Vectalk<\/td><\/tr><tr><td>Payloads<\/td><td>Formato da Meta<\/td><td>Igual ao da Meta<\/td><\/tr><tr><td>V\u00e1rias contas<\/td><td>Um token e um <code>phone_number_id<\/code> por contexto<\/td><td>Um token de organiza\u00e7\u00e3o para todas as inst\u00e2ncias, enviando o <code>phone_number_id<\/code><\/td><\/tr><tr><td>Webhooks<\/td><td>Um endpoint por app, configurado no painel da Meta<\/td><td>V\u00e1rias URLs por inst\u00e2ncia, registradas via API<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Na Vectalk, o envio de uma mensagem de texto fica assim:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl -X POST https:\/\/apis.vectalk.com.br\/api\/messages \\\n  -H \"Authorization: Bearer SEU_TOKEN\" \\\n  -H \"Content-Type: application\/json\" \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"to\": \"5584999999999\",\n    \"type\": \"text\",\n    \"text\": { \"body\": \"Seu pedido saiu para entrega.\" }\n  }'<\/code><\/pre>\n\n\n\n<p>Se voc\u00ea j\u00e1 tem c\u00f3digo escrito para a Cloud API, a migra\u00e7\u00e3o para o proxy \u00e9 trocar duas vari\u00e1veis de ambiente. Os detalhes de token de organiza\u00e7\u00e3o e de inst\u00e2ncia est\u00e3o na p\u00e1gina de <a href=\"https:\/\/docs.vectalk.com.br\/authentication\">autentica\u00e7\u00e3o<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Custos em linhas gerais<\/h2>\n\n\n\n<p>Desde 1\u00ba de julho de 2025, a Meta cobra <strong>por mensagem entregue<\/strong>, com pre\u00e7o definido pela categoria da mensagem e pelo pa\u00eds do destinat\u00e1rio. As categorias s\u00e3o marketing, utilidade, autentica\u00e7\u00e3o e servi\u00e7o, e desde julho de 2026 existe tamb\u00e9m a categoria Meta Business Agent, para respostas geradas pela plataforma de IA da pr\u00f3pria Meta. Algumas mensagens n\u00e3o s\u00e3o cobradas, como as enviadas dentro da janela de ponto de entrada gratuito aberta por an\u00fancios de clique para o WhatsApp e as primeiras 1.000 mensagens de servi\u00e7o do m\u00eas, por n\u00famero.<\/p>\n\n\n\n<p>Para o Brasil, a tabela oficial \u00e9 publicada em reais e as contas em BRL s\u00e3o faturadas pelo Facebook Brasil. Valores, faixas de volume e mudan\u00e7as de outubro de 2026 est\u00e3o em <a href=\"https:\/\/vectalk.com.br\/blog\/api-whatsapp-preco-brasil\/\">Quanto custa a API do WhatsApp no Brasil em 2026<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Quando a API oficial faz sentido<\/h2>\n\n\n\n<p>Ela compensa quando o WhatsApp \u00e9 parte do produto ou da opera\u00e7\u00e3o, e n\u00e3o um canal secund\u00e1rio:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>Sistemas que precisam notificar clientes<\/strong>: confirma\u00e7\u00e3o de pedido, lembrete de consulta, segunda via de boleto, c\u00f3digo de verifica\u00e7\u00e3o.<\/li>\n\n\n<li><strong>Atendimento com v\u00e1rias pessoas ou com IA<\/strong>: um n\u00famero, v\u00e1rios atendentes ou um agente respondendo, com hist\u00f3rico no seu sistema.<\/li>\n\n\n<li><strong>SaaS que oferece WhatsApp aos pr\u00f3prios clientes<\/strong>: CRMs, ERPs, plataformas de agendamento e de e-commerce que precisam conectar n\u00fameros de terceiros com seguran\u00e7a.<\/li>\n\n\n<li><strong>Opera\u00e7\u00f5es que n\u00e3o podem parar<\/strong>: qualquer fluxo em que um banimento de n\u00famero custa caro.<\/li>\n\n<\/ul>\n\n\n\n<p>E faz menos sentido em alguns casos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li>quando o uso \u00e9 s\u00f3 conversa manual, com poucas mensagens por dia, e o app WhatsApp Business resolve;<\/li>\n\n\n<li>quando o plano depende de mandar mensagens para listas sem consentimento, o que a pol\u00edtica n\u00e3o permite em nenhuma API oficial;<\/li>\n\n\n<li>quando o fluxo depende de recursos que a Cloud API n\u00e3o cobre ou cobre com limites. A API de Grupos, por exemplo, exige conta comercial oficial e aceita no m\u00e1ximo 8 participantes por grupo, segundo a <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/groups\">documenta\u00e7\u00e3o de grupos<\/a>.<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Primeiros passos com a Vectalk<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li>Crie sua conta em <a href=\"https:\/\/apps.vectalk.com.br\/register\">apps.vectalk.com.br\/register<\/a>. Uma organiza\u00e7\u00e3o \u00e9 criada automaticamente.<\/li>\n\n\n<li>Em <strong>Inst\u00e2ncias<\/strong>, clique em <strong>Conectar conta<\/strong> e conclua o Cadastro Incorporado (Embedded Signup) da Meta. A Vectalk importa <code>phone_number_id<\/code>, <code>waba_id<\/code> e o token de acesso.<\/li>\n\n\n<li>Em <strong>Configura\u00e7\u00f5es \u2192 API Tokens<\/strong>, gere um token de organiza\u00e7\u00e3o ou de inst\u00e2ncia. Ele aparece uma \u00fanica vez.<\/li>\n\n\n<li>Envie a primeira mensagem com <code>POST \/api\/messages<\/code> e registre um webhook com <code>POST \/api\/webhooks<\/code>.<\/li>\n\n<\/ol>\n\n\n\n<p>O passo a passo completo est\u00e1 no <a href=\"https:\/\/docs.vectalk.com.br\/quickstart\">guia r\u00e1pido da documenta\u00e7\u00e3o<\/a>. Para d\u00favidas de conta e cobran\u00e7a, consulte a <a href=\"https:\/\/vectalk.com.br\/ajuda.html\">Central de Ajuda<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Perguntas frequentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">A API oficial do WhatsApp \u00e9 gratuita?<\/h3>\n\n\n\n<p>N\u00e3o. A Meta cobra por mensagem entregue, conforme categoria e pa\u00eds do destinat\u00e1rio. H\u00e1 situa\u00e7\u00f5es sem cobran\u00e7a, como a franquia de 1.000 mensagens de servi\u00e7o por m\u00eas por n\u00famero e as mensagens dentro da janela de ponto de entrada gratuito. O intermedi\u00e1rio que voc\u00ea escolher pode cobrar \u00e0 parte pelo servi\u00e7o dele.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Preciso de CNPJ para usar a API oficial?<\/h3>\n\n\n\n<p>A Meta exige um portf\u00f3lio empresarial, e a verifica\u00e7\u00e3o da empresa pede documenta\u00e7\u00e3o da organiza\u00e7\u00e3o. Os documentos aceitos no Brasil variam; consulte a central de ajuda da Meta para o processo de verifica\u00e7\u00e3o.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Posso usar o mesmo n\u00famero que j\u00e1 uso no celular?<\/h3>\n\n\n\n<p>Se o n\u00famero est\u00e1 no app WhatsApp Business, \u00e9 poss\u00edvel conect\u00e1-lo \u00e0 API sem sair do app, pela coexist\u00eancia. Se est\u00e1 no WhatsApp comum (Messenger), \u00e9 preciso excluir a conta do app antes de registrar o n\u00famero na Cloud API.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Qual \u00e9 a diferen\u00e7a entre a API oficial e o app WhatsApp Business?<\/h3>\n\n\n\n<p>O app \u00e9 feito para uso manual em celular e computador. A API \u00e9 para sistemas: envio program\u00e1tico, webhooks, v\u00e1rios atendentes, integra\u00e7\u00f5es e automa\u00e7\u00e3o. A API tem regras de template e janela de 24 horas que o app n\u00e3o tem.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Quanto tempo leva para colocar no ar?<\/h3>\n\n\n\n<p>O tempo t\u00e9cnico de integra\u00e7\u00e3o costuma ser curto quando o time j\u00e1 conhece APIs REST. O que costuma demorar \u00e9 a parte do lado da Meta: verifica\u00e7\u00e3o da empresa, aprova\u00e7\u00e3o do nome de exibi\u00e7\u00e3o e dos templates. Planeje essas etapas com anteced\u00eancia.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Fontes oficiais consultadas em 25\/10\/2026:<\/strong> <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/pricing\">Pre\u00e7os da plataforma do WhatsApp Business<\/a> (atualizada em 30\/09\/2026), <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/messaging-limits\">Limites de mensagens<\/a> (atualizada em 21\/05\/2026), <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/cloud-api\/phone-numbers\">N\u00fameros de telefone comerciais<\/a>, <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/solution-providers\">Parceiros da plataforma<\/a>, <a href=\"https:\/\/www.whatsapp.com\/legal\/terms-of-service\">Termos de Servi\u00e7o do WhatsApp<\/a>, <a href=\"https:\/\/business.whatsapp.com\/policy\">Pol\u00edtica de Mensagens Comerciais<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/account-model-evolution\/\">Atualiza\u00e7\u00f5es nas contas do WhatsApp Business<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[8],"tags":[],"class_list":["post-39","post","type-post","status-publish","format-standard","hentry","category-uncategorized-pt"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk<\/title>\n<meta name=\"description\" content=\"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk\" \/>\n<meta property=\"og:description\" content=\"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-20T19:07:38+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-25T13:16:58+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"13 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"API Oficial do WhatsApp: guia completo (2026)\",\"datePublished\":\"2026-10-20T19:07:38+00:00\",\"dateModified\":\"2026-10-25T13:16:58+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/\"},\"wordCount\":2573,\"commentCount\":0,\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/\",\"name\":\"API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-20T19:07:38+00:00\",\"dateModified\":\"2026-10-25T13:16:58+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/api-oficial-do-whatsapp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Oficial do WhatsApp: guia completo (2026)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk","description":"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/","og_locale":"en_US","og_type":"article","og_title":"API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk","og_description":"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.","og_url":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-20T19:07:38+00:00","article_modified_time":"2026-10-25T13:16:58+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"13 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"API Oficial do WhatsApp: guia completo (2026)","datePublished":"2026-10-20T19:07:38+00:00","dateModified":"2026-10-25T13:16:58+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/"},"wordCount":2573,"commentCount":0,"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/","url":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/","name":"API Oficial do WhatsApp: guia completo (2026) - Blog Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-20T19:07:38+00:00","dateModified":"2026-10-25T13:16:58+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"Entenda a API oficial do WhatsApp: diferen\u00e7a para APIs n\u00e3o oficiais, requisitos, BSP x Cloud API direta, limites, custos e quando ela faz sentido.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"API Oficial do WhatsApp: guia completo (2026)"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/39","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=39"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/39\/revisions"}],"predecessor-version":[{"id":444,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/39\/revisions\/444"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=39"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=39"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=39"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}