Desenvolvedores

Visão geral da API HTTP

Mapa conceitual das APIs do FlexyAgents: autenticação, chat do agente, streaming, limites de rate e links para referência de API de plataforma.

apireststreamingbearer token

O FlexyAgents expõe endpoints HTTPS para chat programático e operações relacionadas. O host do seu deploy determina URLs base — use valores do seu ambiente, não exemplos genéricos rígidos de documentação.

Para tabelas de endpoints, amostras de request/response e shapes de webhook, use a página Plataforma → API do marketing e sua especificação OpenAPI publicada, se existir.

Autenticação

Tokens Bearer identificam organizações e conexões. Limite chaves ao mínimo de agentes necessários.

Prefira tokens de vida curta ou políticas de rotação onde o produto suportar.

Chat e streaming

Endpoints estilo POST aceitam mensagens e retornam saída do modelo; variantes streaming emitem eventos incrementais adequados para consumidores SSE ou NDJSON.

Trate desconexões com grace — retomada de UX não deve duplicar efeitos colaterais se o client retentar.

Limites de rate e erros

Limites protegem infraestrutura compartilhada; aplique backoff com jitter em 429.

Registre corpos de erro com moderação em produção; podem conter conteúdo de usuário.

Alguns endpoints de upload de conhecimento retornam HTTP 402 quando cotas mensais hospedadas de descrição de imagem IA ou transcrição de mídia se esgotam; payloads de erro podem incluir código legível por máquina — trate na sua integração para pedir a admins chave Gemini ou aumento de limites do plano.

Construa com seu stack

Pronto para implantar assistentes fundamentados?

Inicie um teste ou fale conosco sobre implantação, governança e requisitos empresariais.