Guide des intégrations et webhooks

Connectez ReturnEase à vos outils existants pour un workflow automatisé et transparent

Guides d'intégration détaillés

Choisissez une intégration pour voir le guide complet de configuration et les meilleures pratiques

Qu'est-ce qu'un webhook ?

Les webhooks vous permettent de recevoir automatiquement des données de retour dans vos systèmes existants en temps réel.

Définition

Un webhook est une notification automatique envoyée de ReturnEase vers votre système lorsqu'un événement se produit (comme un nouveau retour). C'est comme une notification push pour votre logiciel.

Comment ça fonctionne :

  1. Un client soumet une demande de retour via votre formulaire
  2. ReturnEase traite instantanément la demande
  3. Nous envoyons une requête POST HTTP à votre URL de webhook avec toutes les données de retour
  4. Votre système reçoit et traite automatiquement les données

Cas d'usage populaires

Voici comment les commerçants utilisent les webhooks ReturnEase :

💬 Systèmes de support client

Créez automatiquement des tickets de support pour chaque retour.

Exemples : Zendesk, Freshdesk, Help Scout, Intercom

📊 Intégrations CRM

Suivez les retours clients dans votre CRM pour une vue client complète.

Exemples : Salesforce, HubSpot, Pipedrive, Monday.com

📦 Gestion des stocks

Mettez automatiquement à jour les niveaux de stock lorsqu'un retour est traité.

Exemples : Systèmes d'inventaire personnalisés, ERP, WMS

🔔 Systèmes de notification

Envoyez des notifications de retour à Slack, Teams ou d'autres outils de communication.

Exemples : Slack, Microsoft Teams, Discord, Telegram

Configuration de votre webhook

Configurez un webhook en quelques minutes :

1. Créez un point d'accès

Configurez une URL sur votre serveur qui peut recevoir des requêtes POST. Votre point d'accès doit accepter JSON et répondre avec un code de statut 200 OK.

https://votresite.com/api/webhooks/returnease

2. Ajoutez l'URL du webhook

Allez dans votre tableau de bord ReturnEase et ajoutez votre URL de webhook dans les paramètres d'intégration.

Ouvrir les intégrations

3. Testez votre intégration

Soumettez un retour de test et vérifiez que votre point d'accès reçoit les données correctement.

4. Passez en production

Une fois testé, votre webhook est opérationnel ! Vous recevrez maintenant automatiquement des notifications pour tous les nouveaux retours.

Format de la charge utile du webhook

Voici un exemple de données JSON que ReturnEase enverra à votre webhook :

Exemple de charge utile :

{
  "event": "return.created",
  "return_id": "ret_abc123",
  "return_number": "RET-2025-0001",
  "type": "return",
  "customer": {
    "name": "Jean Dupont",
    "email": "jean@example.com",
    "phone": "+33612345678",
    "address": "123 Rue de Paris, 75001 Paris"
  },
  "order": {
    "order_number": "ORD-12345",
    "order_date": "2025-01-15"
  },
  "reason": "Produit ne correspond pas à la description",
  "description": "La couleur ne correspond pas...",
  "photos": [
    "https://cdn.returnease.eu/photos/abc123.jpg"
  ],
  "created_at": "2025-10-16T14:30:00Z",
  "merchant_id": "mer_xyz789"
}

Note : Tous les horodatages sont au format UTC ISO 8601. Les photos sont des URL pré-signées valides pendant 24 heures.

Dépannage

Erreur 404 : Non trouvé

Votre URL de webhook n'existe pas ou n'est pas accessible.

Solution : Vérifiez que votre URL de webhook est correcte et que votre serveur est en ligne. Testez l'URL dans votre navigateur.

⚠️ Erreur 500 : Erreur de serveur

Votre serveur rencontre une erreur lors du traitement du webhook.

Solution : Vérifiez les logs de votre serveur pour les erreurs. Assurez-vous que votre point d'accès peut traiter le format JSON que nous envoyons.

⏱️ Erreur de timeout

Votre serveur ne répond pas assez rapidement (timeout après 5 secondes).

Solution : Optimisez votre point d'accès pour qu'il réponde rapidement. Traitez les données de manière asynchrone si nécessaire.

🔒 Erreur SSL/TLS

Votre certificat SSL n'est pas valide ou a expiré.

Solution : Assurez-vous que votre URL de webhook utilise HTTPS avec un certificat SSL valide de Let's Encrypt ou d'une autre autorité de confiance.

Voir les logs de livraison

Vous pouvez voir tous les tentatives de livraison de webhooks, codes de réponse et erreurs dans votre tableau de bord.

Voir les logs de webhook

Bonnes pratiques

Répondez rapidement avec 200 OK - traitez les données de manière asynchrone si nécessaire

Implémentez la gestion des tentatives - ReturnEase réessaiera jusqu'à 3 fois en cas d'échec

Enregistrez les charges utiles des webhooks pour le débogage et l'audit

Utilisez HTTPS avec un certificat SSL valide pour la sécurité

Surveillez les logs de vos webhooks pour détecter les problèmes rapidement

Prêt à configurer votre intégration ?

Connectez ReturnEase à vos outils existants en quelques minutes

Configurer les webhooks
ReturnEase - Gestion des retours pour les boutiques en ligne