Termos da API
Última atualização: 06 de novembro de 2026
Versão 1.0
Regras de uso da API aberta da Astrify Flows: chaves, escopos, limites, webhooks, disponibilidade, suspensão e responsabilidades.
Sobre estes Termos
Estes Termos regulam o uso da API aberta da Astrify Flows, produto da HAWK BRASIL BUSINESS SOLUTIONS LTDA (CNPJ 66.519.384/0001-61), por clientes e pelos desenvolvedores que integram a plataforma com outros sistemas. Eles fazem parte dos Termos de Uso (cláusula 19) e valem junto com a Política de Uso Aceitável e Antispam, o DPA, a Política de Privacidade e a página Segurança e SLA. Os termos com inicial maiúscula têm o significado dos Termos de Uso. Em caso de conflito sobre o uso da API, estes Termos prevalecem.
Resumo rápido
- A API aberta está disponível nos planos Growth, Pro e Scale (e Enterprise), e só o administrador cria chaves.
- A chave é secreta: aparece uma única vez, age em nome de quem a criou e você responde por tudo que for feito com ela.
- Cada chave tem escopos (o que ela pode fazer) e acessa apenas a sua empresa.
- O limite é de 120 requisições por minuto por chave.
- Login, senha, 2FA e cadastro de contas não existem na API, por segurança.
- A API é prestada em melhor esforço, sem garantia de disponibilidade, salvo SLA em contrato Enterprise.
Índice
1. Definições
- API: a interface pública da Astrify Flows, em
https://api2.astrify.com.br/v1, descrita na página Documentação. - Chave de API ("Chave"): credencial secreta que autentica a sua aplicação.
- Aplicação: o sistema, a automação ou a integração que você desenvolve ou contrata e que usa a API.
- Escopo: a permissão de uma chave sobre um tipo de recurso, de leitura ou de escrita.
2. Quem pode usar
2.1. A API está disponível para o Cliente nos planos Growth, Pro e Scale, e no Enterprise, conforme o contrato. Os planos Starter e Lite não criam chaves. Se o plano for reduzido para um sem API, as chaves deixam de funcionar.
2.2. Somente o administrador da conta cria, revoga e gerencia chaves, pelo painel (Configurações, API aberta), nunca pela própria API.
2.3. O Cliente pode ter até 20 chaves ativas ao mesmo tempo.
2.4. Quem desenvolve a Aplicação em nome do Cliente (agência, freelancer, software house) age por conta e responsabilidade do Cliente.
3. Chaves de API
3.1. Formato e entrega. A chave é mostrada uma única vez, no momento da criação. Depois disso a Astrify guarda apenas uma versão irreversível, e não consegue recuperá-la. Se você a perder, crie outra.
3.2. Sigilo. A chave é pessoal, sigilosa e intransferível. Você deve:
- guardá-la em local seguro (cofre de segredos ou variável de ambiente do servidor);
- nunca colocá-la em código de navegador, aplicativo público, repositório aberto, capturas de tela ou mensagens. A API deve ser chamada do servidor da sua Aplicação, por HTTPS, e não é compatível com chamadas diretas de navegador;
- usar uma chave por integração, para poder revogar uma sem afetar as outras;
- revogá-la imediatamente ao menor sinal de vazamento.
3.3. Em nome de quem. A chave age em nome do usuário que a criou. Valem as permissões do cargo dele e o escopo da chave, sempre o menor dos dois. Se o usuário for desativado, a chave deixa de funcionar.
3.4. Validade. A chave tem validade (por padrão, 1 ano, podendo ser de 1 a 730 dias). Você pode, ao criá-la, restringir os endereços IP autorizados (até 20), o que recomendamos. Revogada ou expirada, a chave para de funcionar na hora.
3.5. Responsabilidade. O Cliente responde por todas as ações feitas com as suas chaves, inclusive as de terceiros que tenham tido acesso a elas, e por todos os efeitos delas, como envios, alterações e exclusões.
3.6. Incidente com chave. Se você suspeitar de uso indevido, revogue a chave e avise astrify@astrify.com.br.
4. Escopos, permissões e empresa
4.1. Os escopos seguem o formato <recurso>:read (leitura) e <recurso>:write (escrita, que inclui leitura). A chave só recebe os escopos que você escolher. Dê só o necessário.
4.2. A chave acessa apenas a sua empresa. Qualquer tentativa de acessar dados de outra empresa é recusada e pode levar à revogação da chave e à suspensão da conta.
4.3. A API usa o princípio de negar por padrão: o que não está na lista de rotas públicas, a chave não acessa.
4.4. A Astrify pode adicionar, alterar e retirar escopos e rotas, conforme a seção 9.
5. O que a API não permite
Por segurança, não existem na API: login e sessão, verificação em duas etapas, senha e redefinição de senha, primeiro acesso, criação de contas, cobrança e assinatura, credenciais de integrações e algumas configurações sensíveis (como cargos, instâncias, webhooks, roleta, SLA e a criação de campanhas de disparo em massa). Tentar contornar essas restrições é uma violação destes Termos.
6. Limites de uso
6.1. Limite por chave. Cada chave pode fazer até 120 requisições por minuto. O limite é igual para todas as chaves e planos. Ao excedê-lo, a API responde com erro 429 e o tempo para tentar de novo (Retry-After). Não há cota mensal de requisições.
6.2. Tentativas inválidas. Tentativas repetidas com chaves inválidas são bloqueadas por IP por um tempo.
6.3. Ajustes. A Astrify pode ajustar os limites para proteger a estabilidade da plataforma (cláusula 19.1 dos Termos de Uso), com aviso quando possível.
6.4. Limites do plano valem também pela API. O envio de e-mails, mensagens de campanha, créditos, execuções e demais limites do plano se aplicam ao uso feito pela API, e esse consumo é cobrado como qualquer outro.
6.5. Boas práticas. Implemente novas tentativas com espera progressiva, trate os erros (401, 403, 404, 429 e 5xx), use paginação, evite buscas repetidas desnecessárias e, nas operações que criam registros, controle duplicidades (por exemplo, guardando o identificador do que já enviou), pois uma nova tentativa pode repetir a ação.
7. Uso permitido e proibido
7.1. Permitido: integrar a plataforma ao seu site, ERP, CRM, sistema de pagamentos, ferramentas de automação e ao seu próprio produto, para uso do Cliente e de seus clientes finais, nos limites da lei e destes Termos.
7.2. Proibido, além do previsto nos Termos de Uso e na Política de Uso Aceitável:
- compartilhar, vender ou revender o acesso à API ou oferecê-la a terceiros como produto próprio, sem contrato específico;
- burlar limites, criando várias chaves ou contas para driblar o limite de requisições, de consumo ou de cobrança;
- sobrecarregar ou degradar a plataforma, ou fazer testes de carga sem autorização;
- extrair dados em massa que não sejam do próprio Cliente, ou raspar a plataforma por meios que não a API;
- acessar ou tentar acessar dados de outras empresas, ou explorar falhas fora do que prevê a página Segurança e SLA;
- usar a API para spam, golpes, setores proibidos ou qualquer violação da Política de Uso Aceitável;
- fazer engenharia reversa, copiar a API para criar produto concorrente ou usar a API para treinar sistemas concorrentes;
- remover ou ocultar avisos, ou sugerir que a Astrify endossa a sua Aplicação.
8. Dados pessoais
8.1. Os dados que a sua Aplicação lê, grava ou envia pela API são Dados do Cliente. O Cliente é o controlador e a Astrify é a operadora, conforme o DPA.
8.2. O Cliente deve proteger os dados obtidos pela API (armazenamento seguro, acesso restrito, descarte quando não forem mais necessários), ter base legal para o que faz com eles, respeitar os direitos dos titulares e não expor dados pessoais em registros (logs), repositórios ou ferramentas de terceiros sem salvaguardas.
8.3. O Cliente responde pelos fornecedores e ferramentas que ele conectar à API (por exemplo, plataformas de automação), inclusive pelo que eles fazem com os dados.
9. Versões, mudanças e descontinuação
9.1. A API é identificada por versão (hoje, /v1). A documentação, o arquivo OpenAPI e a coleção do Postman estão na página Documentação.
9.2. Mudanças compatíveis, como novas rotas, novos campos nas respostas e novos escopos, podem ocorrer a qualquer momento, sem aviso. A sua Aplicação deve ignorar campos que não conhece.
9.3. Mudanças que quebram a compatibilidade ou a descontinuação de uma rota serão comunicadas ao administrador da conta com antecedência mínima de 60 dias, por e-mail ou aviso na plataforma. Podem ocorrer com prazo menor quando necessário para segurança, para cumprir a lei ou por determinação de autoridade ou de provedor.
9.4. Recursos marcados como beta ou experimentais podem mudar ou ser retirados a qualquer momento.
10. Webhooks de saída
Quando disponíveis no plano, os webhooks de saída enviam eventos da plataforma para um endereço seu. Para usá-los você deve:
- receber os eventos em um endereço seguro (HTTPS) e validar a assinatura enviada no cabeçalho (
X-Astrify-Signature, HMAC-SHA256), para ter certeza de que o evento veio da Astrify; - guardar o segredo do webhook com o mesmo cuidado de uma chave;
- aceitar que um evento possa ser entregue mais de uma vez ou fora de ordem, tratando-o de forma idempotente;
- responder rápido e com o status correto. A Astrify faz novas tentativas, mas não garante a entrega.
A Astrify não envia webhooks para endereços internos ou privados.
11. Disponibilidade e suporte
11.1. A API é prestada em melhor esforço, sem garantia de disponibilidade, de desempenho ou de funcionamento contínuo ou livre de erros. Aplica-se a cláusula 20 dos Termos de Uso: a indisponibilidade ou a instabilidade não gera indenização, reembolso, desconto ou crédito, salvo SLA expresso em contrato Enterprise.
11.2. A sua Aplicação deve prever falhas e contingência. Não dependa da API como único meio de operações críticas.
11.3. Suporte. O suporte à API é prestado pelo canal astrify@astrify.com.br, no horário comercial, e abrange dúvidas de uso e registro de falhas. Não inclui o desenvolvimento, a depuração nem a manutenção da Aplicação do Cliente, nem o suporte a ferramentas de terceiros.
12. Registros e monitoramento
A Astrify registra o uso da API (data, rota, método, resultado e endereço IP) para segurança, auditoria, cobrança e prevenção de abuso, e o administrador vê o uso das chaves no painel. A Astrify não lê previamente o conteúdo que a sua Aplicação envia, mas pode investigar sinais de abuso, conforme os Termos de Uso.
13. Suspensão e revogação
A Astrify pode limitar, suspender ou revogar chaves ou o acesso à API, sem prejuízo de outras medidas, quando houver: suspeita de vazamento ou de uso indevido; violação destes Termos, dos Termos de Uso ou da Política de Uso Aceitável; uso que cause risco à segurança, à estabilidade ou a terceiros; inadimplência; ou determinação legal. Sempre que a urgência permitir, avisaremos e daremos oportunidade razoável de regularização (cláusula 23 dos Termos de Uso). Em situação grave, a medida pode ser imediata.
14. Licença e propriedade intelectual
14.1. A Astrify concede ao Cliente uma licença limitada, não exclusiva, revogável e intransferível para usar a API e a documentação para integrar a conta do próprio Cliente, enquanto o contrato estiver em vigor.
14.2. A API, a documentação, o código e as marcas continuam sendo da Astrify. O Cliente continua titular dos seus dados.
14.3. Sugestões e feedback sobre a API podem ser usados pela Astrify sem obrigação de pagamento.
15. Garantias e responsabilidade
15.1. A API é fornecida no estado em que se encontra, sem garantia de adequação a um fim específico ou de ausência de erros, nos limites da lei.
15.2. A responsabilidade da Astrify decorrente do uso da API segue os limites e as exclusões da cláusula 22 dos Termos de Uso. A Astrify não responde por perdas decorrentes da Aplicação do Cliente, de falhas de terceiros, de chaves vazadas por culpa do Cliente, de ações feitas com as chaves do Cliente ou de dados enviados pelo Cliente em desacordo com a lei.
15.3. O Cliente ressarce a Astrify por reclamações de terceiros e de autoridades decorrentes do uso da API em violação destes Termos, nos termos da cláusula 22 dos Termos de Uso.
16. Encerramento
Estes Termos vigoram enquanto o Cliente usar a API. Ao cancelar a conta, ao mudar para um plano sem API ou ao ter o acesso encerrado, as chaves deixam de funcionar. Os dados seguem as regras de exportação e exclusão dos Termos de Uso.
17. Alterações destes Termos
Podemos atualizar estes Termos. A versão vigente fica publicada com a data de atualização, e mudanças relevantes são comunicadas com antecedência ao administrador da conta. O uso da API depois da vigência da mudança significa que o Cliente a aceitou.
18. Dados da fornecedora, lei aplicável e foro
- Razão social: HAWK BRASIL BUSINESS SOLUTIONS LTDA
- Plataforma: ASTRIFY FLOWS, um produto Hawk Brasil, Business Solutions
- CNPJ: 66.519.384/0001-61
- Endereço: Rua Augusto Zibarth, nº 828, Escritório 2, bairro Uberaba, Curitiba/PR, CEP 81560-360, Brasil
Estes Termos são regidos pela legislação brasileira. Fica eleito o foro da comarca de Curitiba/PR, ressalvado o direito do consumidor de ajuizar a ação no foro do seu domicílio.
Dúvidas sobre este documento?
Fale com o Encarregado (DPO) em gabriel.patyk@astrify.com.br ou +55 (41) 99625-7771.
























