--- title: "Twilio Flex konnektor" description: "Teljes Twilio Flex integrációs útmutató kapcsolatközpont-interakciók, ügynöktevékenység és ügyfélbeszélgetések Brevóval való szinkronizációjához a Tajo segítségével." url: https://tajo.io/hu/docs/connectors/custom/twilio-flex/ markdown: https://tajo.io/hu/docs/connectors/custom/twilio-flex.md lang: hu-HU robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # Twilio Flex konnektor Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort. | Forrásmező | Célmező | Mintaérték | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | 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 | Tulajdonság | Érték | | --- | --- | | **Platform** | Twilio Flex | | **Kategória** | Egyéni | | **Telepítés bonyolultsága** | Haladó | | **Hivatalos integráció** | Nem | | **Szinkronizált adatok** | Ügyfelek, Beszélgetések, Események | | **Használt API-k** | Flex API, Conversations API, TaskRouter API | | **Hitelesítés** | Account SID + Auth Token / API kulcs | | **Alap URL** | `https://flex-api.twilio.com` | ## 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 ```bash # 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 ```bash curl -X GET "https://flex-api.twilio.com/v1/Configuration" \ -u "$TWILIO_API_KEY_SID:$TWILIO_API_KEY_SECRET" ``` Auth Token vs API kulcs Az Auth Token teljes fiók-hozzáférést biztosít. Éles környezetben használj hatókörrel korlátozott API kulcsokat. Az API kulcsok egyenként visszavonhatók anélkül, hogy más integrációkat zavarnának. ### Csatlakozás a Tajóhoz ```bash 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 ```yaml 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: ```yaml 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 ```yaml 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: | Végpont | Módszer | API | Cél | | --- | --- | --- | --- | | `/v1/Configuration` | GET | Flex | Flex konfiguráció lekérése | | `/v1/Interactions` | GET | Flex | Interakciók listázása | | `/v1/Channels` | GET | Flex | Flex csatornák listázása | | `/v1/WebChannels` | POST | Flex | Webes csevegő csatorna létrehozása | | `/v1/Conversations` | GET | Conversations | Beszélgetések listázása | | `/v1/Conversations/{sid}/Messages` | GET | Conversations | Beszélgetés üzeneteinek listázása | | `/v1/Conversations/{sid}/Participants` | GET | Conversations | Résztvevők listázása | | `/v1/Workspaces/{sid}/Tasks` | GET | TaskRouter | Feladatok listázása | | `/v1/Workspaces/{sid}/Workers` | GET | TaskRouter | Munkások (ügynökök) listázása | | `/v1/Workspaces/{sid}/TaskQueues` | GET | TaskRouter | Feladatsorok listázása | | `/v1/Workspaces/{sid}/Events` | GET | TaskRouter | Munkaterület-események listázása | ## Kódpéldák ### A konnektor inicializálása ```javascript 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 ```javascript 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ó ```javascript // 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ó ```javascript // 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 A fenti `example.com` cím csak helyőrző, amíg a Tajo végpont elérhetővé nem válik. ## Ráta-korlátok A Twilio ráta-korlátokat alkalmaz az API-jain: | API | Ráta-korlát | Megjegyzések | | --- | --- | --- | | **Flex API** | 100 kérés/másodperc | Fiókonként | | **Conversations API** | 100 kérés/másodperc | Fiókonként | | **TaskRouter API** | 30 olvasási kérés/másodperc | Munkaterületenként | | **TaskRouter Events** | 20 kérés/másodperc | Munkaterületenként | Eseményfolyamok Nagy volumenű eseményfeldolgozáshoz fontold meg a Twilio Event Streams használatát a TaskRouter események lekérdezése helyett. Az Event Streams valós időben küld eseményeket webhookokon vagy Kinesisen keresztül. ## Hibaelhárítás ### Gyakori problémák | Probléma | Ok | Megoldás | | --- | --- | --- | | 401 Unauthorized | Érvénytelen SID vagy token | Ellenőrizd az Account SID-et és Auth Tokent a Twilio Console-ban | | 403 Forbidden | A Flex nincs engedélyezve | Győződj meg róla, hogy a Flex aktiválva van a Twilio fiókodon | | Hiányzó beszélgetések | Rossz dátumtartomány | Bővítsd ki a szinkronizálás dátumtartományát vagy ellenőrizd a beszélgetés állapotát | | Feladatok nem követve | TaskRouter munkaterület eltérés | Ellenőrizd a megfelelő munkaterület SID-et | | Plugin nem indul el | Az eseményfigyelő nincs regisztrálva | Ellenőrizd, hogy a Flex plugin telepítve és aktív | ### Hibakeresési mód ```yaml connectors: twilio_flex: debug: true log_level: verbose log_api_calls: true ``` ### Kapcsolat tesztelése ```bash 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](https://tajo.io/hu/docs/connectors/support/gorgias) - [Jira konnektor](https://tajo.io/hu/docs/connectors/custom/jira) - [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync) - [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)