API do Seu Secretário

https://www.seusecretario.com.br/api/v1

curl https://www.seusecretario.com.br/api/v1/ping \
  -H "Authorization: Bearer SUA_CHAVE"

# → {"ok":true,"usuario_id":"...","escopos":["*"]}

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl "https://www.seusecretario.com.br/api/v1/agenda?status=futuro&limit=10" \
  -H "Authorization: Bearer SUA_CHAVE"

# Resposta 200
{
  "compromissos": [
    { "id": "dc1671c2-...", "titulo": "Corte · Lucas", "data_hora": "2026-07-17T13:00:00.000Z",
      "nome_contato": "Lucas", "telefone_contato": "5531999999999", "origem": "whatsapp-oficial" }
  ],
  "total": 1, "limit": 10, "offset": 0
}

curl -X POST https://www.seusecretario.com.br/api/v1/agenda \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Limpeza de pele · Maria",
    "data_hora": "2026-07-22T14:00:00-03:00",
    "nome_contato": "Maria",
    "telefone_contato": "31999998888"
  }'

const resposta = await fetch('https://www.seusecretario.com.br/api/v1/agenda', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.SS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    titulo: 'Limpeza de pele · Maria',
    data_hora: '2026-07-22T14:00:00-03:00',
    nome_contato: 'Maria',
    telefone_contato: '31999998888',
  }),
});
const compromisso = await resposta.json();

$ch = curl_init('https://www.seusecretario.com.br/api/v1/agenda');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('SS_API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'titulo' => 'Limpeza de pele · Maria',
    'data_hora' => '2026-07-22T14:00:00-03:00',
    'nome_contato' => 'Maria',
    'telefone_contato' => '31999998888',
  ]),
]);
$compromisso = json_decode(curl_exec($ch), true);

curl -X POST https://www.seusecretario.com.br/api/v1/cobrancas \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "devedor": "João Silva",
    "valor": 150.00,
    "descricao": "Mensalidade de julho",
    "data_vencimento": "2026-07-25",
    "telefone_devedor": "31988887777",
    "enviar_whatsapp": true
  }'

# Resposta 201
{
  "id_curto": "AB3K9",
  "status": "pendente",
  "valor": 150,
  "link_pagamento": "https://www.seusecretario.com.br/cobrar/AB3K9"
}

const resposta = await fetch('https://www.seusecretario.com.br/api/v1/cobrancas', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.SS_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    devedor: 'João Silva',
    valor: 150.00,
    descricao: 'Mensalidade de julho',
    telefone_devedor: '31988887777',
    enviar_whatsapp: true,
  }),
});
const cobranca = await resposta.json();
console.log(cobranca.link_pagamento); // página onde o cliente gera o Pix

POST https://seu-sistema.com.br/webhook
X-SS-Evento: cobranca.paga
X-SS-Webhook-Id: 0e5d48e7-...
X-SS-Assinatura: sha256=3f1a9c...

{
  "evento": "cobranca.paga",
  "criado_em": "2026-07-17T10:32:00.000Z",
  "dados": {
    "id_curto": "AB3K9",
    "devedor": "João Silva",
    "valor": 150,
    "status": "recebido",
    "link_pagamento": "https://www.seusecretario.com.br/cobrar/AB3K9"
  }
}

const crypto = require('crypto');

app.post('/webhook', express.json(), (req, res) => {
  const esperado = 'sha256=' + crypto
    .createHmac('sha256', process.env.SS_WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('hex');

  if (req.headers['x-ss-assinatura'] !== esperado)
    return res.status(401).end();

  // tudo certo: reaja ao evento
  console.log(req.body.evento, req.body.dados);
  res.json({ ok: true });
});

$corpo = file_get_contents('php://input');
$esperado = 'sha256=' . hash_hmac('sha256', $corpo, getenv('SS_WEBHOOK_SECRET'));

if (!hash_equals($esperado, $_SERVER['HTTP_X_SS_ASSINATURA'] ?? '')) {
  http_response_code(401);
  exit;
}

$evento = json_decode($corpo, true);
// reaja ao evento

curl -X POST https://www.seusecretario.com.br/api/v1/webhooks \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seu-sistema.com.br/webhook", "eventos": ["cobranca.paga"] }'

# Resposta 201: guarde o secret para validar as entregas
{ "id": "0e5d48e7-...", "secret": "whsec_...", "eventos": ["cobranca.paga"], "ativo": true }

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
Retry-After: 42   # só quando você recebe 429