o2o-site-AEO/docs/TEAMS_WEBHOOK.md
Mina Choi 0f7d22750f [fix] solution/backend: Teams 카드 필수 필드 보완
웹훅 요청의 contentUrl 및 스키마 선언 누락을 공식 형식에 맞춤. HTTP 202와 채널 게시 성공을 구분하도록 검증 한계 기록.

검증: Teams 요청 형식 회귀 테스트 1건 통과. 워크플로 실제 수신은 별도 확인 필요.
2026-09-15 15:55:59 +09:00

853 B

Teams 웹훅 확인 (2026-09-15)

  • Adaptive Card 요청의 contentUrl: null 및 $schema를 공식 예제에 맞춰 보완했다.
  • HTTP 202는 워크플로의 요청 접수다. Teams 채널 게시 성공을 뜻하지 않는다.
  • 실제 전송 2건은 202였지만 사용자가 확인한 워크플로 실행은 실패였다. 상세 오류를 확인하지 못했으므로 누락 필드를 실제 실패 원인으로 단정하지 않는다.
  • 운영 자동 알림 활성화 전, 채널 수신 또는 워크플로의 최종 게시 단계 성공을 확인해야 한다.
  • 웹훅은 .env에만 보관하고 커밋하지 않는다.

검증: 백엔드에서 APP_ENV=test PYTHONPATH=. .venv/bin/pytest tests/test_search_console_alerts.py --confcutdir=tests. 공식 형식: https://learn.microsoft.com/en-us/connectors/teams/#adaptivecarditemschema