Pular para o conteúdo principal

Changelog

Mudanças na API Externa (/external/v1) e nos webhooks, da mais recente para a mais antiga. A versão no caminho continua v1: as mudanças abaixo foram feitas sem trocar de versão.

18 de novembro de 2026​

Adicionado​

  • Renovação por refreshToken. POST /external/v1/auth passa a devolver refreshToken e refreshExpiresIn. A rota nova POST /external/v1/auth/refresh-token devolve accessToken, companyToken e refreshToken novos. Veja Autenticação.

Alterado​

  • Limite de uso: 100 requisições por minuto por empresa, somando todas as rotas e valendo também sob chamadas simultâneas. Ao passar, 429 com o tempo de espera em segundos.
  • Paginação: page e limit são opcionais em todas as listagens (padrão page=1, limit=25).
  • Respostas nunca trazem credenciais ou segredos (chaves, senhas, certificados, tokens de integração, respostas brutas de gateways).

Removido​

  • POST /external/v1/auth/refresh-company (responde 404). Use refresh-token.
  • Eventos de webhook charge.status_changed e protocol.status_changed, que nunca eram enviados. Inscrições que os tinham continuam recebendo os demais eventos.

6 de novembro de 2026​

Alterado​

  • Confirmação em duas etapas nas ações sensíveis. Gerar ou revogar a API Key, criar uma inscrição de webhook, trocar a URL de destino de uma inscrição ou acrescentar eventos a ela passam a pedir o código da verificação em duas etapas a quem a usa. As chamadas da API Externa não mudam.

23 de outubro de 2026​

Alterado​

  • Só a sessão da API Key. As rotas /external/v1 passam a aceitar apenas a sessão criada por POST /external/v1/auth. O token de login de uma pessoa é recusado com 403.
  • Plano e perfil conferidos em toda rota. Cada rota confere se a empresa tem o recurso correspondente no plano e se o perfil de acesso da conta de serviço permite a ação (GET = leitura, POST = criação, PUT = edição). Sem o recurso ou sem a permissão, a resposta é 403.
  • Assinatura suspensa deixa a integração só com leitura. Com a assinatura da empresa suspensa, criações e atualizações respondem 402 com code = SUBSCRIPTION_SUSPENDED; as consultas continuam funcionando.
  • Webhooks: destinos internos recusados. A URL de destino de um webhook que aponte para endereço interno ou de rede privada é recusada no envio; a entrega fica como falhou, sem nova tentativa.

Corrigido​

  • As listagens de person-emails, person-phones, deal-items, quote-items, contract-items, purchase-order-items, project-waves, project-epics, project-tasks, project-team-members e accounting-journal-entry-lines respondiam com erro. Agora funcionam e trazem só os registros cujo registro-pai (pessoa, negócio, proposta, contrato, pedido, projeto ou lançamento contábil) é da sua empresa.
  • A busca por ID desses mesmos recursos passa a responder {} para registro de outra empresa.
  • Registros relacionados de outra empresa trazidos com include em relations passam a ser removidos da resposta.

28 de setembro de 2026​

Adicionado​

  • POST /external/v1/integrations/{provider}/connect e DELETE /external/v1/integrations/{provider}/connect: aperto de mão de plataformas parceiras homologadas, com a URL do parceiro e o segredo das chamadas de volta.
  • POST /external/v1/hiring-requests: recebe um item contratado numa plataforma parceira e cria ou reaproveita o cliente, o signatário, o contrato (em rascunho) e o item, sem cobrar nem ativar nada. Aceita requestedBy (quem enviou o pedido) e, para ligar o pedido a cadastros que já existem, contract.id e contractItem.id. Veja Plataformas parceiras.

23 de abril de 2026​

Alterado​

  • companyToken passa a ser o identificador da sessão da empresa (um UUID), e não mais um JWT. Continue enviando o valor recebido, sem alterar, no cabeçalho x-company-token.
  • O Secret passa a ter 27 caracteres nas chaves geradas a partir desta data (antes eram 43).

Corrigido​

  • As listagens passam a trazer só os registros da empresa dona da chave, e a busca por ID responde {} para registro de outra empresa.

22 de abril de 2026​

Alterado​

  • Webhooks: financial_entry.created passa a ser enviado também para os lançamentos criados na conciliação bancária.
  • Webhooks: charge.created passa a ser enviado também quando uma cobrança agendada é gerada.

20 de abril de 2026​

Alterado​

  • Webhooks: deal.status_changed passa a ser enviado também quando o negócio é marcado como ganho ou perdido pelas ações próprias da tela.

9 de abril de 2026​

Removido​

  • As rotas POST /external-api/config/generate-key, POST /external-api/config/revoke-key e GET /external-api/config/key-status. A API Key passa a ser gerada, consultada e revogada só pela tela API Externa do Tesselys.

28 de março de 2026​

Corrigido​

  • Webhooks: as novas tentativas de entrega passam a ser agendadas de fato (1 minuto, 5 minutos, 30 minutos e 2 horas). Antes, a entrega ficava marcada para nova tentativa sem que ela acontecesse.

26 de março de 2026​

Adicionado​

  • 36 recursos novos, além dos 5 da primeira versão:
    • CRM e vendas: leads, activities, deal-items, deal-pipelines, quotes, quote-items, person-emails, person-phones;
    • contratos: signs, contracts, contract-items;
    • projetos: project-waves, project-epics, project-tasks, project-team-members;
    • financeiro: financial-categories, bank-accounts, measurements, invoices, charges, provisioning;
    • compras: purchase-orders, purchase-order-items;
    • RH e timesheet: employee-profiles, timesheet-entries, timesheet-periods;
    • help desk: tickets, ticket-comments, sla-policies;
    • contabilidade: accounting-accounts, accounting-journal-entries, accounting-journal-entry-lines, accounting-reports;
    • consulta: cost-centers, business-units, custom-fields.
  • GET /external/v1/health: verificação de disponibilidade, pública.

18 de março de 2026​

Adicionado​

  • Webhooks: eventos do inbox de atendimento: inbox_conversation.created, inbox_conversation.resolved, inbox_conversation.assigned, inbox_message.received e inbox_message.sent.

13 de março de 2026​

Adicionado​

  • Webhooks: eventos protocol.processing.completed, protocol.processing.failed, protocol.linked, protocol.unlinked, contract.created, contract.updated, contract.status_changed, contract.renewed, contract.canceled, contract.suspended, timesheet.submitted, timesheet.approved, timesheet.rejected e timesheet.closed.

Alterado​

  • Webhooks: o cadastro de uma inscrição passa a recusar eventos que não existem (os curingas de categoria, como deal.*, continuam aceitos).

10 de março de 2026​

Adicionado​

  • Primeira versão da API Externa: autenticação por API Key e Secret (POST /external/v1/auth) e os recursos persons, deals, financial-entries, products e projects, com listagem paginada, busca por ID e criação (e atualização, onde disponível).

4 de março de 2026​

Adicionado​

  • Webhooks: inscrições de webhook com assinatura HMAC-SHA256 (X-Webhook-Signature), cabeçalhos personalizados, curingas por categoria (por exemplo, deal.*), histórico de entregas, reenvio manual, novas tentativas e desativação automática após 50 falhas seguidas. Eventos: deal.*, financial_entry.*, person.*, purchase_order.*, project.*, project_task.*, appointment.*, protocol.created, protocol.status_changed, charge.* e approval_request.*.
Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.