1. Introdução

Sobre o Software

Nosso sistema de tarefas é uma solução web de última geração projetada para simplificar e agilizar o gerenciamento de tarefas. Com sua interface intuitiva e recursos avançados, oferece aos usuários uma plataforma incomparável para realizar tarefas de forma eficiente e eficaz.

Principais Benefícios

Como uma oferta de Software como Serviço (SaaS), nosso sistema de tarefas oferece os benefícios de atualizações contínuas, escalabilidade fácil e redução de custos de TI. Mas o que realmente nos diferencia é nossa integração com tecnologia de IA de ponta. Isso não apenas aumenta as capacidades de tomada de decisão, mas também introduz análises preditivas e automação, garantindo que seu gerenciamento de tarefas esteja sempre um passo à frente.

Plataformas / Navegadores Suportados

Compatibilidade é fundamental. Por isso, garantimos que nosso software suporte todos os principais navegadores web em plataformas desktop e mobile. Além disso, para aqueles que desejam integrar nossas capacidades em sistemas de software personalizados, oferecemos uma API robusta que facilita a conectividade perfeita.

2. Primeiros Passos

Configuração da Conta

Comece sua jornada criando uma conta com um endereço de e-mail válido. Assim que sua conta estiver configurada, explore nossa gama de recursos. Para acessar funcionalidades premium, escolha um dos nossos planos de assinatura adaptados às suas necessidades.

Configuração Básica

Sua nova conta começa em branco, pronta para personalização. Embora possa parecer intimidador no início, lembre-se de que não precisa dominar tudo imediatamente. Comece com o básico como Notas, Links, Contatos e Eventos. À medida que for se sentindo mais confortável, explore gradualmente recursos mais avançados como Tarefas, Modelos de Tarefa e Shell. Cada módulo é projetado para aumentar sua produtividade no seu próprio ritmo.

Integração Inicial do Usuário

Após o cadastro, você receberá um e-mail para verificar sua conta. Este é um passo importante para garantir a segurança da sua conta e ativar todos os recursos. Siga as instruções no e-mail para concluir o processo de verificação e começar sua jornada conosco.

3. Recursos Principais

Visão Geral do Painel Principal

Comece explorando o painel principal, onde você terá acesso a uma visão geral de todos os seus projetos, tarefas, atividades recentes e métricas importantes. Este hub centralizado permite navegar rapidamente entre diferentes seções do site e monitorar o trabalho em andamento de uma olhada.

Projetos

Seu sistema de gerenciamento de projetos permite criar, acompanhar e colaborar em projetos. Defina prazos, gerencie tarefas em cada projeto e monitore o progresso com ferramentas fáceis de usar. Use a seção de projetos para ver todos os projetos ativos e arquivados.

Notas

Após entrar, os usuários podem criar notas para capturar ideias, atas de reunião ou qualquer informação importante. As notas são salvas automaticamente e podem facilmente ser pesquisadas posteriormente. Em breve você poderá organizar notas por projetos, categorias ou etiquetas.

Artigos

A seção de artigos foi projetada para ajudá-lo a criar e publicar conteúdo mais longo, como documentação ou relatórios. Você pode rascunhar, editar e colaborar em artigos com outros membros da equipe. O controle de versão integrado garante que você sempre possa reverter para versões anteriores, se necessário.

Links

Após descobrir recursos úteis, você pode salvá-los e organizá-los na seção de Links. Etiquete, categorize e pesquise seus links para recuperação fácil posteriormente. Esta seção é perfeita para gerenciar materiais de pesquisa, documentação externa ou referências úteis.

Contatos

Após adicionar contatos ao seu sistema, você pode gerenciar e organizar seus detalhes na seção de Contatos. Você pode pesquisar facilmente por pessoas específicas e em breve categorizar contatos por projeto ou empresa, e integrar com outras ferramentas de comunicação.

Eventos

Após criar eventos, você pode ver todas as reuniões agendadas, lembretes e prazos na seção de Eventos. Em breve você poderá sincronizar eventos com calendários, enviar convites e gerenciar notificações para acompanhar datas importantes.

