Twilio Flex konnektor

Csatlakoztasd a Twilio Flex kapcsolatközpontodat a Brevóhoz egységes ügyfél-interakciós előzmények, beszélgetés utáni marketing munkafolyamatok és support-vezérelt elköteleződési analitika érdekében a Tajo segítségével.

Áttekintés

Funkciók

• Beszélgetés-szinkronizáció – Hang-, SMS-, WhatsApp- és csevegési interakciók továbbítása Brevo idővonalakra
• Ügyfélprofil-gazdagítás – Flex ügyféladatok szinkronizálása Brevo kapcsolat-attribútumokhoz
• Interakció utáni kampányok – Brevo munkafolyamatok indítása a support-beszélgetések lezárása után
• CSAT esemény-követés – Elégedettségi felmérések eredményeinek szinkronizálása Brevo eseményekként
• Ügynöktevékenységi adatok – Ügynök-teljesítmény mutatók követése operatív riportoláshoz
• Sor-analitika – Várakozási idő és elhagyási adatok továbbítása az élmény-optimalizáláshoz

Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Twilio fiókkal engedélyezett Flexszel
2. Twilio Account SID-del és Auth Tokennel
3. Egy Flex példánnyal aktív csatornákkal (hang, SMS, csevegés vagy WhatsApp)
4. Konfigurált TaskRouter munkaterülettel
5. Egy Brevo fiókkal API-hozzáféréssel
6. Egy Tajo fiókkal aktív előfizetéssel

Hitelesítés

A Twilio Flex a Twilio szabványos hitelesítési módszereit használja.

Fiók hitelesítő adatok

# 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 kulcs (Éles környezethez ajánlott)

1. Menj a Twilio Console > Account > API keys & tokens menübe
2. Kattints az Create API Key gombra
3. Válaszd a Standard kulcstípust
4. Tárold biztonságosan a SID-et és a titkot

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

Csatlakozás a Tajóhoz

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

Konfiguráció

Alapbeállítás

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

Mezőleképezés

Képezd le a Flex ügyféladatokat és interakciós adatokat Brevo attribútumokhoz:

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

Esemény-leképezés

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

API végpontok

A Tajo az alábbi Twilio Flex és kapcsolódó API végpontokkal integrálódik:

Kódpéldák

A konnektor inicializálása

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
});

Beszélgetési előzmények szinkronizálása

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
// }

Interakció utáni kampány-kiváltó

// 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 Plugin integráció

// 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.tajo.io/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
        })
      });
    });
  }
}

Ráta-korlátok

A Twilio ráta-korlátokat alkalmaz az API-jain:

Hibaelhárítás

Gyakori problémák

Hibakeresési mód

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

Kapcsolat tesztelése

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

Legjobb gyakorlatok

1. Használj API kulcsokat Auth Token helyett – Az API kulcsok hatókörrel korlátozhatók és egyenként visszavonhatók
2. Használd ki az Event Streamst – A push alapú események hatékonyabbak, mint a TaskRouter lekérdezése
3. Építs Flex Plugint – Használj UI plugint a feladat-befejezési események valós idejű rögzítéséhez
4. Egységesítsd a csatornákat – Normalizáld a hang-, SMS- és csevegési adatokat egységes Brevo eseményekké
5. Kövesd a CSAT pontszámokat – Szinkronizáld az elégedettségi adatokat a Brevóba élmény-vezérelt szegmentáláshoz
6. Figyeld a sor mutatóit – Használd a várakozási idő adatokat proaktív ügyfél-kommunikáció indításához

Biztonság

• Account SID + Auth Token – Szabványos Twilio hitelesítés
• API kulcsok – Visszavonható, nem gyökér szintű hitelesítő adatok éles használathoz
• Csak HTTPS – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
• Webhook-ellenőrzés – Twilio webhook aláírások ellenőrzése X-Twilio-Signature fejléccsel
• PCI megfelelőség – A Twilio Flex PCI DSS Level 1 megfelelőséggel rendelkezik
• Titkosított tárolás – A hitelesítő adatok titkosítva tárolódnak a Tajóban

Kapcsolódó források

• Gorgias konnektor
• Jira konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Contacts API