Enviando Mensagens do WhatsApp via API do WhatChimp — Mensagens de Texto vs Mensagens de Modelo
O erro de API mais comum explicado: quando usar mensagens de texto vs mensagens de modelo, como funciona a janela de 24 horas e como enviar mensagens de modelo com variáveis.
Updated 5 February 2026
A API do WhatChimp permite enviar dois tipos de mensagens do WhatsApp: mensagens de texto (mensagens de sessão) e mensagens de modelo. Usar o tipo errado é a razão mais comum pela qual as mensagens da API falham — este guia explica a diferença.
O Erro #1: Enviar Notificações como Mensagens de Texto
A maioria dos desenvolvedores começa com o endpoint Send Message, consegue fazê-lo funcionar em testes e então tenta usá-lo para enviar notificações ou acompanhamentos. Isso falhará.
O WhatsApp impõe uma janela de sessão de 24 horas. Você só pode enviar mensagens de texto dentro de 24 horas da última mensagem do cliente. Depois disso, a API retorna um erro.
Se você quer enviar notificações, lembretes, atualizações de pedidos ou OTPs — você deve usar uma mensagem de modelo.
Mensagens de Texto vs Mensagens de Modelo
| Mensagem de Texto (Sessão) | Mensagem de Modelo | |
|---|---|---|
| Quando você pode enviá-la? | Apenas dentro de 24 horas da última mensagem do cliente | A qualquer momento — sem restrição de tempo |
| Conteúdo | Qualquer texto que você quiser | Deve usar um modelo pré-aprovado |
| Caso de uso | Responder consultas de clientes | Notificações, lembretes, atualizações, OTPs |
| Precisa de aprovação? | Não | Sim — modelos devem ser aprovados pela Meta |
| API endpoint | POST /api/v1/whatsapp/send | POST /api/v1/whatsapp/send (mesmo endpoint, parâmetros diferentes) |
| Custo | Parte da conversa iniciada pelo cliente | Conversa iniciada pelo negócio (nível de preço diferente) |
Guia de Decisão Rápido
Você precisa enviar uma mensagem?
│
├── O cliente está conversando com você atualmente (dentro de 24 horas)?
│ ├── SIM → Use Mensagem de Texto (mensagem de sessão)
│ └── NÃO → Use Mensagem de Modelo
│
├── Você está enviando uma notificação, lembrete ou atualização?
│ └── Sempre use Mensagem de Modelo
│
├── Você está enviando um OTP ou código de verificação?
│ └── Use Mensagem de Modelo (tipo Authentication)
│
└── Você não tem certeza?
└── Use Mensagem de Modelo (sempre funciona)Guias Detalhados
Video: https://www.youtube.com/watch?v=czd3S5cBHvY
Cada tipo de mensagem tem seu próprio guia detalhado com referência completa da API, exemplos de código e capturas de tela:
- Enviar Mensagens de Texto de 24 Horas via API do WhatChimp — Como funciona a janela de sessão, parâmetros da API, exemplos curl e tratamento de erros
- Enviar Mensagens de Modelo via API do WhatChimp — Como criar modelos, usar o Template Message Generator, enviar com variáveis e solucionar erros
Artigos Relacionados
- Começando com a Developer API do WhatChimp — Configuração da API, autenticação e início rápido
- Criando um Message Template do WhatsApp no WhatChimp — Guia passo a passo de criação de modelo
- WhatChimp Messaging API — Referência completa da API de mensagens (todos os endpoints)