Introdução

​

Visão geral

• Agentes — criação, configuração e gerenciamento de agentes IA
• Treinamentos — gestão da base de conhecimento dos agentes
• Canais — configuração de canais de comunicação (WhatsApp, Telegram, Email, Website)
• Contatos — cadastro e gerenciamento de clientes
• Leads — controle do funil de vendas com scoring e qualificação
• Oportunidades — acompanhamento de negócios e valores
• Pipeline — visualização das colunas do pipeline de vendas
• Conversas — histórico de conversas, envio de mensagens e handoff humano
• Campos Personalizados — definição de campos customizados para o CRM
• Interações — consulta e gerenciamento de interações com filtros avançados
• Intenções — configuração de intenções dos agentes IA
• Ações de Inatividade — ações automáticas quando o cliente fica inativo
• Regras de Transferência — regras para transferência automática de atendimento
• MCP Servers — gerenciamento de servidores Model Context Protocol
• Chats — gerenciamento de mensagens, edição e handoff humano

​

Base URL

https://api.timelyai.com.br

​

Autenticação

curl -H "x-api-key: sua_chave_aqui" \
  https://api.timelyai.com.br/v1/me

​

Scopes

​

Rate limiting

​

Paginação

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}

​

Formato de erros

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "customer_name: String must contain at least 1 character(s)",
    "status": 400
  }
}