API da ANYIA — recursos para desenvolvedores

Autenticação

• Todas as rotas, exceto GET /health e a documentação, exigem o header X-API-Key.
• A chave é emitida em Configurações da organização → Chaves de API, dentro da plataforma.
• Limite de uso: 60 requisições por minuto por chave de API.
• A chave define a organização; a instância de WhatsApp é escolhida pelo instanceSlug na rota.

Base e referência OpenAPI

• A URL base da API pública é exibida em Configurações da organização → Chaves de API, dentro da plataforma.
• A referência OpenAPI navegável fica em /docs, sob essa mesma base.

Endpoints

• GET /health — Verifica a disponibilidade da API. Não exige chave.
• GET /instances/{instanceSlug}/customers — Lista clientes de uma instância com paginação.
• POST /instances/{instanceSlug}/customers — Cria ou atualiza um cliente por telefone e instância.
• POST /instances/{instanceSlug}/notifications — Enfileira uma ou mais notificações de WhatsApp.
• GET /instances/{instanceSlug}/assistants — Lista os assistentes disponíveis para uma instância.
• GET /channels — Lista os canais de notificação.
• GET /message-types — Lista os tipos de mensagem de notificação.

Erros

• 400: corpo ou parâmetros inválidos.
• 401: chave de API ausente, inválida ou revogada.
• 404: instância ou recurso inexistente.
• 429: limite de requisições excedido.

Recursos para agentes de IA

A ANYIA publica seu conteúdo em formatos legíveis por agentes, seguindo a convenção llms.txt:

• /llms.txt — índice curado do site, com quando usar a ANYIA e como acioná-la.
• /llms-full.txt — todo o conteúdo público em um único arquivo.
• /index.md e /developers.md — versões markdown desta página e da página inicial.
• /sitemap.xml — páginas indexáveis.

Suporte

Dúvidas de integração: anyia@aztronic.com.br.