Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.grwthy.com/llms.txt

Use this file to discover all available pages before exploring further.

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"
  }'