Connecteur Freshdesk

Connectez Freshdesk à Brevo via Tajo pour unifier les données de support et de marketing. Synchronisez les tickets de support client, les profils de contacts et les scores de satisfaction pour alimenter des communications ciblées basées sur les interactions de support.

Vue d’ensemble

Fonctionnalités

• Synchronisation des contacts - Synchronisation bidirectionnelle des contacts Freshdesk vers les listes de contacts Brevo
• Suivi des événements de tickets - Transfert des événements de création, mise à jour et résolution de tickets vers Brevo
• Synchronisation CSAT - Synchronisation des scores de satisfaction client en tant qu’attributs de contact Brevo
• Synchronisation des entreprises - Mappage des entreprises Freshdesk vers la segmentation de contacts Brevo
• Données d’agents - Suivi des attributions d’agents pour l’automatisation des workflows internes
• Champs personnalisés - Mappage des champs personnalisés de tickets et contacts Freshdesk vers les attributs Brevo

Prérequis

Avant de commencer, assurez-vous d’avoir :

1. Un compte Freshdesk avec accès admin
2. Votre clé API Freshdesk (trouvée dans les Profile Settings)
3. Votre domaine Freshdesk (ex. yourcompany.freshdesk.com)
4. Un compte Brevo avec accès API
5. Un compte Tajo avec identifiants API

Authentification

Authentification par clé API

Freshdesk utilise l’authentification par clé API via HTTP Basic Auth. La clé API est utilisée comme nom d’utilisateur avec n’importe quelle chaîne (typiquement X) comme mot de passe.

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

Ou en utilisant l’encodage Base64 dans l’en-tête Authorization :

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

Trouver votre clé API

1. Connectez-vous à votre compte Freshdesk
2. Cliquez sur votre photo de profil en haut à droite
3. Allez dans Profile Settings
4. Votre clé API est affichée sur le côté droit

Configuration

Configuration de base

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

    # Options de synchronisation des données
    sync:
      contacts: true
      tickets: true
      companies: true
      satisfaction_ratings: true

    # Assignation de listes Brevo
    lists:
      all_support_contacts: 30
      open_tickets: 31
      resolved_tickets: 32

Mappage des champs de contact

Mappez les champs de contact Freshdesk aux attributs Brevo :

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

  # Métriques de support
  total_tickets: TICKET_COUNT
  open_tickets: OPEN_TICKETS
  avg_csat: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Champs personnalisés
  custom_fields.account_type: ACCOUNT_TYPE
  custom_fields.subscription_tier: PLAN

Mappage des événements de tickets

Mappez les événements de tickets Freshdesk aux déclencheurs d’automatisation 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"

Endpoints API

Exemples de code

Initialiser le connecteur Freshdesk

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

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

// Connecter le compte Freshdesk
await tajo.connectors.connect('freshdesk', {
  domain: 'yourcompany.freshdesk.com',
  apiKey: process.env.FRESHDESK_API_KEY
});

Synchroniser les contacts vers Brevo

// Récupérer les contacts Freshdesk et les synchroniser vers Brevo
const response = await fetch(
  'https://yourcompany.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();
// Chaque contact :
// {
//   "id": 12345,
//   "name": "Jane Kim",
//   "email": "[email protected]",
//   "phone": "+15551234567",
//   "company_id": 678,
//   "job_title": "Product Manager",
//   "created_at": "2024-01-15T10:30:00Z"
// }

Suivre les événements de tickets

// Configurer un webhook Freshdesk pour transférer les événements de tickets
// Configurez dans Freshdesk Admin > Automations > Webhook

// Gestionnaire de webhook
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');
});

Rechercher des tickets par client

// Rechercher tous les tickets d'un client spécifique
const query = encodeURIComponent('"email:[email protected]"');
const response = await fetch(
  `https://yourcompany.freshdesk.com/api/v2/search/tickets?query=${query}`,
  {
    headers: {
      'Authorization': 'Basic ' + btoa(`${API_KEY}:X`)
    }
  }
);

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

Limites de taux

Limites supplémentaires :

Dépannage

Bonnes pratiques

1. Utilisez les webhooks pour la synchronisation en temps réel - Configurez les Automations Freshdesk pour déclencher des webhooks sur les événements de tickets
2. Synchronisez les scores CSAT - Suivez les évaluations de satisfaction client en tant qu’attributs Brevo pour la segmentation
3. Mappez le statut des tickets aux listes - Déplacez automatiquement les contacts entre les listes Brevo selon le statut du ticket
4. Suivez les métriques de support - Synchronisez le nombre de tickets, le temps de réponse moyen et le taux de résolution par contact
5. Utilisez l’API Search avec parcimonie - L’API Search a des limites de taux plus strictes ; mettez en cache les résultats quand possible
6. Paginez les exports volumineux - Utilisez la pagination avec les paramètres page et per_page pour la synchronisation initiale

Sécurité

• Authentification par clé API - HTTP Basic Auth simple avec clé API
• HTTPS uniquement - Toutes les communications API nécessitent un chiffrement TLS
• Liste blanche d’IP - Disponible sur les plans Estate et Forest
• Accès basé sur les rôles - Permissions de clé API liées au rôle de l’agent
• SOC 2 Type II - Freshdesk est certifié SOC 2 Type II
• Conformité RGPD - Prend en charge les demandes d’export et de suppression de données

Ressources liées

• Connecteur Brevo
• Compétence de synchronisation client
• Connecteur Shopify
• API Contacts Brevo