Skip to main content

​
API de Contas

Gerencie contas WhatsApp Business. Todos os endpoints requerem a master API key.

​
Criar Conta

​
X-Api-Key
string
required
Master API key
POST https://grwthy.com/whatsapp/accounts
Cria uma nova conta WhatsApp Business e retorna uma API key única.
A apiKey é retornada apenas uma vez durante a criação. Armazene-a com segurança.

​
Corpo da Requisição

​
name
string
required
Nome de exibição da conta
​
phoneNumberId
string
required
Phone Number ID do WhatsApp no Meta Business Manager
​
businessAccountId
string
required
Business Account ID do WhatsApp no Meta Business Manager
​
accessToken
string
required
Token de acesso permanente da Meta. Armazenado de forma segura e criptografado
​
appSecret
string
required
App Secret da Meta para verificação de assinatura do webhook. Armazenado de forma segura e criptografado
​
webhookVerifyToken
string
required
Token personalizado usado durante a verificação do webhook pela Meta

​
Resposta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Meu Negócio",
  "phoneNumberId": "123456789012345",
  "businessAccountId": "987654321098765",
  "webhookVerifyToken": "meu-token-de-verificacao",
  "isActive": true,
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-01T00:00:00.000Z",
  "apiKey": "wk_a1b2c3d4e5f6..."
}

​
Erros

StatusDescrição
409Phone Number ID já registrado

​
Listar Contas

GET https://grwthy.com/whatsapp/accounts
Retorna todas as contas. Campos sensíveis (accessToken, appSecret, apiKey) nunca são incluídos na resposta.

​
Resposta

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Meu Negócio",
    "phoneNumberId": "123456789012345",
    "businessAccountId": "987654321098765",
    "webhookVerifyToken": "meu-token-de-verificacao",
    "isActive": true,
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z"
  }
]

​
Buscar Conta

GET https://grwthy.com/whatsapp/accounts/:id
​
id
string
required
UUID da conta

​
Erros

StatusDescrição
404Conta não encontrada

​
Atualizar Conta

PATCH https://grwthy.com/whatsapp/accounts/:id
​
id
string
required
UUID da conta
Todos os campos são opcionais. Apenas os campos fornecidos são atualizados.

​
Corpo da Requisição

​
name
string
Nome de exibição atualizado
​
accessToken
string
Novo access token
​
appSecret
string
Novo app secret
​
webhookVerifyToken
string
Novo token de verificação do webhook
​
isActive
boolean
Ativar ou desativar a conta

​
Resposta

Retorna o objeto da conta atualizado.

​
Desativar Conta

DELETE https://grwthy.com/whatsapp/accounts/:id
​
id
string
required
UUID da conta
Desativa a conta. Ela não poderá mais enviar ou receber mensagens.

​
Resposta

{
  "message": "Account deactivated"
}

​
Regenerar API Key

POST https://grwthy.com/whatsapp/accounts/:id/regenerate-key
​
id
string
required
UUID da conta
Gera uma nova API key para a conta. A chave anterior é imediatamente invalidada.
A nova apiKey é exibida apenas uma vez. Armazene-a com segurança.

​
Resposta

{
  "apiKey": "wk_nova_chave_aqui..."
}

​
Buscar Templates da Conta

GET https://grwthy.com/whatsapp/accounts/:id/templates
​
id
string
required
UUID da conta
​
limit
integer
default:"100"
Número máximo de templates a retornar
Retorna os templates de mensagem da Meta para esta conta. Veja API de Templates para o formato da resposta.