---
title: "Templates do WhatsApp: criar, aprovar e disparar pela API"
description: "Fora da janela de 24 horas, só template aprovado sai. Como criar e submeter um template pela API, escolher a categoria certa (marketing, utilidade ou autenticação), evitar as recusas mais comuns e disparar para uma lista."
url: "https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Templates do WhatsApp: como criar, aprovar e disparar pela API (e por que a janela de 24h manda em tudo)

Raphael Serafim· Publicado em 10 de setembro de 2026· 10 min de leitura

Compartilhar

# Templates do WhatsApp: como criar, aprovar e disparar pela API (e por que a janela de 24h manda em tudo)

Fora da janela de 24 horas, só template aprovado sai. Como criar e submeter um template pela API, escolher a categoria certa (marketing, utilidade ou autenticação), evitar as recusas mais comuns e disparar para uma lista.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar.md)

**Fora da janela de 24 horas, texto comum não sai.** É a regra que mais confunde quem está integrando a API oficial pela primeira vez: o código está certo, o número existe, e a mensagem simplesmente não chega.

## A janela de 24 horas

Quando alguém te manda mensagem, abre-se uma janela de 24 horas. Dentro dela, você responde livremente — texto, imagem, botão, o que for.

Passadas 24 horas sem que a pessoa escreva de novo, a janela fecha. A partir daí, só um **template aprovado** consegue iniciar a conversa. E, se a pessoa responder ao template, a janela abre de novo.

Duas consequências práticas:

- **Atendimento** raramente precisa de template: o cliente escreveu, você responde.
- **Notificação** quase sempre precisa: [confirmação de pedido e aviso de entrega](https://api-wa.me/blog/notificacoes-pedido-whatsapp-api) ou [lembrete de agendamento](https://api-wa.me/blog/lembretes-agendamento-confirmacao-whatsapp) — tudo isso parte de você, com a janela fechada.

Na [API não oficial](https://api-wa.me/blog/api-nao-oficial-whatsapp) essa regra não existe, porque ela não passa pela infraestrutura da Meta. Em compensação, o limite ali é o comportamento do número — assunto do artigo sobre [não perder o número](https://api-wa.me/blog/whatsapp-api-sem-bloqueio-nao-perder-numero).

## Escolher a categoria certa

Esta é a decisão que mais reprova template, e ela vem antes do texto:

| Categoria | Para quê | Observação |
| --- | --- | --- |
| **Utilidade** | Acompanha algo que o cliente já iniciou: pedido, agendamento, fatura, entrega | Mais barata e mais fácil de aprovar |
| **Autenticação** | Códigos de verificação e login | Formato restrito, sem espaço para marketing |
| **Marketing** | Promoção, novidade, reengajamento, carrinho abandonado | Mais cara e a mais rejeitada |

**A regra que resolve 90% das recusas:** se a mensagem existe porque o cliente fez algo, é utilidade. Se existe porque _você_ quer que ele faça algo, é marketing.

Tentar passar promoção como utilidade não funciona e queima tempo — a Meta reclassifica ou recusa. E reclassificação vale a cobrança da categoria nova, não da que você escolheu.

## Criar o template

```bash
curl -X POST "https://us.api-wa.me/SUA_KEY/template" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pedido_enviado",
    "language": "pt_BR",
    "category": "UTILITY",
    "components": [
      {
        "type": "BODY",
        "text": "Oi {{1}}! Seu pedido {{2}} saiu para entrega e chega até {{3}}.",
        "example": { "body_text": [["Ana", "#1042", "sexta-feira"]] }
      },
      {
        "type": "BUTTONS",
        "buttons": [
          { "type": "URL", "text": "Acompanhar", "url": "https://loja.com/p/{{1}}",
            "example": ["1042"] }
        ]
      }
    ]
  }'
```

Regras que economizam uma rodada de recusa:

**O `name` é técnico.** Minúsculas, números e sublinhado. É por ele que você dispara depois.

**O `example` não é opcional.** A Meta avalia o texto **com as variáveis preenchidas**. Exemplo ruim reprova template bom: `{{1}}` exemplificado como `"xxx"` faz o revisor ler uma frase sem sentido.

**Variável não começa nem termina frase.** `"{{1}}, confirme aqui"` costuma ser recusado. `"Oi {{1}}, confirme aqui"` passa. A razão é que a Meta não consegue avaliar o texto se ele começa com um conteúdo desconhecido.

**Nada de promessa financeira.** "Ganhe R$ 500", "renda garantida" e parentes são recusa quase certa, em qualquer categoria.

**Português correto.** Erro de digitação reprova. O revisor lê.

Pelo [MCP](https://api-wa.me/blog/mcp-agente-ia-whatsapp), a mesma criação sai por conversa — `create_template` é uma das ferramentas expostas, útil quando você está iterando no texto e não quer montar o JSON a cada tentativa.

## Acompanhar a aprovação

```bash
curl "https://us.api-wa.me/SUA_KEY/templates"
```

Estados possíveis: `PENDING`, `APPROVED`, `REJECTED`, `PAUSED`, `DISABLED`.

`PAUSED` merece atenção: acontece quando um template aprovado passa a receber muito bloqueio ou denúncia dos destinatários. A Meta pausa sozinha. Ou seja, aprovação não é permanente — ela depende de como as pessoas reagem ao que você manda.

## Disparar

```bash
curl -X POST "https://us.api-wa.me/SUA_KEY/message/template" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5566996852025",
    "name": "pedido_enviado",
    "language": "pt_BR",
    "components": [{
      "type": "body",
      "parameters": [
        { "type": "text", "text": "Ana" },
        { "type": "text", "text": "#1042" },
        { "type": "text", "text": "sexta-feira" }
      ]
    }]
  }'
```

A ordem dos `parameters` é a ordem de `{{1}}`, `{{2}}`, `{{3}}`. Trocar duas posições não dá erro — só manda a mensagem errada, o que é pior.

## Disparar para uma lista

Aqui começa o território do envio em massa, e há três coisas que precisam existir antes:

**1\. Opt-in real.** Template aprovado não é permissão para mandar a quem não pediu. Bloqueio e denúncia derrubam a qualidade do número e pausam o template. Ver [opt-in, higienização e opt-out](https://api-wa.me/blog/lista-contatos-optin-optout-whatsapp).

**2\. Ritmo e fila.** Disparar 5.000 mensagens num laço `for` é a forma mais rápida de tomar rate limit e perder metade sem saber quais. Ver [fila, rate limit e retry](https://api-wa.me/blog/fila-rate-limit-retry-disparo-whatsapp).

**3\. Medição.** Enviado não é entregue, e entregue não é lido. Ver [métricas de campanha](https://api-wa.me/blog/metricas-campanha-whatsapp-api).

Um envio para lista, no mínimo aceitável:

```js
for (const contato of lista) {
  await fila.add('template', {
    to: contato.numero,
    name: 'pedido_enviado',
    params: [contato.nome, contato.pedido, contato.prazo],
  }, {
    jobId: `pedido_enviado:${contato.pedido}`,   // idempotência
  });
}
```

Note que nada é enviado aqui — tudo é enfileirado. Quem envia é o worker, no ritmo que ele controla.

## O custo

Na API oficial, a Meta cobra **por conversa iniciada**, e o preço muda por categoria. Marketing custa mais que utilidade; autenticação tem tabela própria. Uma janela aberta comporta várias mensagens sem cobrança nova.

Consequência que quase ninguém aproveita: se o cliente responde ao template, a janela abre, e todo o atendimento seguinte não gera cobrança nova. Template com botão de resposta rápida costuma sair mais barato no total do que uma sequência de templates. Os valores da tabela estão em [quanto custa a API oficial](https://api-wa.me/blog/quanto-custa-api-whatsapp-precos-meta).

## Conclusão

Template não é burocracia gratuita — é o mecanismo que mantém o WhatsApp utilizável e o seu número saudável. Quem trata a categoria com honestidade, capricha no exemplo e mede o resultado tem template aprovado rápido e mantido aprovado.

Quem tenta passar marketing como utilidade descobre a regra do jeito caro: template pausado, qualidade do número derrubada e campanha parada no meio.

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

O que é a janela de 24 horas do WhatsApp?+

É o período em que você pode conversar livremente com alguém depois que essa pessoa te enviou uma mensagem. Dentro da janela, texto normal funciona. Passadas 24 horas sem nova mensagem dela, só um template previamente aprovado pela Meta consegue iniciar o contato.

Qual a diferença entre template de marketing, utilidade e autenticação?+

Utilidade acompanha uma transação que o cliente já iniciou: confirmação de pedido, aviso de entrega, fatura. Autenticação entrega códigos de verificação. Marketing é promoção, novidade e reengajamento. A categoria muda o preço cobrado pela Meta e o rigor da aprovação — marketing é a mais cara e a mais rejeitada.

Quanto tempo leva para aprovar um template?+

Normalmente de alguns minutos a algumas horas. A recusa costuma ser mais rápida que a aprovação. Se o template ficar muito tempo pendente, quase sempre há algo na categoria ou no conteúdo pedindo revisão manual.

Por que meu template foi rejeitado?+

As causas mais comuns são: conteúdo de marketing submetido como utilidade, variável no começo ou no fim do texto sem contexto, texto que promete ganho financeiro, erro de português e placeholder de exemplo faltando. A Meta avalia o texto com as variáveis preenchidas pelo exemplo que você enviou — exemplo ruim reprova template bom.

Preciso de template na API não oficial?+

Não. A exigência de template e a janela de 24 horas são regras da API oficial da Meta. Na API não oficial, via QR Code, não há esse controle — o que traz outra responsabilidade, porque o limite passa a ser o comportamento do número e o risco de bloqueio.

## Continue lendo

[### Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.](https://api-wa.me/blog/chatbot-ia-openai-whatsapp)[### Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.](https://api-wa.me/blog/cobrar-pix-whatsapp-api)[### Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.](https://api-wa.me/blog/erros-api-whatsapp-como-tratar)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Templates do WhatsApp: como criar, aprovar e disparar pela API (e por que a janela de 24h manda em tudo)",
  "description": "Fora da janela de 24 horas, só template aprovado sai. Como criar e submeter um template pela API, escolher a categoria certa (marketing, utilidade ou autenticação), evitar as recusas mais comuns e disparar para uma lista.",
  "image": "https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar/opengraph-image",
  "datePublished": "2026-09-10",
  "dateModified": "2026-09-10",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar"
  },
  "keywords": "template whatsapp api, hsm whatsapp, modelo de mensagem whatsapp, janela 24 horas whatsapp, template whatsapp aprovação, disparo template whatsapp, categoria template whatsapp",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Templates do WhatsApp: como criar, aprovar e disparar pela API (e por que a janela de 24h manda em tudo)",
      "item": "https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "O que é a janela de 24 horas do WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "É o período em que você pode conversar livremente com alguém depois que essa pessoa te enviou uma mensagem. Dentro da janela, texto normal funciona. Passadas 24 horas sem nova mensagem dela, só um template previamente aprovado pela Meta consegue iniciar o contato."
      }
    },
    {
      "@type": "Question",
      "name": "Qual a diferença entre template de marketing, utilidade e autenticação?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Utilidade acompanha uma transação que o cliente já iniciou: confirmação de pedido, aviso de entrega, fatura. Autenticação entrega códigos de verificação. Marketing é promoção, novidade e reengajamento. A categoria muda o preço cobrado pela Meta e o rigor da aprovação — marketing é a mais cara e a mais rejeitada."
      }
    },
    {
      "@type": "Question",
      "name": "Quanto tempo leva para aprovar um template?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Normalmente de alguns minutos a algumas horas. A recusa costuma ser mais rápida que a aprovação. Se o template ficar muito tempo pendente, quase sempre há algo na categoria ou no conteúdo pedindo revisão manual."
      }
    },
    {
      "@type": "Question",
      "name": "Por que meu template foi rejeitado?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "As causas mais comuns são: conteúdo de marketing submetido como utilidade, variável no começo ou no fim do texto sem contexto, texto que promete ganho financeiro, erro de português e placeholder de exemplo faltando. A Meta avalia o texto com as variáveis preenchidas pelo exemplo que você enviou — exemplo ruim reprova template bom."
      }
    },
    {
      "@type": "Question",
      "name": "Preciso de template na API não oficial?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Não. A exigência de template e a janela de 24 horas são regras da API oficial da Meta. Na API não oficial, via QR Code, não há esse controle — o que traz outra responsabilidade, porque o limite passa a ser o comportamento do número e o risco de bloqueio."
      }
    }
  ]
}
```