portal-aiatende-api

Cliente TypeScript tipado para a API interna do Portal AI Atende (portal.aiatende.com.br).

Instalação

npm install portal-aiatende-api

Uso

import { PortalClient } from 'portal-aiatende-api';

const portal = new PortalClient({
  apiKey: process.env.AIATENDE_API_KEY!,
});

const client = await portal.clients.getByKommoSubdomain('meusubdominio');
const client2 = await portal.clients.getByWazzupChannelId('channel-id');

const context = await portal.knowledge.getInternalContext({
  clientId: client!.id,
  userQuery: embeddingVector, // number[]
});

Tratamento de erros

import { PortalApiError } from 'portal-aiatende-api';

try {
  await portal.clients.getByKommoSubdomain('subdominio-invalido');
} catch (err) {
  if (err instanceof PortalApiError) {
    console.log(err.status);
    console.log(err.raw);
  }
}

Escopo

Cobre hoje apenas os endpoints consumidos pelo atende360-assistant: GET /api/clients (por kommo_subdomain ou channelId) e POST /api/knowledge/internal/context. Novos endpoints podem ser adicionados sob demanda, seguindo o mesmo padrão de recursos (src/resources/<nome>/{index.ts,types.ts}).