Referencia da API REST

Todos os endpoints da API sao prefixados com /api/ e requerem autenticacao via cookie de sessao. Todas as requisicoes e respostas usam Content-Type: application/json.

---

Conversas

Endpoint	Metodo	Descricao
/api/conversations	GET	Listar conversas (filtros: status, channel_type, tag, search, page)
/api/conversations/{id}	GET	Obter conversa (reseta unread_count)
/api/conversations	POST	Criar conversa
/api/conversations/{id}/status	POST	Atualizar status
/api/conversations/{id}/tags	POST	Adicionar tag
/api/conversations/{id}/tags/{tag}	DELETE	Remover tag
/api/conversations/{id}/assign	POST	Atribuir agente

Mensagens

Endpoint	Metodo	Descricao
/api/conversations/{id}/messages	GET	Listar mensagens
/api/conversations/{id}/messages	POST	Enviar mensagem

Sugestao de IA

Endpoint	Metodo	Descricao
/api/ai-suggest?conversation_id={id}	GET	Obter sugestao de resposta da IA

Contatos

Endpoint	Metodo	Descricao
/api/contacts	GET	Listar contatos
/api/contacts/{id}	GET	Obter contato
/api/contacts	POST	Criar contato
/api/contacts/{id}	PATCH	Atualizar contato
/api/contacts/{id}	DELETE	Excluir contato (admin)

Canais (Somente Admin)

Endpoint	Metodo	Descricao
/api/channels	GET	Listar canais
/api/channels	POST	Criar canal
/api/channels/{id}	PATCH	Atualizar canal
/api/channels/{id}	DELETE	Excluir canal

Automacoes (Somente Admin)

Endpoint	Metodo	Descricao
/api/automations	GET	Listar automacoes
/api/automations	POST	Criar automacao
/api/automations/{id}/toggle	POST	Alternar ativo/inativo
/api/automations/{id}	DELETE	Excluir automacao

Analises

Endpoint	Metodo	Descricao
/api/analytics?days=30	GET	Obter dados de analise

Agentes (Somente Admin)

Endpoint	Metodo	Descricao
/api/agents	GET	Listar agentes
/api/agents	POST	Criar agente
/api/agents/{id}/role	POST	Atualizar funcao
/api/agents/{id}	DELETE	Excluir agente

Configuracoes

Endpoint	Metodo	Descricao
/api/settings/workspace	GET	Obter configuracoes do workspace
/api/settings/workspace	POST	Atualizar workspace (admin)
/api/settings/password	POST	Alterar senha

---

Formato de Erro

{"error": "Human-readable error message"}

Codigo	Significado
200	Sucesso
201	Criado
400	Requisicao Invalida
401	Nao Autenticado
403	Proibido
404	Nao Encontrado
409	Conflito
500	Erro Interno