Konektor Freshdesk

Propojte Freshdesk s Brevo přes Tajo pro sjednocení dat podpory a marketingu. Synchronizujte tikety zákaznické podpory, profily kontaktů a skóre spokojenosti pro cílené komunikace na základě interakcí podpory.

Přehled

Funkce

• Synchronizace kontaktů – Obousměrná synchronizace kontaktů Freshdesk se seznamy kontaktů Brevo
• Sledování událostí tiketů – Přeposílejte události vytvoření, aktualizace a vyřešení tiketů do Brevo
• Synchronizace CSAT – Synchronizujte skóre spokojenosti zákazníků jako atributy kontaktů Brevo
• Synchronizace společností – Mapujte společnosti Freshdesk na segmentaci kontaktů Brevo
• Data agentů – Sledujte přiřazení agentů pro automatizaci interních pracovních toků
• Vlastní pole – Mapujte vlastní pole tiketů a kontaktů Freshdesk na atributy Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Freshdesk s přístupem správce
2. Váš API klíč Freshdesk (nalezený v Nastavení profilu)
3. Vaši doménu Freshdesk (např. vasespolecnost.freshdesk.com)
4. Účet Brevo s přístupem k API
5. Účet Tajo s API přihlašovacími údaji

Ověření

Ověření API klíčem

Freshdesk používá ověřování API klíčem přes HTTP Basic Auth. API klíč se používá jako uživatelské jméno s libovolným řetězcem (typicky X) jako heslem.

curl -u "YOUR_API_KEY:X" \
  https://vasespolecnost.freshdesk.com/api/v2/tickets

Nebo pomocí kódování Base64 v autorizační hlavičce:

curl https://vasespolecnost.freshdesk.com/api/v2/tickets \
  -H "Authorization: Basic BASE64_ENCODED_API_KEY:X" \
  -H "Content-Type: application/json"

Nalezení vašeho API klíče

1. Přihlaste se ke svému účtu Freshdesk
2. Klikněte na profilový obrázek v pravém horním rohu
3. Přejděte do Nastavení profilu
4. Váš API klíč je zobrazen na pravé straně

Konfigurace

Základní nastavení

connectors:
  freshdesk:
    enabled: true
    domain: "vasespolecnost.freshdesk.com"
    api_key: "your-freshdesk-api-key"

    # Možnosti synchronizace dat
    sync:
      contacts: true
      tickets: true
      companies: true
      satisfaction_ratings: true

    # Přiřazení seznamů Brevo
    lists:
      all_support_contacts: 30
      open_tickets: 31
      resolved_tickets: 32

Mapování polí kontaktů

Mapujte pole kontaktů Freshdesk na atributy Brevo:

contact_mapping:
  email: email
  name: FULLNAME
  phone: SMS
  company_id: COMPANY
  job_title: JOB_TITLE
  twitter_id: TWITTER
  language: LANGUAGE
  time_zone: TIMEZONE

  # Metriky podpory
  total_tickets: TICKET_COUNT
  open_tickets: OPEN_TICKETS
  avg_csat: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Vlastní pole
  custom_fields.account_type: ACCOUNT_TYPE
  custom_fields.subscription_tier: PLAN

Mapování událostí tiketů

Mapujte události tiketů Freshdesk na spouštěče automatizací Brevo:

ticket_events:
  ticket_created: "support_ticket_created"
  ticket_updated: "support_ticket_updated"
  ticket_resolved: "support_ticket_resolved"
  ticket_closed: "support_ticket_closed"
  ticket_reopened: "support_ticket_reopened"
  satisfaction_rated: "csat_submitted"
  note_added: "support_note_added"

Koncové body API

Příklady kódu

Inicializace konektoru Freshdesk

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

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

// Připojení účtu Freshdesk
await tajo.connectors.connect('freshdesk', {
  domain: 'vasespolecnost.freshdesk.com',
  apiKey: process.env.FRESHDESK_API_KEY
});

Synchronizace kontaktů do Brevo

// Načtení kontaktů Freshdesk a synchronizace do Brevo
const response = await fetch(
  'https://vasespolecnost.freshdesk.com/api/v2/contacts?page=1&per_page=100',
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`),
      'Content-Type': 'application/json'
    }
  }
);

const contacts = await response.json();
// Každý kontakt:
// {
//   "id": 12345,
//   "name": "Jana Nováková",
//   "email": "[email protected]",
//   "phone": "+420551234567",
//   "company_id": 678,
//   "job_title": "Product Manager",
//   "created_at": "2024-01-15T10:30:00Z"
// }

Sledování událostí tiketů

// Nastavení webhooku Freshdesk pro přeposílání událostí tiketů
// Nakonfigurujte v Freshdesk Admin > Automations > Webhook

// Obsluha webhooku
app.post('/webhooks/freshdesk', async (req, res) => {
  const { ticket, event_type } = req.body;

  await tajo.connectors.handleWebhook('freshdesk', {
    topic: event_type,
    payload: {
      ticketId: ticket.id,
      subject: ticket.subject,
      status: ticket.status,
      priority: ticket.priority,
      requesterEmail: ticket.requester.email,
      createdAt: ticket.created_at
    }
  });

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

Vyhledávání tiketů podle zákazníka

// Vyhledání všech tiketů konkrétního zákazníka
const query = encodeURIComponent('"email:[email protected]"');
const response = await fetch(
  `https://vasespolecnost.freshdesk.com/api/v2/search/tickets?query=${query}`,
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`)
    }
  }
);

const { results, total } = await response.json();

Omezení rychlosti

Další limity:

Řešení problémů

Osvědčené postupy

1. Používejte webhooky pro synchronizaci v reálném čase – Nakonfigurujte automatizace Freshdesk pro spouštění webhooků při událostech tiketů
2. Synchronizujte skóre CSAT – Sledujte hodnocení spokojenosti zákazníků jako atributy Brevo pro segmentaci
3. Mapujte stav tiketu na seznamy – Automaticky přesouvejte kontakty mezi seznamy Brevo na základě stavu tiketu
4. Sledujte metriky podpory – Synchronizujte počet tiketů, průměrnou dobu odezvy a míru řešení na kontakt
5. Používejte Search API střídmě – Search API má přísnější limity rychlosti; cachujte výsledky, když je to možné
6. Stránkujte velké exporty – Používejte stránkování s parametry page a per_page pro počáteční synchronizaci

Zabezpečení

• Ověřování API klíčem – Jednoduchý HTTP Basic Auth s API klíčem
• Pouze HTTPS – Veškerá komunikace API vyžaduje šifrování TLS
• Whitelisting IP – Dostupné na plánech Estate a Forest
• Přístup podle rolí – Oprávnění API klíče vázána na roli agenta
• SOC 2 Type II – Freshdesk je certifikován podle SOC 2 Type II
• Soulad s GDPR – Podporuje žádosti o export a smazání dat

Související zdroje

• Konektor Brevo
• Dovednost synchronizace zákazníků
• Konektor Shopify
• API kontaktů Brevo