Tarefas e Modelos de Tarefa

Após criar tarefas, você pode organizá-las por prioridade, atribuí-las a membros da equipe e acompanhar o status de conclusão. Os modelos de tarefa permitem criar estruturas de tarefas reutilizáveis para atividades recorrentes, garantindo consistência e economizando tempo.

Arquivos

A seção de Arquivos fornece um sistema poderoso para enviar, organizar e gerenciar documentos com categorização automática, extração de texto e capacidades de criação de tarefas.

Recursos Principais

• Envio Inteligente: Arraste e solte vários arquivos com processamento automático
• Categorização Automática: Os arquivos são organizados automaticamente em pastas lógicas
• Inteligência PDF: A extração de texto torna todos os PDFs pesquisáveis
• Criação de Tarefa: Crie tarefas automaticamente a partir de faturas, contratos e documentos
• Operações em Massa: Gerencie vários arquivos de uma vez

Envio de Arquivo

Envie arquivos navegando até Arquivos → Enviar. Você pode:

• Arraste e solte vários arquivos de uma vez
• Associar arquivos a projetos específicos
• Ver o progresso do envio em tempo real
• Envie documentos até o limite do seu plano (10-100 MB)

Categorização Automática

O AskRobots organiza automaticamente seus arquivos usando reconhecimento inteligente de padrões:

• financial/invoices/2024/ - Para documentos de fatura
• contracts/vendor/active/ - Para acordos com fornecedores
• receipts/travel/2024/ - Para recibos de despesas
• personal/photos/vacation/ - Para imagens pessoais

Extração de Texto PDF

Todo PDF é processado automaticamente para:

• Extrair todo o texto para pesquisa
• Identificar informações-chave (datas, valores, nomes)
• Criar metadados pesquisáveis
• Habilitar pesquisa de texto completo em todos os documentos

Criação de Tarefas a Partir de Documentos

Envie documentos e deixe a IA criar tarefas automaticamente:

• Faturas → Tarefas de lembrete de pagamento com datas de vencimento
• Contratos → Tarefas de revisão e lembrete de renovação
• Notas de Reunião → Itens de ação como tarefas individuais
• Documentos do Projeto → Tarefas de entregáveis e marcos

Limites de Armazenamento por Plano

4. Objetos (Arquitetura 100x)

Objetos são código Python ao vivo que executa instantaneamente sem implantação. Esta é a arquitetura 100x - onde a IA edita o código, você atualiza o navegador e os recursos ficam disponíveis imediatamente.

Por que 100x?

O desenvolvimento tradicional leva 10-30 minutos por alteração (código, migrações, build, implantação, teste). Com Objetos, as alterações levam 10-30 segundos (editar código, atualizar navegador, pronto). Isso é 100x mais rápido em iteração.

Tipos de Objeto

Exemplo de Início Rápido

Veja como a IA cria uma view simples:

# Object: u_1_view_hello
# This renders at /v/hello/

def GET(request, context):
    name = context.get('params', {}).get('name', 'World')
    return {
        'html': f'<h1>Hello, {name}!</h1>',
        'title': 'Greeting'
    }

Acesse /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.

Exemplo de Armazenamento de Dados

# Object: u_1_deals (data store)
# Stores deals as JSON in _state_manager

def GET(request, context):
    deals = _state_manager.get('deals', [])
    return {'deals': deals, 'count': len(deals)}

def POST(request, context):
    deals = _state_manager.get('deals', [])
    new_deal = context.get('data', {})
    deals.append(new_deal)
    _state_manager.set('deals', deals)
    return {'status': 'added', 'count': len(deals)}

Usando Objetos via MCP

Sua IA (Claude Code, Cursor, etc.) pode criar e modificar objetos através da API MCP:

• create_object - Criar um novo objeto com código Python
• get_object_source - Ler código-fonte do objeto
• update_object_source - Modificar código do objeto
• execute_object - Chamar métodos do objeto (GET/POST/PUT/DELETE)
• get_object_state - Ler estado persistido do objeto

Isolamento de Objeto

Os objetos de cada usuário são isolados com prefixos:

