Skip to main content
GET
Consultar um modelo

Authorizations

​
Authorization
string
header
required

Sua credencial de API no cabeçalho Authorization: Bearer sk_live_.... Crie e revogue credenciais no painel, em Conta → API Keys. O segredo aparece uma única vez, na criação.

A credencial identifica a organização: organization_id não é aceito em nenhuma requisição.

Path Parameters

​
id
string
required

O identificador do modelo. Não acrescente ?organization_id=, que é recusado com 400 ORGANIZATION_ID_FORBIDDEN: a credencial já diz a organização.

Pattern: ^PBD_TPL_[0-9A-HJKMNP-TV-Z]{26}$
Example:

"PBD_TPL_01J9Z2Q8XK3M7WPTV6RB4CYH0N"

Response

O modelo.

​
template_id
string
​
organization_id
string | null
​
name
string
​
channel
enum<string>
Available options:
whatsapp,
email
​
body
string
​
body_example
string

O body com cada marcador substituído pelo variable_example da variável, entre colchetes. Montado pelo Pombo, serve para pré-visualizar o texto sem preencher nada.

​
template_type
enum<string>

O tipo de cabeçalho. DOCUMENT e IMAGE são os que levam arquivo; TEXT é só texto.

VIDEO e LOCATION podem aparecer em modelos antigos e não são aceitos ao criar um modelo novo. Um envio com eles não leva arquivo.

Available options:
DOCUMENT,
IMAGE,
LOCATION,
TEXT,
VIDEO
​
language_code
enum<string>
Available options:
pt_BR,
en_US,
es_ES
​
template_status
enum<string>

Só um modelo APPROVED pode ser usado em um envio de WhatsApp. A aprovação é da Meta, não do Pombo.

Um modelo de whatsapp nasce PENDING: consulte GET /templates/{id} até chegar a APPROVED, e crie os seus modelos com antecedência, porque um envio com modelo não aprovado é recusado com 422.

Um modelo de email nasce APPROVED e serve para enviar na mesma hora.

Available options:
PENDING,
APPROVED,
REJECTED,
PAUSED,
DISABLED,
DELETED,
IN_APPEAL,
FLAGGED,
FAILED
​
template_origin
enum<string>

SYSTEM são modelos do catálogo do Pombo; ORG, os da sua organização.

Na listagem, os seus aparecem em qualquer template_status, inclusive PENDING e REJECTED; os do catálogo aparecem só quando já estão APPROVED. Rascunhos e modelos apagados ficam de fora.

Available options:
SYSTEM,
ORG
​
requires_attachment
boolean | null

Anotação de quem criou o modelo, sem efeito nenhum: nada no envio a consulta, e enviar sem arquivo não é recusado por causa dela. Não a envie.

Um modelo de whatsapp devolve sempre null, tenha você enviado o campo ou não; só um modelo de email devolve o valor como chegou.

Para um modelo que leve arquivo, o campo que importa é template_type, com DOCUMENT ou IMAGE.

​
variables
object

As variáveis do modelo. Estas chaves são as de parameters no envio.

Os marcadores do rodapé do remetente estão deliberadamente ausentes daqui, embora apareçam no body: é o Pombo que os preenche, a partir do sender do envio. Um marcador do body sem entrada em variables é isso, e não um erro.

​
subject
string | null

Campo histórico, sem efeito: não é o assunto que o destinatário recebe. O assunto de um e-mail é montado no momento do envio a partir do nome da organização.

Sempre null em um modelo criado pela API, nos dois canais: o campo não é gravado na criação. Só traz conteúdo em modelos antigos.

​
declined_reason
enum<string> | null

Por que a Meta recusou o modelo, quando template_status é REJECTED ou FAILED. null enquanto não houve recusa.

ABUSIVE_CONTENT e SCAM exigem reescrever o texto. INVALID_FORMAT, TAG_CONTENT_MISMATCH e INCORRECT_CATEGORY são erros de forma. REVIEW_TIMEOUT é falha da própria revisão e um modelo novo com o mesmo texto pode passar.

Available options:
ABUSIVE_CONTENT,
SCAM,
INVALID_FORMAT,
TAG_CONTENT_MISMATCH,
INCORRECT_CATEGORY,
REVIEW_TIMEOUT,
UNKNOWN,
null
​
rejected_reason
string | null

O motivo em texto livre, como o provedor o enviou. Não é estável e não deve ser comparado em código: para ramificar, use declined_reason.

​
created_at
string<date-time>
​
updated_at
string<date-time>

A última alteração do registro. Muda sem você fazer nada: a Meta atualiza o status e a categoria por webhook, e cada atualização mexe neste campo.