申请抢先体验

请输入您的名字和公司电子邮箱地址。我们会发送确认 Tajo 访问申请的链接。

Twilio Flex 连接器

连接器状态: 计划中尚未构建。Tajo 目前不运行此连接器。

示意图 · 示例数据

同步示例

检查一条记录

来源

Twilio Flex

连接器状态: 计划中

目标

您的另一款工具

连接器状态: 自定义工具

字段映射

来源字段	目标字段	示例值
`record.id`	`source_id`	`record_1042`
`record.updated_at`	`updated_at`	`2026-10-18T08:00:00Z`
`record.value`	`value`	`sample_value`

起草
检查一条记录
批准此版本

状态仅针对各个连接器，不保证此同步已就绪。字段仅供示意。运行同步前，请检查实际架构和权限。

通过 Tajo 将您的 Twilio Flex 联络中心连接到 Brevo，实现统一的客户互动历史、会话后营销流程和支持驱动的互动分析。

概览

属性	值
平台	Twilio Flex
类别	自定义
设置复杂度	高级
官方集成	否
同步数据	用户、会话、事件
使用的 API	Flex API、Conversations API、TaskRouter API
认证方式	Account SID + Auth Token / API 密钥
基础 URL	`https://flex-api.twilio.com`

功能

会话同步 - 将语音、短信、WhatsApp 和聊天互动转发到 Brevo 时间线
客户档案富化 - 将 Flex 客户数据同步到 Brevo 联系人属性
会话后活动 - 支持会话结束后触发 Brevo 工作流
CSAT 事件跟踪 - 将满意度调查结果作为 Brevo 事件同步
坐席活动数据 - 追踪坐席绩效指标，用于运营报告
队列分析 - 转发等待时间和放弃数据，用于体验优化

前提条件

开始之前，请确保您已具备：

已启用 Flex 的 Twilio 账户
Twilio Account SID 和 Auth Token
具有活跃频道（语音、短信、聊天或 WhatsApp）的 Flex 实例
已配置 TaskRouter 工作区
具有 API 访问权限的 Brevo 账户
具有有效订阅的 Tajo 账户

认证

Twilio Flex 使用 Twilio 的标准认证方式。

账户凭据

# Basic Auth: Account SID as username, Auth Token as password
curl -X GET "https://flex-api.twilio.com/v1/Configuration" \
  -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN"

API 密钥（推荐用于生产环境）

前往 Twilio 控制台 > 账户 > API 密钥和令牌
点击创建 API 密钥
选择标准密钥类型
安全存储 SID 和密钥

curl -X GET "https://flex-api.twilio.com/v1/Configuration" \
  -u "$TWILIO_API_KEY_SID:$TWILIO_API_KEY_SECRET"

Auth Token 与 API 密钥

您的 Auth Token 具有完整账户访问权限。生产环境请使用范围化的 API 密钥。API 密钥可单独撤销，不会影响其他集成。

连接到 Tajo

tajo connectors install twilio-flex \
  --account-sid $TWILIO_ACCOUNT_SID \
  --auth-token $TWILIO_AUTH_TOKEN \
  --flex-flow-sid $TWILIO_FLEX_FLOW_SID

配置

基础设置

connectors:
  twilio_flex:
    enabled: true
    account_sid: "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
    flex_flow_sid: "FOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

    sync:
      conversations: true
      tasks: true
      customers: true
      csat: true
      agent_activity: false

    lists:
      support_contacts: 32
      csat_respondents: 33

    channels:
      - voice
      - sms
      - whatsapp
      - webchat

字段映射

将 Flex 客户和互动数据映射到 Brevo 属性：

field_mapping:
  # Customer fields
  identity: FLEX_IDENTITY
  friendly_name: FIRSTNAME
  attributes.email: email
  attributes.phone: SMS

  # Interaction metrics
  last_conversation_date: LAST_SUPPORT_DATE
  total_conversations: SUPPORT_TICKET_COUNT
  avg_wait_time: AVG_WAIT_TIME
  last_csat_score: CSAT_SCORE
  preferred_channel: PREFERRED_CHANNEL

  # Custom attributes
  customer_tier: VIP_TIER
  account_id: ACCOUNT_ID

事件映射

event_mapping:
  task.created: SUPPORT_REQUESTED
  task.completed: SUPPORT_RESOLVED
  task.canceled: SUPPORT_ABANDONED
  conversation.ended: CONVERSATION_ENDED
  survey.completed: CSAT_SUBMITTED

API 端点

Tajo 集成以下 Twilio Flex 及相关 API 端点：

端点	方法	API	用途
`/v1/Configuration`	GET	Flex	获取 Flex 配置
`/v1/Interactions`	GET	Flex	列出互动
`/v1/Channels`	GET	Flex	列出 Flex 频道
`/v1/WebChannels`	POST	Flex	创建网页聊天频道
`/v1/Conversations`	GET	Conversations	列出会话
`/v1/Conversations/{sid}/Messages`	GET	Conversations	列出会话消息
`/v1/Conversations/{sid}/Participants`	GET	Conversations	列出参与者
`/v1/Workspaces/{sid}/Tasks`	GET	TaskRouter	列出任务
`/v1/Workspaces/{sid}/Workers`	GET	TaskRouter	列出工作人员（坐席）
`/v1/Workspaces/{sid}/TaskQueues`	GET	TaskRouter	列出任务队列
`/v1/Workspaces/{sid}/Events`	GET	TaskRouter	列出工作区事件

