Skip to main content

​
API de Instâncias

Gerencie instâncias WhatsApp Business. Cada instância representa uma linha WhatsApp conectada.

​
Criar Instância

POST https://grwthy.com/v1/instances
​
instanceName
string
required
Nome único da instância. Usado como identificador nos endpoints de mensagem.
​
phoneNumberId
string
required
Phone Number ID do WhatsApp Business. Encontrado no painel Meta Business.
​
accessToken
string
Token de acesso permanente para a API do WhatsApp.
​
businessAccountId
string
ID da conta WhatsApp Business (WABA).
​
apiKey
string
Chave da API do WhatsApp Business.
​
webhook
object
Configuração de webhook para esta instância.
​
webhook.url
string
required
URL para receber eventos.
​
webhook.headers
object
Headers customizados enviados junto com cada evento.
​
webhook.enabled
boolean
Ativar ou desativar o webhook.
​
webhook.events
string[]
Lista de eventos para receber (ex: ["messages.upsert", "messages.update"]).

​
Exemplo

curl -X POST https://grwthy.com/v1/instances \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SUA_API_KEY" \
  -d '{
    "instanceName": "minha-loja",
    "phoneNumberId": "123456789012345",
    "accessToken": "EAAx...",
    "webhook": {
      "url": "https://meusite.com/webhook",
      "enabled": true,
      "events": ["messages.upsert", "messages.update"]
    }
  }'

​
Listar Instâncias

GET https://grwthy.com/v1/instances
Retorna todas as instâncias do Business Account vinculado à API Key.

​
Exemplo

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

​
Buscar Instância

GET https://grwthy.com/v1/instances/:id
​
id
string
required
ID da instância (retornado na criação).

​
Exemplo

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

​
Remover Instância

DELETE https://grwthy.com/v1/instances/:id
​
id
string
required
ID da instância.

​
Exemplo

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