Guides des Outils

Guides des Outils

Bienvenue dans nos guides complets d’outils pour la gestion d’abonnements, l’automatisation de facturation et les plateformes de succès client. Ces guides vous aideront à maximiser la valeur de la plateforme de facturation d’abonnements ToroSachi et à vous intégrer de manière transparente avec vos outils existants.

Commencer avec les Outils

Prérequis

• Compte ToroSachi avec accès API
• Compréhension de base des concepts de facturation d’abonnements
• Environnement de développement configuré (pour les intégrations API)

Outils d’Intégration de Plateforme

Outils de Documentation API

Client API REST

Configurez votre client API REST pour des performances optimales :

# Définir l'URL de base
BASE_URL=https://api.torosachi.com/v1

# En-tête d'authentification
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json

GraphQL Playground

Accédez à notre point de terminaison GraphQL pour des requêtes avancées :

query GetAbonnements {
  subscriptions {
    id
    status
    customer {
      email
      name
    }
    plan {
      name
      price
    }
  }
}

Outils de Configuration Webhook

Test de Webhook

Utilisez ces outils pour tester les points de terminaison webhook :

1. ngrok - Pour le développement local
2. Webhook.site - Pour tester les charges utiles webhook
3. Postman - Pour les tests et la surveillance API

Gestionnaire Webhook Exemple

// Gestionnaire webhook Express.js
app.post('/webhooks/torosachi', (req, res) => {
  const event = req.body;

  switch(event.type) {
    case 'subscription.created':
      gererAbonnementCree(event.data);
      break;
    case 'payment.succeeded':
      gererPaiementReussi(event.data);
      break;
    default:
      console.log('Type d\'événement non géré:', event.type);
  }

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

Outils d’Analyse et de Reporting

Configuration du Tableau de Bord

Configuration des Métriques Personnalisées

Configurez des métriques personnalisées pour votre entreprise d’abonnements :

• Revenu Récurrent Mensuel (MRR)
• Revenu Récurrent Annuel (ARR)
• Valeur Vie Client (LTV)
• Taux de Désabonnement
• Revenu d’Expansion

Outils d’Export de Données

Exportez vos données d’abonnement en utilisant notre outil CLI :

# Installer ToroSachi CLI
npm install -g @torosachi/cli

# Exporter les données d'abonnement
torosachi export subscriptions --format csv --date-range last-30-days

# Exporter les données de revenus
torosachi export revenue --format json --include-forecasts

Outils de Portail Client

Outils de Personnalisation

Personnalisation CSS

Personnalisez l’apparence de votre portail client :

/* Personnalisation du thème du portail */
:root {
  --primary-color: #votre-couleur-marque;
  --secondary-color: #votre-couleur-secondaire;
  --font-family: 'Votre Police Marque', sans-serif;
}

.portal-header {
  background: var(--primary-color);
  color: white;
}

Extensions JavaScript

Ajoutez des fonctionnalités personnalisées à votre portail :

// Widget de portail personnalisé
ToroSachi.Portal.addWidget({
  id: 'metriques-utilisation',
  title: 'Métriques d\'Utilisation',
  component: ComposantMetriquesUtilisation,
  position: 'dashboard'
});

Outils d’Automatisation

Automatisation des Flux de Travail

Intégration Zapier

Connectez ToroSachi avec plus de 3 000 applications via Zapier :

1. Configurer le déclencheur ToroSachi (ex: “Nouvel Abonnement”)
2. Configurer l’action dans une autre application (ex: “Ajouter au CRM”)
3. Tester et activer votre Zap

Scripts d’Automatisation Personnalisés

Automatisez les tâches d’abonnement courantes :

# Script Python pour l'automatisation du cycle de vie des abonnements
import requests
from datetime import datetime, timedelta

def verifier_expiration_essai():
    essais = obtenir_abonnements_essai()
    for essai in essais:
        if essai['expires_at'] <= datetime.now() + timedelta(days=3):
            envoyer_rappel_essai(essai['customer_email'])

def envoyer_rappel_essai(email):
    # Envoyer un rappel d'essai personnalisé
    pass

Outils de Test

Test d’Abonnement

Configuration de l’Environnement de Test

Utilisez notre environnement sandbox pour les tests :

# Passer en mode sandbox
export TOROSACHI_ENV=sandbox
export TOROSACHI_API_KEY=sk_test_votre_cle_test

# Créer un abonnement de test
curl -X POST https://api-sandbox.torosachi.com/v1/subscriptions \
  -H "Authorization: Bearer $TOROSACHI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "test_client_123",
    "plan_id": "plan_basique_mensuel",
    "trial_days": 14
  }'

Outils de Dépannage

Mode Debug

Activez la journalisation de débogage pour des informations détaillées :

// Activer le mode debug
ToroSachi.config({
  debug: true,
  logLevel: 'verbose'
});

Outils de Vérification de Santé

Surveillez la santé de votre intégration :

# Vérifier le statut de l'API
curl https://status.torosachi.com/api

# Vérifier le point de terminaison webhook
curl -X POST https://votre-domaine.com/webhooks/torosachi \
  -H "Content-Type: application/json" \
  -d '{"test": true}'

Meilleures Pratiques

Directives de Sécurité

• Utilisez toujours HTTPS pour les communications API
• Effectuez une rotation régulière des clés API
• Validez les signatures webhook
• Implémentez une gestion d’erreur appropriée
• Utilisez des variables d’environnement pour les données sensibles

Optimisation des Performances

• Implémentez des stratégies de mise en cache appropriées
• Utilisez la pagination pour les grands ensembles de données
• Groupez les requêtes API lorsque possible
• Surveillez les limites de taux API
• Implémentez une logique de nouvelle tentative avec backoff exponentiel

Ressources de Support

Liens de Documentation

• Référence API
• Documentation Webhook
• Guide du Portail Client

Communauté

• Forum Développeurs
• Exemples GitHub
• Tag Stack Overflow: torosachi

Obtenir de l’Aide

• Email: developers@torosachi.com
• Chat: Disponible dans votre tableau de bord
• Documentation: docs.torosachi.com

---

Dernière mise à jour : Novembre 2024