代码示例

初始化连接器

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('twilio-flex', {
  accountSid: process.env.TWILIO_ACCOUNT_SID,
  authToken: process.env.TWILIO_AUTH_TOKEN,
  flexFlowSid: process.env.TWILIO_FLEX_FLOW_SID
});

同步会话历史

await tajo.connectors.sync('twilio-flex', {
  type: 'incremental',
  resources: ['conversations'],
  since: '2024-01-01',
  channels: ['voice', 'sms', 'whatsapp']
});

const status = await tajo.connectors.status('twilio-flex');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T16:00:00Z',
//   conversationsTracked: 12400,
//   customersLinked: 8900,
//   agentsMonitored: 45
// }

会话后活动触发

// Trigger a Brevo follow-up after a support conversation ends
app.post('/webhooks/flex/task-complete', async (req, res) => {
  const task = req.body;

  await tajo.connectors.handleEvent('twilio-flex', {
    type: 'task.completed',
    payload: {
      taskSid: task.TaskSid,
      customerEmail: task.TaskAttributes?.email,
      channel: task.TaskChannelUniqueName,
      duration: task.Age,
      queueName: task.TaskQueueFriendlyName
    }
  });

  res.status(200).send('OK');
});

Flex 插件集成

// Inside a Flex UI Plugin - send data to Tajo
import { FlexPlugin } from '@twilio/flex-plugin';

class TajoPlugin extends FlexPlugin {
  init(flex, manager) {
    flex.Actions.addListener('afterCompleteTask', async (payload) => {
      await fetch('https://api.example.com/webhooks/flex/task-complete', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          TaskSid: payload.task.sid,
          TaskAttributes: payload.task.attributes,
          TaskChannelUniqueName: payload.task.taskChannelUniqueName,
          Age: payload.task.age
        })
      });
    });
  }
}

Caution

上面的 example.com 地址是占位值，在 Tajo 端点可用之前仅作示例。

速率限制

Twilio 跨其 API 实施速率限制：

API	速率限制	说明
Flex API	100 请求/秒	每账户
Conversations API	100 请求/秒	每账户
TaskRouter API	30 读取请求/秒	每工作区
TaskRouter 事件	20 请求/秒	每工作区

事件流

对于高流量事件处理，考虑使用 Twilio 事件流而非轮询 TaskRouter 事件。事件流通过 Webhook 或 Kinesis 实时推送事件。

故障排除

常见问题

问题	原因	解决方案
401 Unauthorized	SID 或令牌无效	在 Twilio 控制台中验证 Account SID 和 Auth Token
403 Forbidden	Flex 未启用	确保您的 Twilio 账户已激活 Flex
会话缺失	日期范围错误	扩展同步日期范围或检查会话状态
任务未追踪	TaskRouter 工作区不匹配	验证正确的工作区 SID
插件未触发	事件监听器未注册	检查 Flex 插件是否已部署并激活

调试模式

connectors:
  twilio_flex:
    debug: true
    log_level: verbose
    log_api_calls: true

测试连接

tajo connectors test twilio-flex
# ✓ Flex API connection successful
# ✓ Conversations API accessible
# ✓ TaskRouter workspace found
# ✓ Agent list readable
# ✓ Queue configuration loaded

最佳实践

使用 API 密钥而非 Auth Token - API 密钥可范围化且可单独撤销
利用事件流 - 基于推送的事件比轮询 TaskRouter 更高效
构建 Flex 插件 - 使用 UI 插件实时捕获任务完成事件
一致映射频道 - 将语音、短信和聊天数据规范化为统一的 Brevo 事件
追踪 CSAT 评分 - 将满意度数据同步到 Brevo 用于体验驱动的细分
监控队列指标 - 使用等待时间数据触发主动客户通信

安全

Account SID + Auth Token - Twilio 标准认证
API 密钥 - 可撤销的非根凭据，用于生产环境
仅 HTTPS - 所有 API 通信通过 TLS 1.2+ 加密
Webhook 验证 - 使用 X-Twilio-Signature 验证 Twilio Webhook 签名
PCI 合规 - Twilio Flex 通过 PCI DSS Level 1 合规
加密存储 - 凭据在 Tajo 中静态加密

Twilio Flex 连接器

同步示例

字段映射

概览

功能

前提条件

认证

账户凭据

API 密钥（推荐用于生产环境）

连接到 Tajo

配置

基础设置

字段映射

事件映射

API 端点

代码示例

初始化连接器

同步会话历史

会话后活动触发

Flex 插件集成

速率限制

故障排除

常见问题

调试模式

测试连接

最佳实践

安全

相关资源

请通过邮件确认申请

本页的 Markdown: twilio-flex.md