Pular para o conteúdo principal
GET
Listar biblioteca de templates

Conceituação

A Meta mantém uma biblioteca de templates prontos para casos de uso comuns — confirmação de pedido, aviso de entrega, código de verificação. Templates criados a partir dela não passam por revisão: já nascem aprovados. Este endpoint lista o que está disponível para o seu WABA.
A biblioteca é definida pela Meta e varia por categoria e idioma. Você não pode adicionar templates a ela.
Para criar um template comum, que passa por revisão, use Referência da API.

Como descobrir quais modelos existem

A lista é da Meta e muda com o tempo, então ela se consulta, não se decora. O endpoint acima devolve os modelos disponíveis para o seu WABA, e cada um vem com o tema e o caso de uso dele.
Na Graph API da Meta, a busca (GET /message_template_library) aceita os filtros topic, usecase, industry e language, mais search e name. A nossa rota hoje não repassa esses filtros: ela devolve a lista, e a filtragem é sua. Os valores abaixo servem para você reconhecer o tema e o caso de uso de cada modelo que vier na resposta.

Temas e casos de uso

Os casos de uso que a Meta publica, por tema: O nome do modelo costuma terminar em número, como delivery_update_1 ou low_balance_warning_1: é ele que vai em library_template_name.

Criar a partir de um modelo

A criação usa o mesmo endpoint de Referência da API, mas o corpo é outro: em vez de components, vão o nome do modelo e as entradas que ele aceita.
O texto do corpo é da Meta: você não escreve a mensagem, só liga ou desliga as frases que o modelo oferece (add_contact_number, add_learn_more_link, add_security_recommendation, add_track_package_link) e informa os dados dos botões que ele pede.
Modelo usado como está já nasce aprovado. A doc da Meta diz que personalizar muda isso: “If you choose Customize template, your template will have to go through review before you are able to send messages.” Se você mudar o conteúdo, ele volta para a fila normal de revisão.

Autorizações

Authorization
string
header
obrigatório

Secret Key gerada no painel de Segurança do Omni Z-API

Parâmetros de caminho

wabaId
string
obrigatório

ID do WABA (obtido via Listar WABAs)

Exemplo:

"428083093730937"

Resposta

Templates da biblioteca

data
object[]