Documentation Intégrations Tierces

1.1 Objectif du Document

Ce document décrit en détail l'ensemble des intégrations avec les services tiers utilisés par la plateforme REWAPP. Il fournit les spécifications techniques, configurations, exemples d'implémentation et codes d'erreur pour chaque service externe intégré.

1.2 Vue d'Ensemble des Intégrations

1.3 Prérequis Techniques

• Node.js 20 LTS
• NestJS 10.x
• TypeScript 5.x
• Accès Variables d'environnement CapRover
• Comptes développeur configurés sur chaque plateforme

2.1 Architecture et Fournisseurs

REWAPP utilise Firebase Cloud Messaging (FCM) comme service principal pour l'envoi des notifications push sur Android et iOS. FCM agit comme proxy vers APNs pour les appareils iOS.

Avantages de cette architecture

• API unifiée pour Android et iOS
• Gestion automatique des tokens
• Analytics intégrés
• Topics pour segmentation
• Notifications riches (images, actions)

2.2 Configuration Firebase Cloud Messaging

2.2.1 Création du Projet Firebase

1. 1

   Accès Console Firebase

   Accéder à la console Firebase (console.firebase.google.com)

2. 2

   Création du projet

   Créer un nouveau projet "REWAPP-Production"

3. 3

   Activation Cloud Messaging

   Activer Cloud Messaging dans les paramètres

4. 4

   Configuration

   Télécharger google-services.json (Android) et GoogleService-Info.plist (iOS)

2.2.2 Clés et Credentials

FCM_SERVER_KEY=<clé_serveur_firebase>
FCM_SENDER_ID=<sender_id>

2.3 Configuration Apple Push Notification Service

2.4 Types de Notifications REWAPP

2.4.1 Notifications Transactionnelles

2.4.2 Notifications Marketing

2.4.3 Notifications de Sécurité

2.5 Implémentation Backend

2.5.1 Structure du Payload FCM

{
  "to": "<device_token>",
  "notification": {
    "title": "Points crédités !",
    "body": "Vous avez reçu 45 points chez Boulangerie Martin",
    "sound": "default",
    "badge": 1,
    "click_action": "OPEN_ACTIVITY"
  },
  "data": {
    "type": "points_credited",
    "transaction_id": "txn_abc123",
    "points": "45",
    "partner_name": "Boulangerie Martin",
    "deep_link": "rewapp://transactions/txn_abc123"
  },
  "android": {
    "priority": "high",
    "notification": {
      "channel_id": "transactions"
    }
  },
  "apns": {
    "headers": {
      "apns-priority": "10"
    },
    "payload": {
      "aps": {
        "category": "TRANSACTION"
      }
    }
  }
}

2.5.2 Topics FCM Disponibles

• all_users — Tous les utilisateurs
• premium_users — Utilisateurs avec abonnement premium
• partner_<id> — Clients d'un partenaire spécifique
• city_<code> — Utilisateurs d'une ville

2.6 Gestion des Tokens

2.7 Personnalisation et Deep Linking

2.8 Codes d'Erreur FCM

3.1 Architecture et Fournisseurs

SendGrid est utilisé comme service principal pour sa fiabilité et son excellent taux de délivrabilité (>99%).

3.2 Configuration SendGrid

3.2.1 Configuration DNS Requise

3.2.2 Credentials

SENDGRID_API_KEY=SG.xxxxxxxxxxxxxxxxxxxxx
SENDGRID_FROM_EMAIL=noreply@rewapp.fr
SENDGRID_FROM_NAME=REWAPP

3.3 Templates d'Emails REWAPP

3.4 Variables Dynamiques

Variables Globales

3.5 Tracking et Analytics Email

3.6 Conformité et Bonnes Pratiques

RGPD

• Consentement explicite requis pour emails marketing
• Lien de désinscription obligatoire dans chaque email
• Possibilité de gérer les préférences email
• Suppression des données sur demande

Bonnes Pratiques

• Fréquence maximale : 1 email marketing/semaine
• Emails transactionnels sans limite (événements utilisateur)
• Subject lines clairs et non-trompeurs
• Version texte plain disponible
• Poids total < 102KB

3.7 Codes d'Erreur SendGrid

4.1 Architecture et Fournisseur

TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+33xxxxxxxxx
TWILIO_MESSAGING_SERVICE_SID=MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4.2 Cas d'Usage SMS REWAPP

Templates SMS

REWAPP - Votre code de vérification est : {{code}}. Valide 5 minutes. Ne le partagez jamais.

REWAPP - Nouvelle connexion détectée sur {{device}} à {{time}}. Si ce n'est pas vous, changez votre mot de passe immédiatement.

4.3 Codes d'Erreur Twilio

5.1 Architecture Analytics

REWAPP utilise une double approche analytics :

5.2 Configuration Google Analytics 4

GA4_MEASUREMENT_ID=G-XXXXXXXXXX
GA4_API_SECRET=xxxxxxxxxxxxxxxxxxx

Conversions GA4

5.3 Configuration Mixpanel

MIXPANEL_PROJECT_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MIXPANEL_API_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

5.4 Événements REWAPP

Événements Utilisateur

5.5 Propriétés Utilisateur

5.6 Conformité RGPD

Consentement

• Consentement explicite requis avant tout tracking
• Granularité : analytics_essential, analytics_marketing
• Stockage du consentement en base de données
• Révocation possible à tout moment

Anonymisation

• IP anonymisé dans GA4 (activé par défaut en EU)
• Email hashé (SHA256) avant envoi
• Pas de données personnelles dans les événements
• User ID interne (UUID) uniquement

Rétention des Données

6.1 Architecture Sentry

Sentry est utilisé pour capturer et analyser les erreurs sur toutes les plateformes REWAPP.

6.2 Configuration

SENTRY_DSN=https://xxxxxxxxx@sentry.io/xxxxxxx
SENTRY_ORG=rewapp
SENTRY_PROJECT=rewapp-api
SENTRY_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

6.3 Alertes et Notifications

Canaux de Notification

• Slack #rewapp-errors — Toutes les erreurs
• Slack #rewapp-critical — Erreurs critiques uniquement
• PagerDuty — Erreurs critiques en production (24/7)
• Email — Récapitulatif hebdomadaire

7.1 Variables d'environnement CapRover

Tous les credentials des services tiers sont stockés dans les variables d'environnement CapRover.

7.2 Rotation des Clés

8.1 Configuration par Environnement

8.2 Tests et Validation

Tests Unitaires

• Mock des clients HTTP pour chaque service
• Validation des payloads avant envoi
• Tests des handlers d'erreur

Tests d'Intégration

• Environnement Staging avec données de test
• Numéros de téléphone de test Twilio
• Emails de test SendGrid (sandbox)
• Tokens FCM de test

Monitoring en Production

• Dashboard Grafana pour métriques d'envoi
• Alertes sur taux d'échec > 1%
• Logs centralisés dans ELK Stack

9.1 Récapitulatif des Intégrations

9.2 Documents Complémentaires

• 4.5 Stack Technique Détaillé — Technologies et justifications
• 6.1 Document de Sécurité — Politiques de sécurité globales
• 7.1 Documentation API Backend — Endpoints et webhooks
• 7.2 Spécifications Webhooks — Détail des webhooks entrants
• 7.3 Documentation Intégration Solution Bancaire — Card linking et virements
• 13.3 Plan de Tracking Analytics — Événements détaillés

9.3 Contacts et Support