• u_1_view_dashboard - View do painel do Usuário 1
• u_1_deals - Armazenamento de dados de negócios do Usuário 1
• views_landing - View do sistema (somente leitura)

Os usuários só podem ver e modificar seus próprios objetos. Os objetos do sistema estão disponíveis como exemplos somente leitura.

5. O Futuro do Gerenciamento de Tarefas Personalizável: Liberando o Poder dos Formulários Dinâmicos

Em uma era de evolução digital implacável, as formas como interagimos com plataformas online, gerenciamos tarefas e fluxos de trabalho estão em constante evolução.

Os sistemas tradicionais de gerenciamento de tarefas são estáticos, forçando os usuários a uma abordagem única para todos. Mas imagine um mundo onde cada tarefa, grande ou pequena, se encaixa perfeitamente. Bem-vindo ao nosso Sistema de Formulários Dinâmicos.

• Adaptabilidade: Evolua suas tarefas conforme as necessidades do seu negócio mudam.
• Eficiência: Use metadados para transferir dados, eliminar redundâncias e aumentar a velocidade.
• Personalização: Personalize cada elemento dos seus formulários.
• Escalabilidade: Gerencie projetos de qualquer escala ou complexidade sem esforço.

Mergulhe, explore e experimente o futuro do gerenciamento de tarefas conosco.

Entendendo o Sistema de Formulários Dinâmicos

Nosso sistema de gerenciamento de tarefas é projetado para oferecer flexibilidade e eficiência através de seus componentes principais: Metadados, JSON Schema e UI Schema. Cada um desempenha um papel crucial na criação e gerenciamento de formulários dinâmicos.

Metadados:

O que é?

Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.

Por que é importante?

Os metadados servem como a espinha dorsal para contextualizar tarefas. Eles facilitam a integração perfeita de dados em várias tarefas, garantindo que detalhes importantes sejam transmitidos. Essa continuidade é fundamental para manter eficiência e coerência no gerenciamento de tarefas.

JSON Schema (Esquema de Dados):

O que é?

O JSON Schema atua como o projeto arquitetônico dos seus dados de tarefa. Ele descreve os tipos de dados esperados, restrições e estrutura geral dos dados associados a cada tarefa.

Por que é importante?

O papel principal do schema é garantir a integridade e estrutura dos dados. Ao fornecer uma definição clara dos requisitos de dados, ele garante que todas as informações coletadas sejam consistentes, previsíveis e conformes com padrões estabelecidos. Isso é crucial para manter a qualidade dos dados e facilitar a automação e o processamento de dados.

UI Schema (Modelo de Visualização):

O que é?

O UI Schema é responsável pela representação visual da estrutura de dados definida pelo JSON Schema. Ele fornece opções de personalização para o layout e design de campos de formulário, widgets e outros elementos interativos.

Por que é importante?

O UI Schema preenche a lacuna entre as estruturas de dados do backend e a experiência do usuário no frontend. Sua importância reside na capacidade de adaptar a apresentação e interação com os dados para atender às necessidades específicas dos usuários e preferências estéticas. Essa personalização melhora o engajamento do usuário e garante uma interface mais intuitiva e amigável.

Dados JSON e Modelos de Tarefa

Comece com seus dados JSON. Não tem nenhum? Veja alguns exemplos aqui ou criar aqui.

JSON Schema (Esquema de Dados)

[ Imagem de código JSON ou diagrama UML aqui ]

Descreva seu objeto de formulário usando um arquivo JSON. Inclui nomes, tipos, valores e tamanhos dos campos.

Crie seu JSON schema aqui e visualize o formulário online.

UI Schema (Modelo de Visualização)

[ Imagem do código e seu wireframe de UI correspondente aqui ]

Use um arquivo JSON para listar os rótulos e opções da UI.

Interface do Usuário

[ Imagem da UI com dados, renderizada em Bootstrap aqui ]

O resultado final é exibido no formulário do trabalhador. Os resultados enviados são armazenados no blob campo.

Exemplos Básicos

• Verdadeiro ou Falso
• Múltipla escolha
• Responder Pergunta

Código de Exemplo:

