asasolutions/aes-pindrop

Avaya AES与Pindrop API集成容器

镜像概述和主要用途

该Docker镜像封装了一个用于集成Avaya AES（Application Enablement Services）系统与Pindrop API的应用程序。其核心功能是建立与Avaya AES服务器的稳定连接，实时监控系统事件（如呼叫建立、状态变更等），并在事件触发时自动调用Pindrop API，将呼叫唯一标识符（UCID）和坐席分机号作为关键参数传递，实现Avaya通信系统与Pindrop服务的无缝数据交互。

核心功能和特性

1. Avaya AES事件监控

• 支持与Avaya AES服务器建立持久连接，实时监听指定事件类型
• 可配置事件过滤规则，仅处理目标事件（如呼叫发起、转接等）
• 内置连接保活机制，确保事件监控的连续性

2. Pindrop API集成

• 原生支持Pindrop API调用，包含请求认证、参数封装和响应处理
• 自动提取事件中的UCID（呼叫唯一标识符）和坐席分机号并传递至API
• 支持API调用错误重试（可配置重试次数和间隔）

3. 数据交互可靠性

• 事件触发后即时执行API调用，确保数据传递的时效性
• 内置日志记录功能，可追踪事件处理流程和API调用结果

使用场景和适用范围

典型使用场景

• 呼叫中心身份验证：在呼叫进入呼叫中心时，通过Avaya AES捕获呼叫事件，调用Pindrop API进行用户身份验证
• 欺诈检测集成：将Avaya AES的呼叫事件与Pindrop欺诈检测服务联动，实现实时风险评估
• 呼叫数据同步：将Avaya系统中的呼叫标识信息（UCID）与Pindrop服务数据关联，支持后续数据分析和审计

适用范围

• 目标用户：企业IT管理员、DevOps工程师、系统集成商
• 行业领域：***、电信、零售等部署Avaya通信系统的呼叫中心或客服中心
• 前置条件：已部署Avaya AES服务器并启用事件通知功能；拥有Pindrop API访问权限（含API密钥和端点URL）

使用方法和配置说明

环境变量配置

运行容器前需通过环境变量配置关键参数，以下为必填及可选配置项：

Docker运行示例

基础运行命令

bash
docker run -d \
  --name avaya-pindrop-integration \
  -e AVAYA_AES_HOST="aes-prod.example.com" \
  -e AVAYA_AES_PORT="4722" \
  -e AVAYA_AES_USER="aes-event-monitor" \
  -e AVAYA_AES_PASSWORD="AES@Passw0rd!" \
  -e PINDROP_API_URL="https://api.pindrop.com/v1/call-event" \
  -e PINDROP_API_KEY="pk_1234567890abcdef" \
  -e LOG_LEVEL="INFO" \
  avaya-aes-pindrop-integration:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  avaya-pindrop:
    image: avaya-aes-pindrop-integration:latest
    container_name: avaya-pindrop-integration
    environment:
      - AVAYA_AES_HOST=aes-prod.example.com
      - AVAYA_AES_PORT=4722
      - AVAYA_AES_USER=aes-event-monitor
      - AVAYA_AES_PASSWORD=AES@Passw0rd!
      - PINDROP_API_URL=https://api.pindrop.com/v1/call-event
      - PINDROP_API_KEY=pk_1234567890abcdef
      - LOG_LEVEL=INFO
      - API_RETRY_COUNT=3
      - API_RETRY_DELAY=2
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

验证与故障排查

1. 运行状态验证
   启动容器后，通过以下命令检查运行状态及日志：

   bash
   # 查看容器状态
   docker ps --filter "name=avaya-pindrop-integration"
   
   # 查看实时日志
   docker logs -f avaya-pindrop-integration
   

2. 常见问题排查

   • Avaya AES连接失败：检查AVAYA_AES_HOST、AVAYA_AES_PORT配置及网络连通性，确认AES服务器已启用事件服务
   • Pindrop API调用失败：检查PINDROP_API_URL、PINDROP_API_KEY有效性，通过日志确认API返回错误码
   • 事件未触发API调用：检查事件过滤规则配置，确认目标事件类型已被监控

注意事项

• 敏感配置（如密码、API密钥）建议通过容器编排平台的密钥管理功能注入，避免明文存储
• 生产环境中建议配置日志持久化（如挂载日志目录），便于问题追溯和审计
• 需根据Avaya AES和Pindrop API的版本兼容性调整容器配置，确保参数格式匹配