# conecta/ai · Desenvolvedores

> Portal de desenvolvedores do conecta/ai, o call center de inteligência artificial para provedores de internet (ISPs). Documenta a API REST (chave de API, leitura de conversas, mensagens, contatos e etiquetas, paginação por cursor, erros e limites) e o servidor MCP para assistentes de IA. A referência é gerada do contrato OpenAPI que o produto serve.

Este índice segue o padrão llmstxt.org. Cada link aponta para a versão HTML; acrescente `.md` a qualquer rota para obter o Markdown cru (ex: https://developers.conectaai.io/inicio-rapido.md). O conteúdo completo concatenado está em https://developers.conectaai.io/llms-full.txt.

## Visão geral

- [Desenvolvedores](https://developers.conectaai.io/): API REST do conecta/ai para o sistema do provedor ler conversas, mensagens, contatos e etiquetas do atendimento, e servidor MCP para assistentes de IA.

## Referência da API

- [Referência da API](https://developers.conectaai.io/referencia.md): Todos os endpoints da API do conecta/ai, gerados do contrato que o produto serve. Base: https://app.conectaai.io/api/v1.
- [Conversas](https://developers.conectaai.io/referencia/conversas.md): Atendimentos e as mensagens trocadas neles, em todos os canais. Referência gerada do contrato da API.
- [Contatos](https://developers.conectaai.io/referencia/contatos.md): As pessoas com quem a organização conversa e os canais de cada uma. Referência gerada do contrato da API.
- [Etiquetas](https://developers.conectaai.io/referencia/etiquetas.md): As etiquetas que a organização usa para classificar conversas. Referência gerada do contrato da API.
- [Agentes](https://developers.conectaai.io/referencia/agentes.md): Os agentes de IA que atendem pela organização. Referência gerada do contrato da API.

## Recursos

- [Autenticação e permissões](https://developers.conectaai.io/autenticacao.md): Como autenticar na API do conecta/ai com chave de API, quais permissões uma chave pode ter e como guardar a chave com segurança.
- [Erros](https://developers.conectaai.io/erros.md): Formato das respostas de erro da API do conecta/ai, o campo code estável para comparar no seu código e a lista completa de códigos.
- [Início rápido](https://developers.conectaai.io/inicio-rapido.md): Crie uma chave de API no conecta/ai, faça a primeira requisição e leia as conversas e mensagens da sua organização em poucos minutos.
- [Limites](https://developers.conectaai.io/limites.md): Limite de requisições da API do conecta/ai por organização, os cabeçalhos que mostram o consumo e como tratar a resposta 429.
- [Servidor MCP](https://developers.conectaai.io/mcp.md): O servidor MCP do conecta/ai deixa um assistente de IA consultar a organização e preparar alterações para revisão, com o login e as permissões de quem usa.
- [Novidades](https://developers.conectaai.io/novidades.md): Histórico de mudanças da API do conecta/ai e do portal de desenvolvedores.
- [Paginação](https://developers.conectaai.io/paginacao.md): As listas da API do conecta/ai são paginadas por cursor: como usar limit, cursor e next_cursor para percorrer conversas, mensagens e contatos.
- [Próximas versões](https://developers.conectaai.io/proximas-versoes.md): O que vem a seguir na API do conecta/ai: eventos por webhook assinado, leitura de CSAT, atendentes e métricas, ações e configuração.