• Python

6. Conta e Faturamento

O AskRobots usa um sistema de faturamento simples baseado em carteira. Adicione créditos conforme necessário, pague apenas pelo que usar, sem cobranças surpresa ou taxas ocultas.

Como Funciona Nosso Sistema de Carteira

Ao contrário das assinaturas tradicionais, nosso sistema de carteira oferece controle completo:

• Modelo Pré-pago: Adicione créditos entre $5-$100 a qualquer momento
• Sem Renovação Automática: Seu cartão nunca é cobrado sem sua permissão
• Baseado em Uso: Os créditos são deduzidos apenas quando você usa recursos de IA
• Nunca Expira: Seu saldo permanece até você usá-lo
• Total Transparência: Veja exatamente quanto custa cada operação de IA

Planos de Assinatura e Recursos

Embora o faturamento seja baseado em carteira, os planos determinam seus recursos e limites:

Custos de Uso de IA

As operações de IA são cobradas com base no uso real:

• GPT-4o-mini: ~$0,001 por requisição
• GPT-4: ~$0,03 por requisição
• Claude 3.5 Sonnet: ~$0,015 por requisição
• Análise de Imagem: ~$0,005 por imagem
• Processamento de PDF: ~$0,01 por documento

Os custos reais dependem da complexidade da requisição e do tamanho da resposta

Rastreamento de Uso

Monitore seu uso em tempo real:

• Painel: Veja o saldo da carteira e cobranças recentes
• Página de Uso de IA: Detalhamento por modelo e operação
• Histórico de Transações: Log completo de todas as cobranças
• Resumos Diários: Acompanhe os padrões de gastos

Métodos de Pagamento

Aceitamos todos os principais métodos de pagamento pelo Stripe:

• Cartões de Crédito (Visa, Mastercard, American Express, Discover)
• Cartões de Débito
• Carteiras Digitais (Apple Pay, Google Pay)
• Transferências Bancárias (para Empresarial)

Todos os pagamentos são processados com segurança pelo Stripe. Nunca armazenamos os dados do seu cartão.

Adicionando Créditos

1. Vá para Cobrança → Adicionar Fundos
2. Escolha o valor (mínimo $5, máximo $100)
3. Insira os dados de pagamento
4. Click "Add Funds"
5. Os créditos ficam disponíveis imediatamente

Procedimentos de Upgrade/Downgrade

Mudar de plano é simples e imediato:

Fazendo Upgrade do Seu Plano

1. Acesse a página de Planos
2. Selecione seu novo plano
3. As alterações entram em vigor imediatamente
4. O armazenamento e os limites aumentam imediatamente
5. Sem cobranças proporcionais - o sistema de carteira permanece igual

Fazendo Downgrade do Seu Plano

1. Certifique-se de estar dentro dos limites do plano inferior (armazenamento, etc.)
2. Acesse a página de Planos
3. Selecione o plano inferior
4. Talvez seja necessário excluir arquivos se exceder o novo limite de armazenamento
5. Os recursos são ajustados imediatamente

Notificações de Saldo Baixo

Iremos notificá-lo quando:

• O saldo cair abaixo de $5,00
• O saldo chegar a $0,00
• Uma operação falhar por saldo insuficiente

Histórico de Faturamento e Faturas

Acesse seu histórico completo de faturamento:

• Log de Transações: Cada cobrança com data/hora e descrição
• Extratos Mensais: Resumo de toda a atividade
• Opções de Exportação: Baixar como CSV ou PDF
• Documentos Fiscais: Resumos anuais para contabilidade

Encontre-os em: Cobrança → Histórico de Transações

Política de Reembolso

Oferecemos reembolso para:

• Saldo não utilizado na carteira (no encerramento da conta)
• Erros técnicos que resultaram em cobranças a mais
• Cobranças duplicadas

Entre em contato com support@askrobots.com em até 30 dias para solicitações de reembolso.

Faturamento Empresarial

Para organizações que precisam de:

• Faturamento por nota fiscal (NET 30)
• Descontos por volume
• Múltiplas contas de usuário
• Contratos personalizados

