Pular para o conteúdo principal

Guia de Testes com Postman (simulando Teams)

Objetivo​

Simular chamadas do Microsoft Teams localmente para validar fluxos do bot antes da publicação oficial.

Arquivos​

ArquivoDescrição
docs/postman/BI-Agent-Local.postman_collection.jsonColeção com todos os fluxos
docs/postman/BI-Agent-Local.postman_environment.jsonAmbiente local (porta 3000)
docs/postman/BI-Agent-Docker.postman_environment.jsonAmbiente Docker (porta 3900)

Evidência de validação (17/02/2026)​

  • GET /health → 200 com status operacional.
  • POST /api/messages KPI → 200 com card e acentuação correta.
  • Fluxo de exportação ponta a ponta:
    1. exportar vendas para excel → 200 (solicita confirmação)
    2. confirmar → 202 (processamento iniciado)

Pré-requisitos​

npm install
# Iniciar servidor local com auth desabilitado
ALLOW_ANONYMOUS=true DISABLE_QUEUE_SEND=true \
  npm run dev:local -w @bi-agent/bot-handler

Sequência de execução recomendada​

  1. Health
  2. Message - Echo
  3. KPI Query
  4. Channel - without mention
  5. Channel - with mention
  6. Export - request
  7. Export - confirm
  8. Grant - request as admin
  9. Grant - confirm
  10. Restricted KPI after grant

Observação sobre payload mínimo​

Em testes via HTTP direto, envie sempre um payload de Activity do Bot Framework completo:

{
  "type": "message",
  "text": "status",
  "conversation": { "id": "test-conv" },
  "channelId": "msteams",
  "from": { "id": "test-user" }
}

Limitações​

  • Não substitui Teams/Entra ID reais.
  • Não valida publicação no Teams Admin Center.