Início
Início Rápido
Sua primeira chamada à API do NewGestor, do token à resposta.
Passo 1: Gerar o token
- Entre no painel Acesse npanel.newgestor.com com a sua conta.
- Abra API Tokens No menu da conta, vá em API Tokens.
- Crie o token
Dê um nome que lembre para que ele serve —
n8n,bot do WhatsApp— e confirme. - Copie na hora O token aparece uma única vez. Guarde antes de fechar a tela.
O token dá acesso aos dados da sua empresa inteira. Nunca compartilhe o seu token publicamente. Crie um token separado para cada integração: assim, se precisar cortar o acesso de uma, as outras continuam funcionando.
Passo 2: Testar a conexão
Troque SEU_TOKEN_AQUI pelo token que você acabou de copiar e rode. Pedimos
5 clientes só para conferir que a ligação está de pé:
curl "https://npanel.newgestor.com/api/v1/customers?per_page=5" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Accept: application/json"const resposta = await fetch(
"https://npanel.newgestor.com/api/v1/customers?per_page=5",
{
headers: {
"Authorization": "Bearer SEU_TOKEN_AQUI",
"Accept": "application/json"
}
}
);
const dados = await resposta.json();
console.log(dados);<?php
$ch = curl_init("https://npanel.newgestor.com/api/v1/customers?per_page=5");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer SEU_TOKEN_AQUI",
"Accept: application/json",
],
]);
$resposta = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($resposta);import requests
resposta = requests.get(
"https://npanel.newgestor.com/api/v1/customers",
params={"per_page": 5},
headers={
"Authorization": "Bearer SEU_TOKEN_AQUI",
"Accept": "application/json",
},
)
print(resposta.json())Passo 3: Resposta esperada
Deu certo se o success voltar true e os clientes vierem em
data:
{
"success": true,
"data": [
{
"id": 8412,
"uuid": "9d2f1a7e-4c33-4f80-b1a2-0c5e7d9a1b44",
"name": "Maria Souza",
"whatsapp": "5511988887777",
"email": "[email protected]",
"usuario": "maria.souza",
"data_de_vencimento": "2026-10-05",
"status": "Ativo",
"plan": { "id": 31, "name": "Mensal", "value": "50.00" },
"product": { "id": 4, "name": "Plano Full HD" }
}
],
"meta": {
"total": 1391,
"per_page": 5,
"current_page": 1,
"last_page": 279,
"company_id": 274
}
}Voltou 401? O token não chegou. Confira se o cabeçalho é exatamente
Authorization: Bearer SEU_TOKEN — com a palavra Bearer e um
espaço antes do token.
Chamadas do dia a dia
Renovar o vencimento de um cliente
Empurra a data de vencimento conforme o período do plano do próprio cliente. Não precisa mandar corpo na requisição:
curl -X POST "https://npanel.newgestor.com/api/v1/customers/8412/renew-due-date" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Accept: application/json"Trazer as faturas junto do cliente
O parâmetro invoices_limit anexa as faturas de cada cliente na mesma
resposta. Use 0 para trazer todas:
curl "https://npanel.newgestor.com/api/v1/customers?invoices_limit=3" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Accept: application/json"Listar os planos
curl "https://npanel.newgestor.com/api/v1/plans" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "Accept: application/json"