Entre em contato com sales@askrobots.com para opções Empresariais.

11. Documentação da API

Visão Geral da API

Nossa API permite que você interaja programaticamente com nossa plataforma, permitindo gerenciar tarefas, visualizar status e muito mais. Foi projetada para desenvolvedores que desejam integrar seus aplicativos ou automatizar fluxos de trabalho.

Métodos de Autenticação

Usamos autenticação baseada em token para proteger nossa API. Cada requisição deve incluir um token de API válido no cabeçalho. Os tokens podem ser obtidos através do painel do usuário. Você pode encontrar sua chave de API no painel ou através deste link.

Endpoints, Formatos de Requisição e Resposta

A API fornece vários endpoints para acessar diferentes funcionalidades. As requisições devem ser feitas em formato JSON, e as respostas também são retornadas como JSON. Aqui está um endpoint de exemplo para tarefas: https://askrobots.com/api/tasks/. Para uma lista detalhada de todos os endpoints disponíveis, seus métodos de requisição e formatos de resposta, consulte nossa documentação completa da API.

Listar Tarefas

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/

Detalhes da Tarefa

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/

Listar Modelos de Tarefa

curl -X GET \
            -H "Authorization: Token YOUR_API_TOKEN" \
            -H "Content-Type: application/json" \
            https://askrobots.com/api/tasktemplates/
    

Criar Uma Tarefa

         % curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title": "New Task with Template",
           "urgency": "normal",
           "template": "TEMPLATE_ID",
           "instructions": "Please follow the template guidelines",
           "json_form": {},
           "metadata": {},
           "priority": 1,
           "due_date": "2024-03-25T00:00:00Z",
           "project": "PROJECT_ID"
         }' \
     https://askrobots.com/api/tasks/
    

Listar Projetos

         % curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     https://askrobots.com/api/projects/
    

Referência de Endpoints da API

Abaixo está uma lista abrangente dos endpoints de API disponíveis:

curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"

{
  "query": "project",
  "total_count": 15,
  "types_searched": ["tasks", "notes"],
  "results": {
    "tasks": {
      "count": 10,
      "results": [
        {
          "id": "uuid",
          "type": "task",
          "title": "Create project dashboard",
          "snippet": "Build the main project...",
          "created_at": "2026-02-03T...",
          "project": {"id": "uuid", "name": "AskRobots"},
          "status": "open"
        }
      ]
    },
    "notes": {
      "count": 5,
      "results": [...]
    }
  }
}

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "content": "Discussed project timeline and deliverables",
       "project": "PROJECT_UUID"
     }' \
     https://askrobots.com/api/notes/

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Team Meeting",
       "start_date_time": "2025-06-15T14:00:00Z",
       "end_date_time": "2025-06-15T15:00:00Z",
       "description": "Weekly team sync",
       "project": "PROJECT_ID"
     }' \
     https://askrobots.com/api/events/

curl -X POST \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -F "file=@/path/to/document.pdf" \
     -F "project=PROJECT_UUID" \
     -F "description=Project documentation" \
     https://askrobots.com/api/files/upload/

# 1. Find claimable tasks
GET /api/tasks/claimable/?urgency=high&limit=5

# 2. Claim a task atomically
POST /api/tasks/{id}/claim/?timeout_minutes=30

# 3. Send heartbeats while working
POST /api/tasks/{id}/heartbeat/

# 4. Complete or release when done
POST /api/tasks/{id}/complete_simple/
# or
POST /api/tasks/{id}/release/

Formatos de resposta

Todas as respostas da API seguem um formato JSON consistente:

Resposta de sucesso (200 OK):

{
  "id": "uuid-here",
  "title": "Sample Note",
  "content": "This is the note content",
  "created_at": "2025-06-11T12:00:00Z",
  "updated_at": "2025-06-11T12:00:00Z",
  "user": "user-id",
  "project": "project-id"
}

Resposta de erro (400 Bad Request):

{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}

Resposta com paginação:

