--- title: "Gorgias Bağlayıcısı" description: "Tajo aracılığıyla yardım masası taleplerini, müşteri verilerini ve destek olaylarını Brevo ile senkronize etmek için eksiksiz Gorgias entegrasyon rehberi." url: https://tajo.io/tr/docs/connectors/support/gorgias/ markdown: https://tajo.io/tr/docs/connectors/support/gorgias.md lang: tr-TR robots: noindex --- Erken erişim talep edin Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz. # Gorgias Bağlayıcısı Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor. | Kaynak alanı | Hedef alanı | Örnek değer | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Destek odaklı müşteri etkileşimi, talep sonrası pazarlama akışları ve birleşik müşteri deneyimi analitiği için Gorgias yardım masanızı Tajo üzerinden Brevo’ya bağlayın. ## Genel Bakış | Özellik | Değer | | --- | --- | | **Platform** | Gorgias | | **Kategori** | Destek | | **Kurulum Karmaşıklığı** | Kolay | | **Resmi Entegrasyon** | Hayır | | **Senkronize Edilen Veri** | Müşteriler, Talepler, Olaylar | | **API Türü** | REST API | | **Kimlik Doğrulama** | API Anahtarı + E-posta (Basic Auth) | | **Temel URL** | `https://{domain}.gorgias.com/api/` | ## Özellikler - **Talep olay senkronizasyonu** - Talep oluşturma, çözüm ve CSAT olaylarını Brevo zaman çizelgelerine iletin - **Müşteri profili zenginleştirme** - Etiketler ve özel alanlar dahil Gorgias müşteri verilerini Brevo’ya senkronize edin - **Destek sonrası kampanyalar** - Takip veya ek satış için talep çözümünden sonra Brevo iş akışlarını tetikleyin - **Memnuniyet takibi** - CSAT anket sonuçlarını Brevo kişi öznitelikleri olarak senkronize edin - **Etiket tabanlı segmentasyon** - Gorgias müşteri etiketlerini Brevo liste üyelikleri olarak yansıtın - **Makro ve kural olayları** - Operasyonel analitik için otomatik eylemleri takip edin ## Ön Koşullar Başlamadan önce sahip olmanız gerekenler: 1. Yönetici erişimine sahip bir Gorgias hesabı 2. Gorgias alt alan adınız (örn. `yourstore.gorgias.com`) 3. Bir API anahtarı ve ilişkili e-posta adresi 4. API erişimi olan bir Brevo hesabı 5. Aktif aboneliği olan bir Tajo hesabı ## Kimlik Doğrulama Gorgias, hesap e-postanızla ve API anahtarınızla HTTP Basic Authentication kullanır. ### API Anahtarı Oluşturma 1. Gorgias panonuza giriş yapın 2. **Settings** > **REST API** bölümüne gidin 3. **Create API Key** tıklayın (veya mevcut anahtarı kopyalayın) 4. API temel URL’nizi not edin: `https://{domain}.gorgias.com/api/` ```bash # Basic Auth: email as username, API key as password curl -X GET "https://yourstore.gorgias.com/api/customers" \ -u "admin@yourstore.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` API Anahtar İzinleri Gorgias API anahtarları hesap verilerinize tam erişime sahiptir. Kapsam tabanlı izin modeli yoktur. API anahtarınızı koruyun ve düzenli olarak rotasyona alın. ### Tajo’ya Bağlanma ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Yapılandırma ### Temel Kurulum ```yaml connectors: gorgias: enabled: true domain: "yourstore.gorgias.com" sync: customers: true tickets: true satisfaction_surveys: true tags: true lists: all_support_contacts: 35 satisfied_customers: 36 dissatisfied_customers: 37 ``` ### Alan Eşleme Gorgias müşteri ve talep alanlarını Brevo kişi özniteliklerine eşleyin: ```yaml field_mapping: # Customer fields id: GORGIAS_ID email: email name: FIRSTNAME phone: SMS # Support metrics nb_tickets: TICKET_COUNT last_ticket_date: LAST_SUPPORT_DATE last_ticket_channel: LAST_SUPPORT_CHANNEL avg_response_time: AVG_RESPONSE_TIME # CSAT data last_satisfaction_score: CSAT_SCORE satisfaction_count: CSAT_RESPONSES # Custom fields customer_type: CUSTOMER_TYPE vip_status: VIP_STATUS ``` ### Olay Eşleme ```yaml event_mapping: ticket.created: SUPPORT_TICKET_OPENED ticket.closed: SUPPORT_TICKET_RESOLVED ticket.reopened: SUPPORT_TICKET_REOPENED satisfaction_survey.created: CSAT_SURVEY_SENT satisfaction_survey.responded: CSAT_SUBMITTED customer.created: SUPPORT_CUSTOMER_CREATED ``` ## API Uç Noktaları Tajo aşağıdaki Gorgias REST API uç noktalarıyla entegre olur: | Uç Nokta | Yöntem | Amaç | | --- | --- | --- | | `/api/customers` | GET | Müşterileri listele | | `/api/customers/{id}` | GET | Bir müşteriyi getir | | `/api/customers` | POST | Bir müşteri oluştur | | `/api/customers/{id}` | PUT | Bir müşteriyi güncelle | | `/api/tickets` | GET | Talepleri listele | | `/api/tickets/{id}` | GET | Bir talebi getir | | `/api/tickets/{id}/messages` | GET | Talep mesajlarını listele | | `/api/tags` | GET | Etiketleri listele | | `/api/satisfaction-surveys` | GET | CSAT anketlerini listele | | `/api/satisfaction-surveys/{id}` | GET | Bir anketi getir | | `/api/users` | GET | Temsilcileri listele | | `/api/integrations` | GET | Entegrasyonları listele | | `/api/events` | GET | Olayları listele | | `/api/customers/{id}/custom-fields` | GET | Özel alan değerlerini al | ## Kod Örnekleri ### Bağlayıcıyı Başlat ```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('gorgias', { domain: 'yourstore.gorgias.com', email: 'admin@yourstore.com', apiKey: process.env.GORGIAS_API_KEY }); ``` ### Müşterileri Brevo’ya Senkronize Et ```javascript await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['customers'], since: '2024-01-01', batchSize: 30 }); const status = await tajo.connectors.status('gorgias'); console.log(status); // { // connected: true, // lastSync: '2024-03-15T17:00:00Z', // customersCount: 14200, // ticketsTracked: 28600, // csatResponses: 3400 // } ``` ### HTTP Entegrasyonu Üzerinden Talep Olaylarını İşle ```javascript // Gorgias can send HTTP requests via Rules or HTTP integrations app.post('/webhooks/gorgias', async (req, res) => { const event = req.body; await tajo.connectors.handleEvent('gorgias', { type: 'ticket.updated', payload: { ticketId: event.ticket_id, status: event.status, customerEmail: event.customer?.email, channel: event.channel, tags: event.tags, satisfaction: event.satisfaction } }); res.status(200).send('OK'); }); ``` ### Çözüm Sonrası Kampanya ```javascript // Trigger a follow-up email after a support ticket is resolved tajo.connectors.on('gorgias', 'ticket.closed', async (event) => { if (event.satisfaction_score >= 4) { await tajo.campaigns.trigger('post-support-upsell', { email: event.customer.email, params: { agent_name: event.assignee.name, ticket_subject: event.subject, resolution_time: event.resolution_time } }); } }); ``` ### CSAT Verilerini Senkronize Et ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Hız Limitleri Gorgias hesap başına hız limitleri uygular: | Limit Türü | Değer | | --- | --- | | **API hız limiti** | Saniyede 2 istek | | **Patlama izni** | Kısa patlamalarda 5 isteğe kadar | | **Sayfalama** | Sayfa başına 30 öğe (varsayılan), maks. 100 | Sayfalama Stratejisi Gorgias, `cursor` ve `limit` parametreleriyle cursor tabanlı sayfalama kullanır. Tajo bunu otomatik olarak yönetir ve maksimum verimlilik için sayfa başına 100 öğeye kadar talep eder. Gorgias, hız limitleri aşıldığında `429 Too Many Requests` döndürür. ## Sorun Giderme ### Sık Karşılaşılan Sorunlar | Sorun | Neden | Çözüm | | --- | --- | --- | | 401 Unauthorized | Geçersiz e-posta veya API anahtarı | Gorgias Settings > REST API’de kimlik bilgilerini doğrulayın | | 404 Not Found | Geçersiz uç nokta veya kaynak kimliği | API temel URL’sinin alt alan adınızı içerdiğini kontrol edin | | Müşteriler eksik | Kayıtta e-posta yok | Gorgias müşteri eşleştirmesi için e-posta gerektirir | | Etiketler senkronize edilmiyor | Etiketler müşterilere atanmadı | Etiketlerin yalnızca taleplerde değil müşteri nesnelerinde olduğunu doğrulayın | | Yavaş senkronizasyon | Düşük hız limiti | Gorgias 2 istek/sn ile sınırlıdır; tam senkronizasyonlar daha uzun sürer | ### Hata Ayıklama Modu ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Bağlantıyı Test Et ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## En İyi Uygulamalar 1. **Gerçek zamanlı için HTTP entegrasyonları kullanın** - Talep olaylarında Tajo’ya HTTP istekleri göndermek için Gorgias Kurallarını yapılandırın 2. **CSAT verilerini düzenli olarak senkronize edin** - Yeniden etkileşim kampanyalarını yönlendirmek için memnuniyet puanlarını kullanın 3. **Etiketleri segmentlere eşleyin** - Gorgias müşteri etiketlerini Brevo liste üyeliklerine çevirin 4. **Sayfalamayı dikkatli yönetin** - 2 istek/sn limitleriyle, büyük veri kümeleri için daha uzun senkronizasyon süreleri planlayın 5. **E-ticaret verisine bağlayın** - Gorgias destek verilerini Brevo’da Shopify sipariş verileriyle birleştirin 6. **API anahtarlarını rotasyona alın** - Gorgias anahtarlarının tam erişimi olduğundan, bunları periyodik olarak rotasyona alın ## Güvenlik - **Basic Auth** - HTTPS üzerinden e-posta ve API anahtarı - **Yalnızca HTTPS** - Tüm API iletişimi TLS 1.2+ aracılığıyla şifrelenir - **Tam Erişim Anahtarları** - Ayrıntılı kapsamlandırma yok (anahtarları dikkatli koruyun) - **IP İzin Listesi** - Daha yüksek Gorgias planlarında mevcuttur - **Şifreli Depolama** - Tajo’da API kimlik bilgileri durağan halde şifrelenir - **SOC 2 Uyumluluğu** - Gorgias platformu SOC 2 Type II sertifikalıdır ## İlgili Kaynaklar - [Twilio Flex Bağlayıcısı](https://tajo.io/tr/docs/connectors/custom/twilio-flex) - [Jira Bağlayıcısı](https://tajo.io/tr/docs/connectors/custom/jira) - [Shopify Bağlayıcısı](https://tajo.io/tr/docs/connectors/ecommerce/shopify) - [Brevo Kişiler API’si](https://tajo.io/tr/docs/contact-management)