Connecteur Intercom

Connectez votre espace de travail Intercom à Brevo via Tajo pour une messagerie client unifiée, un suivi des conversations, et une automatisation marketing guidée par l’engagement alimentée par vos données de support et produit.

Vue d’ensemble

Fonctionnalités

• Synchronisation des contacts - Synchronisation bidirectionnelle des utilisateurs et leads Intercom avec les contacts Brevo
• Suivi des conversations - Synchronisation des données de conversation pour la segmentation guidée par le support
• Mappage d’entreprises - Association des contacts aux entreprises pour les workflows basés sur les comptes
• Attributs personnalisés - Mappage des attributs personnalisés Intercom aux champs de contact Brevo
• Suivi d’événements - Synchronisation des événements personnalisés et activités utilisateur pour le ciblage comportemental
• Synchronisation des tags - Mappage des tags Intercom vers l’appartenance à des listes ou attributs Brevo
• Données Messenger - Suivi de l’engagement de messagerie in-app et des interactions de chat
• Intégration agent IA - Synchronisation des résultats de conversations d’agents IA avec Brevo

Prérequis

Avant de commencer, assurez-vous d’avoir :

1. Un espace de travail Intercom (plan Starter, Pro ou Premium)
2. Une application Intercom avec jeton d’accès (application privée) ou OAuth configuré (application publique)
3. Un compte Brevo avec accès API
4. Un compte Tajo

Authentification

Jeton d’accès (Application privée)

Pour les intégrations privées qui accèdent aux données de votre propre espace de travail.

1. Allez dans Developer Hub > Your Apps > Create new app
2. Associez à votre espace de travail Intercom
3. Copiez le jeton d’accès

curl https://api.intercom.io/contacts \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "Intercom-Version: 2.11"

OAuth 2.0 (Application publique)

Pour les intégrations qui accèdent aux données Intercom d’autres clients.

# URL d'autorisation
https://app.intercom.com/oauth?client_id={client_id}&state={state}

# Échange de jeton
curl -X POST https://api.intercom.io/auth/eagle/token \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "code={auth_code}"

Configuration

Configuration de base

connectors:
  intercom:
    enabled: true
    access_token: "${INTERCOM_ACCESS_TOKEN}"
    api_version: "2.11"

    # Options de synchronisation des données
    sync:
      contacts: true
      conversations: true
      companies: true
      events: true
      tags: true

    # Direction de synchronisation
    direction: intercom_to_brevo

    # Assignation de listes Brevo
    lists:
      all_users: 35
      active_conversations: 36
      leads: 37

Mappage de champs

Mappez les données de contact Intercom aux attributs de contact Brevo :

Mappage d’attributs personnalisés

field_mapping:
  # Champs standards
  email: email
  name: FULLNAME
  phone: SMS

  # Champs d'engagement
  signed_up_at: SIGNUP_DATE
  last_seen_at: LAST_ACTIVE
  session_count: SESSION_COUNT
  unsubscribed_from_emails: UNSUBSCRIBED

  # Champs d'entreprise
  company.name: COMPANY_NAME
  company.plan: COMPANY_PLAN
  company.size: COMPANY_SIZE

  # Attributs personnalisés
  custom_attributes.plan_tier: PLAN_TIER
  custom_attributes.feature_usage: FEATURE_USAGE

Endpoints API

API Contacts

API Conversations

API Companies

API Events

Événements

Événements de conversation

Événements de contact

Événements utilisateur

Exemples de code

Initialiser le connecteur

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

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

// Connecter Intercom
await tajo.connectors.connect('intercom', {
  accessToken: process.env.INTERCOM_ACCESS_TOKEN,
  apiVersion: '2.11'
});

Synchroniser contacts et conversations

// Synchronisation complète des contacts et données de conversation
await tajo.connectors.sync('intercom', {
  type: 'full',
  resources: ['contacts', 'conversations', 'companies'],
  since: '2023-01-01'
});

// Vérifier le statut de synchronisation
const status = await tajo.connectors.status('intercom');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 14200,
//   conversationsSynced: 28400,
//   companiesSynced: 2100
// }

Gérer les webhooks Intercom

import crypto from 'crypto';

app.post('/webhooks/intercom', async (req, res) => {
  const signature = req.get('X-Hub-Signature');
  const expectedSig = 'sha1=' + crypto
    .createHmac('sha1', process.env.INTERCOM_CLIENT_SECRET)
    .update(JSON.stringify(req.body))
    .digest('hex');

  if (signature !== expectedSig) {
    return res.status(401).send('Unauthorized');
  }

  await tajo.connectors.handleWebhook('intercom', {
    topic: req.body.topic,
    data: req.body.data
  });

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

Limites de taux

Intercom applique des limites de taux selon votre plan :

Limites supplémentaires :

• Opérations bulk : 15 contacts par requête bulk
• Soumissions d’événements : 500 événements/seconde par espace de travail
• Livraison de webhooks : Retry automatique pendant 24 heures
• Export de données : 1 export concurrent

Dépannage

Problèmes courants

Mode debug

Activer la journalisation détaillée :

connectors:
  intercom:
    debug: true
    log_level: verbose
    log_webhooks: true

Tester la connexion

tajo connectors test intercom
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Conversations readable
# ✓ Companies readable
# ✓ Webhooks registered

Bonnes pratiques

1. Épinglez la version API - Spécifiez toujours Intercom-Version pour éviter les changements majeurs
2. Utilisez l’API Search efficacement - Utilisez des filtres et la pagination pour réduire le transfert de données
3. Synchronisez utilisateurs et leads - Capturez tout le funnel dans Brevo
4. Mappez les tags de conversation - Utilisez les tags de conversation pour les segments marketing post-support
5. Suivez les événements personnalisés - Soumettez les événements produit clés à Intercom pour le ciblage comportemental
6. Gérez les fusions de contacts - Implémentez la logique de fusion pour les contacts dupliqués

Sécurité

• Jeton d’accès - Authentification par bearer token pour les applications privées
• OAuth 2.0 - Autorisation déléguée pour les applications publiques avec client secret
• Vérification des webhooks - Validation de signature HMAC SHA-1 via X-Hub-Signature
• Chiffrement TLS - Toutes les communications API chiffrées via HTTPS
• Contrôles d’accès aux données - Accès granulaire aux données par configuration d’application

Ressources liées

• Documentation développeur Intercom
• Référence API Intercom
• Connecteur Zendesk
• Compétence de synchronisation client
• API Contacts Brevo