{
  "count": 45,
  "next": "https://askrobots.com/api/notes/?page=2",
  "previous": null,
  "results": [
    {
      "id": "uuid-1",
      "title": "Note 1",
      ...
    },
    {
      "id": "uuid-2", 
      "title": "Note 2",
      ...
    }
  ]
}

Limitação de taxa

As requisições da API são limitadas por taxa para garantir uso justo:

• 1000 requisições por hora para usuários autenticados
• 100 requisições por hora para requisições não autenticadas
• Informações de limite de taxa estão incluídas nos cabeçalhos de resposta:
  • X-RateLimit-Limit: Máximo de requisições permitidas
  • X-RateLimit-Remaining: Requisições restantes
  • X-RateLimit-Reset: Hora em que o limite é redefinido

Webhooks

Configure webhooks para receber notificações em tempo real quando eventos ocorrerem:

POST /api/webhooks/
{
  "url": "https://your-app.com/webhook",
  "events": ["task.created", "task.updated", "task.completed"],
  "active": true
}

SDKs e Bibliotecas

Fornecemos SDKs oficiais para as linguagens mais populares:

• Python: pip install askrobots-sdk
• JavaScript/Node: npm install @askrobots/sdk
• Ruby: gem install askrobots
• PHP: composer require askrobots/sdk

Exemplo de SDK Python:

from askrobots import Client

client = Client(api_key="YOUR_API_TOKEN")

# List tasks
tasks = client.tasks.list()

# Create a new task
new_task = client.tasks.create(
    title="Complete API documentation",
    urgency="high",
    project_id="PROJECT_ID"
)

# Update task status
client.tasks.update(new_task.id, status="completed")

Detalhes de autenticação

Obtendo tokens de API

1. Navegue até Configurações → Chaves de API
2. Click "Generate New Token"
3. Dê ao seu token um nome descritivo
4. Copie o token imediatamente (ele não será exibido novamente)
5. Armazene-o com segurança em sua aplicação

Usando tokens nas requisições

Inclua seu token no cabeçalho Authorization de cada requisição:

Authorization: Token YOUR_API_TOKEN

Exemplo com diferentes ferramentas:

# curl
curl -H "Authorization: Token YOUR_API_TOKEN" https://askrobots.com/api/tasks/

# Python requests
import requests
headers = {"Authorization": "Token YOUR_API_TOKEN"}
response = requests.get("https://askrobots.com/api/tasks/", headers=headers)

# JavaScript fetch
fetch('https://askrobots.com/api/tasks/', {
    headers: {
        'Authorization': 'Token YOUR_API_TOKEN'
    }
});

Limites de taxa

Os limites de taxa da API são baseados no seu plano de assinatura:

Cabeçalhos de limite de taxa

Cada resposta inclui informações de limite de taxa:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432

Códigos de erro

A API usa códigos de status HTTP padrão e retorna respostas de erro em JSON:

Paginação

Os endpoints de listagem retornam resultados paginados com 20 itens por página por padrão:

{
    "count": 150,
    "next": "https://askrobots.com/api/tasks/?page=2",
    "previous": null,
    "results": [...]
}

Controle a paginação com parâmetros de consulta:

• page - Número da página (padrão: 1)
• page_size - Itens por página (máx: 100)

Filtragem e pesquisa

A maioria dos endpoints de listagem suporta filtragem:

# Filter tasks by project
/api/tasks/?project=PROJECT_ID

# Filter by status
/api/tasks/?status=open

# Search tasks
/api/tasks/?search=invoice

# Combine filters
/api/tasks/?project=PROJECT_ID&status=open&urgency=high

Webhooks

Configure webhooks para receber notificações em tempo real:

Eventos de webhook

• task.created - Nova tarefa criada
• task.completed - Tarefa marcada como concluída
• file.uploaded - Arquivo enviado
• file.processed - Processamento de arquivo concluído
• wallet.low_balance - Saldo abaixo de $5

Exemplo de payload de webhook

