Listar templates
curl --request GET \
--url https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "1234567890123456",
"name": "pedido_pronto",
"language": "pt_BR",
"status": "APPROVED",
"category": "UTILITY"
}
],
"paging": {
"cursors": {
"before": "QVFIU...",
"after": "QVFIU..."
}
}
}{
"error": {
"message": "(#131030) Recipient phone number not in allowed list",
"type": "OAuthException",
"code": 131030,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}{
"statusCode": 402,
"message": "Assinatura inativa. Ative sua assinatura no painel para voltar a usar a API."
}{
"statusCode": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Templates
Listar templates
Espelho de GET /{waba_id}/message_templates da Meta Cloud API.
GET
/
v1
/
{waba_id}
/
message_templates
Listar templates
curl --request GET \
--url https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "1234567890123456",
"name": "pedido_pronto",
"language": "pt_BR",
"status": "APPROVED",
"category": "UTILITY"
}
],
"paging": {
"cursors": {
"before": "QVFIU...",
"after": "QVFIU..."
}
}
}{
"error": {
"message": "(#131030) Recipient phone number not in allowed list",
"type": "OAuthException",
"code": 131030,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}{
"statusCode": 402,
"message": "Assinatura inativa. Ative sua assinatura no painel para voltar a usar a API."
}{
"statusCode": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Lista os templates da conta com nome, status, categoria e idioma. A resposta informa o
Além dos campos básicos,
O filtro
Mais detalhes em Paginação e na visão geral de templates da Meta.
id de cada template e o status atual da análise.
{
"data": [
{
"id": "5400801403478858",
"name": "retirada_equipamento",
"language": "pt_BR",
"status": "APPROVED",
"category": "UTILITY"
}
],
"paging": { "cursors": { "before": "QVFIU...", "after": "QVFIU..." } }
}
Campos retornados
Por padrão a Meta retorna o template completo, incluindo todos os componentes. O parâmetrofields limita a resposta aos campos informados:
curl 'https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates?fields=name,status,category,language' \
-H 'Authorization: Bearer sk_live_xxx'
components retorna o conteúdo do template e rejected_reason informa o motivo da recusa, como INVALID_FORMAT quando falta o example das variáveis.
Filtros
| Filtro | Exemplo | Resultado |
|---|---|---|
name | ?name=retirada_equipamento | Retorna o template informado, em todos os idiomas |
status | ?status=APPROVED | Retorna apenas os templates no status indicado |
limit | ?limit=20 | Define a quantidade de templates por página |
name permite consultar o status de um template específico enquanto o webhook message_template_status_update não estiver implementado.
Paginação
Quando a conta possui muitos templates, a resposta é paginada e os cursores são retornados empaging.cursors. Para obter a página seguinte, repita a chamada com o cursor after:
curl 'https://cloud.datafyapi.com.br/v1/{waba_id}/message_templates?limit=20&after=QVFIU...' \
-H 'Authorization: Bearer sk_live_xxx'
A resposta pode conter um
paging.next apontando para graph.facebook.com. Esse endereço é da Meta e exige o token dela, que a Datafy não expõe. Utilize apenas o valor do cursor, na URL da Datafy, como no exemplo acima.Autorizações
Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.
Parâmetros de caminho
ID da conta do WhatsApp Business. Descubra com GET /me.
Parâmetros de consulta
Filtra pelo nome do template.
Filtra pelo status de aprovação.
Opções disponíveis:
APPROVED, PENDING, REJECTED, PAUSED, DISABLED Campos retornados, separados por vírgula.
Quantidade de templates por página.
Resposta
Lista de templates.