Templates

Mensagens pré-aprovadas pela Meta para iniciar ou retomar contato.

24 horas

Janela de conversa livre aberta quando o cliente responde.

Coexistência

Uso do app WhatsApp Business e da API Oficial com regras separadas.

Fluxo da jornada

Quando tem custo e quando não tem

Na API Oficial, o ponto principal é entender quem iniciou a conversa e se a janela de 24 horas está aberta ou fechada. É isso que define se a empresa pode responder livremente ou se precisa usar um template da Meta.

1

Cliente chama primeiro

Quando o cliente envia a primeira mensagem para a empresa, abre a janela de atendimento de 24 horas.

Resultado: a empresa pode responder com mensagem livre pela plataforma. Mensagens comuns dentro dessa janela não têm custo de template.

2

Cliente continua respondendo

Cada nova mensagem do cliente reinicia a contagem da janela de 24 horas.

Resultado: enquanto o cliente continuar interagindo, a conversa segue livre e a empresa não precisa usar template para responder.

3

Cliente para de responder por 24 horas

Se passam 24 horas sem nova mensagem do cliente, a janela fecha.

Resultado: a empresa não pode simplesmente mandar mensagem livre pela API. Para retomar a conversa pelo Bitrix24 / API, precisa enviar um template aprovado pela Meta.

4

Sua empresa chama primeiro ou retoma com janela fechada

Quando sua empresa inicia o contato, ou tenta falar novamente depois que a janela de 24h fechou, o envio pela API precisa ser feito por template.

Quando entra o custo: a Meta pode cobrar quando o template é entregue, conforme categoria e regras vigentes da WhatsApp Business Platform.

Conceitos essenciais

Templates, janela, custo e uso no celular

Templates

São mensagens fixas e pré-aprovadas pela Meta para primeiro contato, retorno, lembrete ou reativação. Fora da janela de 24h, a retomada pela API precisa sair por template.

Janela de 24 horas

É a janela normal de atendimento da Cloud API. Ela abre quando o cliente manda mensagem ou liga, e reinicia sempre que o cliente interage novamente.

Custo

O custo aparece principalmente quando sua empresa envia template para iniciar ou retomar conversa com a janela fechada. Mensagens livres dentro da janela aberta não são template.

Uso no celular

Na Coexistência, mensagens enviadas pelo app WhatsApp Business continuam separadas das regras de janela e cobrança da Cloud API. O Bitrix24 / API segue as regras da janela de 24h e templates.

Coexistência

O mito da restrição no celular

Na Coexistência, o benefício é manter o número conectado à API Oficial sem perder o uso 1:1 no aplicativo WhatsApp Business. A própria Meta informa que mensagens enviadas pelo app continuam gratuitas e não estão sujeitas à janela de atendimento de 24 horas da Cloud API.

Isso significa que as regras operam separadamente:

Pelo aplicativo do celular

O atendimento 1:1 pelo WhatsApp Business pode continuar sendo feito pelo app. Essas mensagens seguem fora da cobrança e da janela da Cloud API e não criam, não estendem e não alteram a precificação da API.

Pelo Bitrix24 / API Oficial

Aqui vale a regra da API: se a última interação do cliente passou de 24 horas, o Bitrix24 / API não deve enviar mensagem livre. Para reabrir a conversa pela API, é necessário usar um template aprovado pela Meta.

O mito da “pontuação que cai para zero”

Não existe uma punição automática que derruba a pontuação do número apenas porque uma mensagem livre foi tentada fora da janela pela API. Nesse caso, a Meta tende a bloquear sistemicamente o envio e retornar erro, como o código 131047, indicando que passaram mais de 24 horas desde a última resposta do destinatário e que deve ser usado um template.

O que realmente prejudica o número é comportamento percebido como indesejado: alto volume de templates rejeitados, denúncias, bloqueios e baixa qualidade de engajamento. Aí sim a classificação de qualidade pode cair e a operação pode sofrer restrições.

Referência oficial da Meta: Coexistência / WhatsApp Business app users.

Atenção importante

O maior risco não é o template. É a operação mal treinada.

Dentro da janela de 24h, mensagens e ligações são permitidas. Fora da janela, a retomada precisa respeitar as regras da Meta. Por isso, treinamento da equipe é essencial para evitar bloqueios, queda de qualidade ou até banimento do número.

Erros comuns na migração

Atenção antes de migrar para a API Oficial

Os erros abaixo são comuns em operações que migram para a API Oficial. Eles seguem regras da própria Meta e não significam falha ou culpa da Php Business. A Php Business orienta, configura e acompanha a operação, mas a entrega final da mensagem obedece às políticas, limites e validações da Meta.

Erro 131026

O que significa: mensagem não entregue.

Por que pode acontecer: o número do destinatário pode não ser WhatsApp, o usuário pode não ter aceitado os termos recentes da Meta / WhatsApp ou pode estar usando uma versão antiga do aplicativo.

Importante para o cliente: mesmo com a API configurada corretamente, a Meta pode impedir a entrega se houver restrição do lado do destinatário.

Erro 131049

O que significa: mensagem não entregue para manter o ecossistema saudável.

Por que pode acontecer: normalmente está ligado a limites e regras de engajamento da Meta, principalmente em mensagens de template / marketing.

Importante para o cliente: não adianta insistir automaticamente. A recomendação é respeitar o limite, revisar abordagem / template e aguardar o período indicado pela regra da Meta.

Saiba mais sobre o erro 131049 na documentação oficial da Meta.

Como a Php Business orienta

Quando bem usada, a API Oficial protege o seu número

Quando bem usada

  • Reduz risco de banimento em comparação ao uso improvisado.
  • Permite atendimento por plataforma, equipe e automações.
  • Ajuda a organizar o WhatsApp com processo e histórico.

Como a Php Business orienta

Antes de ativar, avaliamos o processo do cliente: como atende, como vende, quando precisa de template, onde entra CRM, automação, IA e treinamento da equipe.