{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

Boas práticas de API

• Respostas em cache sempre que possível para reduzir chamadas à API
• Lide com limites de taxa de forma adequada com recuo exponencial
• Use webhooks em vez de polling para atualizações em tempo real
• Operações em lote ao criar múltiplos recursos
• Inclua apenas os campos necessários com parâmetros de seleção de campos
• Use paginação adequadamente para grandes conjuntos de dados
• Armazene tokens com segurança e os rotacione regularmente

7. Segurança e Privacidade

O AskRobots é construído com segurança e privacidade em seu núcleo. Implementamos as melhores práticas do setor para proteger seus dados e garantir conformidade com as regulamentações de privacidade.

Isolamento de Dados

Os dados de cada usuário são completamente isolados:

• Segurança em nível de linha: Todas as consultas ao banco de dados são filtradas por ID de usuário
• Sem dados compartilhados: Seus arquivos, tarefas e projetos nunca são acessíveis a outros usuários
• Isolamento de API: A autenticação baseada em token garante que o acesso aos dados seja específico por usuário
• Limites de projeto: Mesmo dentro de equipes, o acesso é controlado no nível do projeto

Criptografia

Usamos múltiplas camadas de criptografia para proteger seus dados:

• Em trânsito: Todas as conexões usam criptografia TLS 1.3
• Em repouso: Os arquivos são criptografados usando criptografia AES-256
• Banco de dados: Campos sensíveis usam criptografia no nível da aplicação
• Backups: Todos os backups são criptografados antes do armazenamento

Procedimentos de backup

Seus dados são protegidos por estratégias abrangentes de backup:

• Backups diários automatizados de todos os bancos de dados
• Retenção de 30 dias para recuperação em um ponto específico no tempo
• Testes regulares de restauração para garantir a integridade dos backups

Permissões de Usuário

Controles de permissão granulares:

• Acesso baseado em função: Funções de Administrador, Usuário e Trabalhador
• Permissões de projeto: Controle quem pode visualizar, editar ou gerenciar projetos
• Permissões de API: Tokens separados para diferentes níveis de acesso
• Registro de auditoria: Rastrear todas as alterações de permissão

Segurança da API

Nossa API implementa múltiplas medidas de segurança:

• Autenticação por token: Tokens de API seguros que podem ser revogados
• Limitação de taxa: Previna abusos com limites de taxa inteligentes
• Validação de entrada: Todas as entradas são higienizadas e validadas
• Proteção CORS: Compartilhamento controlado de recursos entre origens

Conformidade com LGPD/GDPR

Respeitamos seus direitos de privacidade conforme o GDPR:

• Direito de acesso: Exporte todos os seus dados a qualquer momento
• Direito ao apagamento: Exclua sua conta e todos os dados associados
• Portabilidade de dados: Exporte dados em formatos padrão (JSON, CSV)
• Privacidade por design: Privacidade considerada em todas as funcionalidades
• Minimização de dados: Coletamos apenas os dados necessários

Políticas de retenção de dados

Políticas claras sobre por quanto tempo mantemos seus dados:

• Contas ativas: Dados mantidos enquanto a conta estiver ativa
• Itens excluídos: Excluídos temporariamente por 30 dias e depois removidos permanentemente
• Contas inativas: Notificação após 12 meses, exclusão após 18 meses
• Contas com saldo negativo: Período de carência de 90 dias antes da remoção dos dados
• Registros de auditoria: Mantidos por 1 ano para fins de segurança

Opções de Exportação de Dados

Você é dono dos seus dados e pode exportá-los a qualquer momento:

• Exportação completa da conta: Todos os dados em um único arquivo ZIP
• Exportação seletiva: Escolha projetos específicos ou intervalos de datas
• Múltiplos formatos: JSON, CSV, PDF para diferentes tipos de dados
• Acesso via API: Exportação programática via nossa API REST
• Sem dependência de fornecedor: Formatos padrão garantem portabilidade

Melhores práticas de segurança para usuários

Ajude-nos a manter sua conta segura:

• Senhas fortes: Use senhas únicas e complexas
• Autenticação de dois fatores: Ative a autenticação de dois fatores quando disponível
• Gerenciamento de tokens de API: Rotacione os tokens regularmente
• Monitorar acesso: Revise seus registros de atividade periodicamente
• Reportar problemas: Entre em contato imediatamente se suspeitar de acesso não autorizado