Pular para o conteúdo principal

Como consultar templates e identificar recategorização via API

  • Atualizado

Índice

  1. Introdução
  2. O que você pode consultar
  3. Endpoint da API
  4. Principais campos da resposta
  5. Como identificar templates recategorizados
  6. Relação com o Portal Blip
  7. Boas práticas

Introdução

Com a evolução das políticas da Meta, é comum que templates de mensagens passem por recategorização automática (por exemplo, de Utility para Marketing).

Pensando nisso, a Blip disponibiliza uma forma de consultar essas informações via API, permitindo que você tenha mais controle e visibilidade — semelhante ao que já é exibido no Portal.

 

O que você pode consultar

Através da API, é possível obter:

  • Categoria atual do template (category)

  • Categoria anterior (previous_category)

  • Status do template (ex: APPROVED)

  • Idioma

  • Conteúdo da mensagem

  • Indicação se o template foi recategorizado

Regras importantes: 

  • Se o campo previous_category estiver preenchido, significa que o template foi recategorizado.

  • Para otimizar a consulta, é possível filtrar pelo nome do template, informando o parâmetro templateName, substituindo no exemplo a variável TEMPLATE_NAME na consulta. Este parâmetro é opcional e representa o nome do template que você deseja buscar.

     

Endpoint da API

Request:

{
  "id": "{{$guid}}",
  "to": "postmaster@wa.gw.msging.net",
  "method": "get",
  "uri": "/message-templates-enriched?templateName={TEMPLATE_NAME}"
}

 

Principais campos da resposta

A resposta da API retornará uma lista de templates com diversas informações. Abaixo estão os campos mais relevantes para análise de recategorização:

Campo Descrição
category Categoria atual do template (ex: MARKETING, UTILITY)
previous_category Categoria anterior antes da recategorização
status Status do template (ex: APPROVED)
language Idioma do template
components Conteúdo da mensagem (body, variáveis, etc.)

Exemplo de resposta:

{
  "id": "2840164927483649",
  "category": "MARKETING",
  "components": [
    {
      "type": "BODY",
      "text": "Olá, {{1}}! ..."
    }
  ]
  "language": "pt_BR",
  "last_updated_time": "2026-03-20T20:25:51.000Z",
  "name”: “eventos_conversas”,
  “rejected_reason”: “NONE”,
  "status": "APPROVED",
  "previous_category": "UTILITY",
}

 

Como identificar templates recategorizados

Para identificar se um template foi recategorizado:

  • Verifique se o campo previous_category existe e está preenchido

  • Compare com o campo category

Exemplo:

category previous_category Interpretação
MARKETING UTILITY Template foi recategorizado
MARKETING null Template não foi recategorizado

 

Relação com o Portal Blip

No Portal, essa informação aparece na listagem de templates:

  • Campo “Recategorized” = Yes → previous_category preenchido

  • Campo “Recategorized” = No → previous_category vazio

Ou seja, a API replica exatamente a mesma lógica exibida na interface.

 

Boas práticas

  • Monitore templates recategorizados para evitar impactos em custo e entrega;

  • Revise conteúdos que possam estar sendo interpretados como marketing;

  • Crie alertas internos baseados no campo previous_category;

  • Utilize essa consulta para auditorias e governança de templates.

 

Importante! 

Atualmente a Blip notifica, via e-mail, todos os usuários administradores dos bots, que estão vinculados a Waba do template, sempre que ocorre uma alteração na categoria dos templates. Saiba mais aqui.
 

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃
 

Artigos relacionados