API Reference - Integrabot

A API REST do Integrabot permite que você integre os recursos da plataforma diretamente no seu sistema. Crie leads a partir de formulários web, sincronize contatos com seu CRM ou automatize fluxos de trabalho com os agents de IA. Base URL: https://api.integrabot.ai Content-Type: application/json

Autenticação

Todas as requisições precisam de uma API Key enviada no header Authorization como Bearer token. As API Keys do Integrabot começam com o prefixo sk_.

Nunca exponha sua API Key no lado do cliente (JavaScript do navegador, apps mobile). Use sempre no backend ou em serviços seguros.

Gerando uma API Key

Acesse o painel do Integrabot em app.integrabot.ai
Abra o modal de Configurações (ícone de engrenagem)
Navegue até a seção API Keys
Clique em Gerar nova chave
Copie a chave gerada (ela não será exibida novamente)

Exemplo de requisição

curl -X GET https://api.integrabot.ai/v1/leads \
  -H "Authorization: Bearer sk_sua_api_key_aqui" \
  -H "Content-Type: application/json"

Rate Limiting

A API tem um limite de 60 requisições por minuto por API Key. Se você ultrapassar esse limite, receberá uma resposta 429 Too Many Requests com o header Retry-After indicando quantos segundos aguardar.

Respostas de Erro

Todas as respostas de erro seguem o formato:

{
  "error": "Tipo do erro",
  "message": "Descrição detalhada do erro"
}

Status	Significado
401	API Key inválida ou ausente
404	Recurso não encontrado
422	Erro de validação nos dados enviados
429	Limite de requisições excedido
500	Erro interno do servidor