Enviar Mensagens de Texto de 24 Horas via API do WhatChimp

Como enviar mensagens de texto dentro da janela de sessão de 24 horas do WhatsApp usando a API do WhatChimp.

Updated 5 February 2026

O WhatsApp permite que empresas enviem respostas de texto livre para clientes — mas apenas dentro de 24 horas da última mensagem do cliente. Isso é chamado de mensagem de sessão ou mensagem de janela de 24 horas. Este guia mostra como enviar mensagens de texto pela API do WhatChimp e explica exatamente como funciona a regra de 24 horas.

Antes de começar: Certifique-se de ter sua API key e phone number ID. Veja Começando com a Developer API do WhatChimp para instruções de configuração.

O Que é a Janela de Sessão de 24 Horas?

Quando um cliente envia uma mensagem para você no WhatsApp, uma sessão de 24 horas abre. Durante esta janela, você pode responder com qualquer mensagem de texto que quiser — não precisa de modelo, não precisa de aprovação.

Uma vez que a janela de 24 horas fecha (o cliente não enviou mensagem para você há mais de 24 horas), você não pode enviar mensagens de texto mais. A API retornará um erro.

Pontos-chave:

O relógio de 24 horas reinicia toda vez que o cliente envia uma mensagem para você
Apenas o cliente pode abrir uma sessão — você não pode abrir uma você mesmo
Mensagens de texto dentro da sessão são parte de uma conversa iniciada pelo cliente (nível de custo mais baixo)
Fora da janela de 24 horas, você deve usar uma mensagem de modelo em vez disso

O console da API mostrando o endpoint Send Message e a explicação de mensagens de texto vs mensagens de modelo

Quando Usar Mensagens de Texto

Mensagens de texto são a escolha certa quando:

Um cliente enviou uma mensagem para você nas últimas 24 horas e você está respondendo a eles
Você está construindo um chatbot que responde a mensagens recebidas
Você está lidando com respostas de Live Chat para consultas de clientes
Você está enviando um acompanhamento rápido enquanto a conversa ainda está ativa

NÃO use mensagens de texto para:

Enviar notificações, lembretes ou atualizações de pedidos — use uma mensagem de modelo
Contatar clientes que não enviaram mensagens para você recentemente
Broadcasting de mensagens promocionais
Enviar OTPs ou códigos de verificação

API Endpoint

Endpoint: GET/POST /api/v1/whatsapp/send

URL completa: https://app.whatchimp.com/api/v1/whatsapp/send

Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
`apiToken`	String	Sim	Sua API key do WhatChimp
`phone_number_id`	String	Sim	Seu WhatsApp phone number ID
`message`	String	Sim	Conteúdo da mensagem de texto (codifique URL para requisições GET)
`phone_number`	String	Sim	Número de telefone do destinatário com código do país, apenas numérico (ex., `919999999999`)

Enviando uma Mensagem de Texto

Requisição GET:

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&message=Olá%2C+obrigado+por+entrar+em+contato!&phone_number=919999999999

Requisição POST (curl):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'message=Olá, obrigado por entrar em contato!' \
  -d 'phone_number=919999999999'

Resposta de Sucesso:

{
  "status": "1",
  "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
  "message": "Message sent successfully."
}

Respostas de Erro

Janela de 24 horas expirada:

Se você tentar enviar uma mensagem de texto fora da janela de sessão, a API retornará um erro. Quando isso acontecer, mude para uma mensagem de modelo.

Limite de assinantes excedido:

{"status": "0", "message": "Subscriber limit has been exceeded. You cannot have more subscribers."}

Isso significa que o limite de assinantes do seu plano WhatChimp foi atingido. Faça upgrade do seu plano ou remova assinantes inativos.

Dicas

Codifique sua mensagem em URL ao usar requisições GET. Espaços se tornam %20 ou +, caracteres especiais precisam de codificação.
Salve o wa_message_id da resposta de sucesso — você pode usá-lo para rastrear o status de entrega depois.
Se sua mensagem falhar, verifique se a janela de 24 horas ainda está aberta. Se não, use uma mensagem de modelo em vez disso.
Para respostas automatizadas (chatbots), mensagens de texto funcionam perfeitamente já que o cliente inicia a conversa.