Skip to main content

​
API de Templates

Gerencie templates de mensagem do WhatsApp Business. Templates devem ser aprovados pela Meta antes de serem usados para envio.

​
Listar Templates

GET https://grwthy.com/v1/templates
Retorna todos os templates do Business Account vinculado à API Key.

​
Exemplo

curl https://grwthy.com/v1/templates \
  -H "X-Api-Key: SUA_API_KEY"

​
Resposta

{
  "data": [
    {
      "name": "hello_world",
      "status": "APPROVED",
      "category": "UTILITY",
      "language": "pt_BR",
      "components": [
        {
          "type": "BODY",
          "text": "Olá {{1}}! Bem-vindo ao nosso serviço."
        }
      ],
      "id": "123456789"
    }
  ]
}

​
Status dos Templates

StatusDescrição
APPROVEDPronto para uso
PENDINGEm análise pela Meta
REJECTEDNão aprovado

​
Categorias

CategoriaDescrição
UTILITYAtualizações de transação, notificações
MARKETINGMensagens promocionais, ofertas
AUTHENTICATIONOTP e códigos de verificação

​
Criar Template

POST https://grwthy.com/v1/templates
​
name
string
required
Nome do template (letras minúsculas e underscores).
​
category
string
required
Categoria: UTILITY, MARKETING ou AUTHENTICATION.
​
language
string
required
Código do idioma (ex: pt_BR, en_US).
​
components
array
required
Componentes do template (header, body, footer, buttons). Segue o formato da API do WhatsApp.
​
allowCategoryChange
boolean
Permitir que a Meta reclassifique a categoria automaticamente.

​
Exemplo

curl -X POST https://grwthy.com/v1/templates \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
    "name": "confirmacao_pedido",
    "category": "UTILITY",
    "language": "pt_BR",
    "components": [
      {
        "type": "BODY",
        "text": "Olá {{1}}, seu pedido {{2}} foi confirmado!"
      }
    ]
  }'

​
Resposta

{
  "id": "987654321",
  "status": "PENDING",
  "category": "UTILITY"
}

​
Editar Template

PUT https://grwthy.com/v1/templates
​
templateId
string
required
ID do template a ser editado.
​
components
array
required
Novos componentes do template.

​
Exemplo

curl -X PUT https://grwthy.com/v1/templates \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
    "templateId": "987654321",
    "components": [
      {
        "type": "BODY",
        "text": "Olá {{1}}, seu pedido {{2}} foi confirmado e será entregue em {{3}}!"
      }
    ]
  }'

​
Remover Template

DELETE https://grwthy.com/v1/templates
​
name
string
required
Nome do template a ser removido.
​
hsmId
string
HSM ID do template (opcional, para remoção específica).

​
Exemplo

curl -X DELETE https://grwthy.com/v1/templates \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
    "name": "confirmacao_pedido"
  }'